Twilio SMS/MMS
Twilio Messaging SMS and MMS integration allows you to send and receive SMS and MMS messages through Twilio's scalable messaging service using Bloomreach Engagement's standard SMS messaging functionality. You can find it in Integrations > + Add new integration.
With the Twilio Super Network providing connections to 4,800+ carrier partners, you can send messages and build customer relationships globally.
Initial setup
Twilio Messaging (SMS and MMS) integration has to be initially set up by our SMS specialist. Contact your CSM or CS team to integrate and being using Twilio SMS and MMS.
Prerequisites
Before proceeding with this integration, you must have your Twilio account set up. If you don't have a Twilio account yet, contact your CSM to help get yours created. You will also need the following credentials from your Twilio account:
Account SID– Your unique 34-character Twilio Account SID (begins with “AC”) acts as a username to identify your Twilio Account. You can find the token in the Twilio Console.Auth token– Your authentication token. You get it for each service plan. You can find the token in the Twilio Console.API Key SID– Your API Key SID to authenticate access to your Twilio account. Ensure your API Key's permissions are granted the necessary access levels.API Key Secret– Your API Key Secret to authenticate access to your Twilio account.
Integration setup
Follow these steps to set up your Twilio Messaging SMS/MMS provider integration:
- Open your Bloomreach Engagement project.
- Go to
Data & Assets>Integrations>+ Add new integration. - Search for "Twilio Messaging" and click
+ Add integration. - On the next screen, populate the fields shown with your Twilio account credentials mentioned above. This will connect your Twilio account with your project.
- Click the
Save integrationbutton to complete your registration. - You can start using Twilio Messaging SMS/MMS integration and configure any project level settings.
(Optional) Set default SMS provider
If your project has multiple SMS provider integrations configured, you can have the option to set a default provider. Once set, all SMS campaigns will be using this one selected integration.
If you would like to set your default SMS provider, go to Project settings > Channels > SMS/MMS and select your integration of choice from the SMS provider integration drop-down field. Your user role must have admin rights to do so.
Event tracking
By default, event tracking for the Twilio Messaging SMS/MMS integration are mapped to the campaign event with action_type=sms. Alternatively, event tracking can be mapped to a different event if desired by configuring this within Project settings > Campaigns > Mapping > Campaign events.
When Bloomreach Engagement sends a SMS message with Twilio, it tracks the response. Twilio Messaging either accepts the message for delivery or rejects it. Look for error explanations in case of rejected messages.
Bloomreach Engagement tracks campaign event (or mapped event) with these properties:
| event property | value | description |
|---|---|---|
| status | "enqueued" "enqueue_failed" | The message was (enqueued) or was not (enqueue_failed) successfully forwarded to the SMS provider for delivery. |
| status | "delivered" | The message was successfully delivered from the SMS provider to the recipient's handset. |
| status | "rejected" "failed" | The message was rejected by the SMS provider or delivery to the recipient's handset failed. |
| number_of_message_parts | Number | Count of message parts |
| status_code | numerical code | See Twilio's Error and Warning Dictionary. |
| error | e.g. "syntax_invalid_parameter_format" | Error code - failed requests. Error and Warning Dictionary . |
| comment | e.g. "The format of a field value is invalid. For example if a MSISDN is not correctly formatted." | Error message - failed requests. Error and Warning Dictionary . |
Twilio delivery reports
Twilio Messaging communicates with Bloomreach Engagement to notify us about SMS message delivery event status changes. In particular, Twilio calls Bloomreach Engagement's callback with delivery reports in real-time when the end recipient's operator responds about the delivery.
Delivery events provide clarity about how many messages and when they have been delivered to recipients' handsets. Delivery events can also be used in campaign evaluation.
Engagement has the following SMS message status values listed below:
| value | description |
|---|---|
| enqueued | Enqueued the SMS message to the service provider |
| enqueue_failed | Could not enqueue the SMS message |
| delivered | SMS message was successfully delivered from the service provider to the end customer’s handset |
| sent | SMS message was submitted to the network for delivery |
| failed | SMS message not delivered, typically due to a failure or temporary problem. |
| rejected | SMS message was rejected for delivery by the service provider |
| incoming_message | Inbound SMS message or reply from a campaign recipient (upon activating Two-way Messaging) |
| clicked | Customer clicked on a link inside the SMS (using the Campaign Link Shortener). |
For more information on error explanations in case of rejected or failed messages, see the Twilio Error and Warning Dictionary.
Waiting period
Some delivery reports may take up to 4 days to receive, depending on the operator. However, users shall not expect delivery reports to be delivered after 4 days after dispatching because delivery reports are tracked in the first 4 days after dispatching the message.
Countries without delivery reports
Some countries do not provide delivery reports for SMS messages. These countries include: Bangladesh, Benin, Brazil, Burundi, Cambodia, Germany, Guadeloupe, Guam, Hong Kong, Indonesia, Kuwait, Malaysia, Marshall Islands, Mauritania, Mexico, Nauru, Northern Mariana Islands, Pakistan, Panama, Papua New Guinea, Peru, Samoa, Solomon Islands, South Sudan, Sri Lanka, Sudan, Tajikistan, Timor-Leste, Tonga, Tuvalu, Uzbekistan, Venezuela, Vietnam, Wallis and Futuna Islands.
Predefined sender
For details on how to set a predefined or default sender, read Predefined senders and (Optional) Default predefined sender.
Updated 1 day ago