Implementing SMS fallback in Push Notification

Fallback of failed messages to SMS

If a PUSH message to a contact fails permanently, Push notification messages can be configured to fallback to SMS. This functionality requires that you have a Channel ID (see information on creating a channel) . The fallback to SMS works when a Channel is created that includes a Sender ID for PUSH as well as a SMS-capable Sender ID. An important factor in the use of the fallback to SMS requires that you have the following:

  1. The mobile number of the recipient that you wish the message to fallback to
  2. A SMS sender ID that is provisioned to work in the specific country that the mobile number is registered.

If a PUSH message is sent to more than one device e.g. a Phone, tablet, etc the SMS fallback will not be attempted.

Fallback messages have the same body as the failed message, after macro expansion and translations. (Instead of using the body in the message-request as the source, the body from the failed message is used unmodified in the new message). As a result, it is very important that you take into consideration the format, size and type of message that can be triggered to fallback to SMS.

PUSH MessageRequest with fallback to SMS

To trigger the fallback to SMS in the message request, make sure you are sending the request using a Channel ID and set the optional fields related to this as:

  • sender_id_sort_criteria : Set the value to "DELIVERY_ADDRESS"
  • failover (Enum) - one of: “NONE” or “SMS”. If the value is “SMS”, fallback will be initiated to a SMS message if the PUSH message fails to be delivered. If not specified, fallback is disabled.
  • contact_delivery_priority : Set the value to "PUSH","MDN"

For example:

curl -X POST -H "Authorization: Bearer d18f79e76f30d7a0f05e6444b0bbc78a"
-H "Content-Type: application/json" -d
'{"from":"channel:a2Nmlpjf8Mr8kvbiR7BHJ1","to":["contact:cVonTugi8dibGXnIPGdo54"],"sender_id_sort_criteria":["DELIVERY_ADDRESS"],"contact_delivery_address_priority":["PUSH","MDN"],"body":"Hello Push World!", "failover":"SMS"}'
Was this article helpful?
0 out of 0 found this helpful


Please sign in to leave a comment.