What is Vivial Connect?¶
Vivial Connect is an application programming interface (API) that enables text messaging capabilities for client applications. Using Vivial Connect, you can:
- Provision phone numbers to use for sending and receiving text messages
- Send and receive text messages with your application using calls to the Vivial Connect API
- Attach media files to messages
- Set up callbacks to your application that report the status and other metadata about text messages you send and receive
- Enable call-forwarding on the numbers you’ve provisioned
What are some common uses for Vivial Connect?¶
You can use Vivial Connect with any client application that requires text messaging capabilities. Some common uses include:
- Providing enhanced customer support
- Sending “blast” text messages as part of a marketing campaign
- Supporting multifactor authentication (MFA) for your client applications
What is our Free Trial?¶
Our three-month free trial includes one phone number and $2.00 in account balance. You may upgrade your trial account to a subscription or on-demand plan at any time. The unspent portion of your free trial account balance will be credited toward the cost of the upgrade and you will keep your phone number.
If the trial expires without being upgraded your number will be released, and any remaining account balance removed. At this point you may still upgrade your account, but you will not receive a credit for the unspent portion of your free trial, and the number you acquired on registration may no longer be available.
Does Vivial Connect have a Referral Program?¶
Yes. Interested parties should contact firstname.lastname@example.org for details and easy signup!
How do I specify phone numbers to use for sending and receiving text messages?¶
The API lets you choose numbers from a list of available, local numbers in the US and Canada. To query this list and find a number that meets your needs, tailor your search to target specific criteria, including:
- area code
- zip code
- 2-digit state / province code (e.g. CA, NY, QC)
- city, state
When you’re ready to purchase a number, you can specify an exact phone number, or you can let the API choose a random number for you within a specific area code.
For more information, see Managing Phone Numbers.
Can I send internationally?¶
We offer international support for outbound SMS. To see if your country is supported, please contact sales.
Can I add a preferred Sender ID?¶
Sender ID is enabled for all accounts with international SMS capabilities. Users can specify their preferred sender ID using the from_number parameter in send messages requests to our API.
Keep in mind, sender IDs will be handled differently by various international carriers. In some locations, IDs will be respected, others may ignore them and simply use a random local number. In some cases a country may have a default sender ID that applies to all traffic.
Can I send emojis?¶
Yes. Vivial Connect supports GSM-7 encoding for basic English text characters and UCS-2 encoding for emoji and unicode messaging.
What is encoding?¶
Encoding is the process of converting data from one form to another for processing, transmission and translating messages uniformly. Providing the correct encoding is essential for transferring and rendering messages as intended. Depending on message content (plain text, emojis, special characters, etc), Vivial Connect will automatically use either GSM-7 or UCS-2 encoding. The encoding may impact the cost of messaging.
What are segmentation and concatenation?¶
Carriers enforce limits on how long messages can be. To send a longer message, it must first be broken up (segmented), and then stitched back together when it reaches it destination (concatenated). Segment length varies depending on message encoding and the total number of segments.
|Message Encoding||Max Characters Per Segment|
|Messages with one segment|
|Messages with multiple segments|
Note: segmentation only applies to outbound messaging; inbound messages are not segmented.
How are long messages billed?¶
Outbound messages can contain up to 2048 characters, but Vivial Connect charges by message segment meaning longer messages will cost more to send. Messages consisting of more than one segment will be charged as multiple messages. For example:
|Total Characters||Encoding||Total Segments|
|200||GSM-7||2 (153 + 47)|
|160||UCS-2||3 (67 + 67 + 24)|
What’s Your Data Retention Policy?¶
Message contents and metadata are stored for the lifetime of your account and can be accessed via the /api/v1.0/messages.json API endpoint. Message log data, accessed via the /api/v1.0/logs.json API endpoint, may be deleted any time after 30 days. Internal system logs, which may occasionally contain phone numbers or other user data, are retained for no more than 30 days. These policies are subject to change.