Sinch SMS/MMS
Sinch SMS is the integration for sending SMS messages to your customers.
Watch this short introductory video about this feature.
Sinch SMS integration is set up by our SMS specialist. To integrate, contact your CSM or your technical consultant.
Add Sinch integration
Your user role must have admin rights to set a default SMS provider integration.
- Go to Integrations > + Add new integration.
- Search for the Sinch SMS integration.
- Add the Sinch SMS integration.
Integration data
During the integration, fill out:
- Service Plan ID: Sinch provides the ID. Each service plan has a rate limit (based on your Bloomreach Engagement contract) and gets its own message queue. Messages are placed in a Sinch queue and sent based on the rate limit.
- API token: This is your authentication token. It's provided for each service plan and can be found in the Sinch Console.
- Endpoint region: The endpoint region is chosen based on your area and your country's data protection requirements. Other regions may be available on request. Options are:
- EU (
https://eu.sms.api.sinch.com
) - US (
https://us.sms.api.sinch.com
)
- EU (
Project default SMS integration
Admin can select which SMS integration is used by SMS actions in Scenarios on the project level.
- Go to Project settings > Channels > SMS > Default SMS Provider.
- Select the Sinch SMS integration.
While you can create multiple SMS integrations, you can only select one. All SMS campaigns will use the integration you selected.
Event tracking
When Bloomreach Engagement sends a message to Sinch, it tracks the response. The SMS provider 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 Sinch's Delivery report error codes and SMPP error codes. |
status_code | for example: 400 | HTTP code failed requests. See Sinch's HTTP status codes. |
error | for example: syntax_invalid_parameter_format | Error code - failed requests. See Sinch's Error codes. |
comment | for example: "The format of a field value is invalid. For example if a MSISDN is not correctly formatted." | Error message - failed requests. See Sinch's Error codes. |
Sinch delivery reports
Delivery reports clarify how many messages have been delivered to recipients' handsets and when. Sinch SMS integration tracks delivery report events, which can be used in campaign evaluation. Sinch calls Bloomreach Engagement callback with delivery reports either immediately, as status rejected, or later as statuses delivered and failed, when the recipient's operator responds about the delivery.
SMS campaign events are:
- delivered - a successful delivery to the recipient's handset
- rejected - a rejection by Sinch (find more details in the error code)
- failed - an unsuccessful delivery (find more details in the error code)
Waiting period
Depending on the operator, some delivery reports may take up to 4 days to receive. 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 don't 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.
Terms and conditions
If Bloomreach provides Sinch services to you, you agree to accept and comply with the following terms and conditions relating to the use of services:
Updated 18 days ago