Sinch SMS

Sinch SMS is integration for sending SMS messages to your customers. You can find it in Integrations > + Add new integration.

26862686

Watch this short introductory video about this feature:

📘

Sinch SMS integration will be set up by our SMS specialist. To integrate, contact your CSM or your technical consultant.

Integration

During the integration, you will need to fill out three things:

  • Service Plan ID
  • API token
  • Endpoint region

Service Plan ID will be provided by Sinch. Each service plan comes with 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 is your authentication token, which is provided for each service plan. You can find it in the Sinch Console.

Endpoint region is chosen based on your region and on the data protection requirements of your country. Other regions may be available on request. Options are:

28802880

Project default SMS integration

Go to Project settings > Channels > SMS > Default SMS Provider

Admin can select which SMS integration is used by SMS actions in Scenarios on the project level.

28462846

The default SMS provider is CM Telecom, or you can select other SMS integration from the dropdown. You can select Sinch SMS integration that was created from the step above by its name. Multiple SMS integrations can be created, but only one can be selected. All SMS campaigns will be using this one selected integration.

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

e.g. 400

HTTP code failed requests. See Sinch's HTTP status codes

error

e.g. "syntax_invalid_parameter_format"

Error code - failed requests. See Sinch's Error codes

comment

e.g. "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 provide clarity about how many messages and when they have been delivered to recipients' handsets. Sinch SMS integration tracks delivery report events, which can be used in campaign evaluation. In particular, 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 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

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 four days after dispatching because delivery reports are tracked in the first four days after dispatching the message.

❗️

Some countries shall not provide delivery reports, including these: 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 & Futuna Islands (Last update 2020-06-04).


Did this page help you?