v3.2
v3.2 includes all features of v3.1, with the addition of:
Long Message Element
The longMessageInfo
element is now available for incoming HTTP messages. If a message sent to your endpoint is longer than a standard text message, it may be split into multiple parts. In this case, the request from Vibes will include the longMessageInfo
element.
Learn more on our Receive Messages page.
V3.1
Message Splitting & Multi-Part Messages
Vibes' Connect platform now allows API callers to submit SMS messages up to 900 characters in length. These messages will automatically split into multiple SMS messages and, for carriers that support it, Message Concatenation will be utilized so the message will appear as one large message on the device.
Implementation
This feature will be available for all API users and is enabled by setting a flag when a message is submitted. If that flag is set on a message and the message text exceeds the carrier length of a single SMS, it will be automatically split into multiple SMS messages.
Once the original message is split, each SMS message segment will be individually recorded, tracked, and billed as separate message. In addition, each of the SMS messages will be associated back to the original large message for reference.
The actual splitting logic varies based on each carrier's support for concatenated messaging, their specific implementation of concatenated messaging, and payload. Here are the specifics:
- For carriers that support concatenated messaging, the original message will be split into specific SMS messages at the maximum concatenated SMS length for the carrier. This can be less than the maximum length of an SMS message, based on the carrier's rules and implementation on concatenated messages.
- For carriers that do not support concatenated messaging, the message will be split by Vibes. The system will break messages on a word boundary when possible. However, if splitting a message on a word boundary would cause an extra message to be generated, then it will be split at the maximum character length to avoid the extra message.
Extra charges may applyIf your large SMS message is split into multiple messages for delivery, you will be billed for additional messages. If you would not like to incur extra charges, we recommend setting
splitLongMessage
tofalse
.
v3.0
In Version 3.0, we’ve made several changes to the MessageAPI, primarily to support International Messaging. As part of the changes necessary for international numbers, additional requested items/features that require new XML attributes have also been added to provide more robust Application Program Interfaces (APIs).
International Support Changes
- International format: All MDNs are now required to be in the International E.164 format, which is a +, followed by the country code, followed by the dial-able number. For example, +18475551212, where 1 is the code for North America. This includes parameters in the XML body, as well as cases when the URL contains an MDN.
- Ten-character restriction removed: MDNs are no longer restricted or enforced to be 10 characters. MDNs can be up to 15 digits in length plus the '+' sign. Future validation checks may be put in place to ensure the correct number of digits for certain countries, but those would not change the API specifications.
Carrier in Message Responses
Carrier is now included in outgoing message responses. This is especially useful in cases when the carrier was not specified and was looked up by the API. This applies to the submitMtMessage
response.