post https://your-callback-url.com/sms_callback_endpoint
This is a web service created by you, to receive notifications from Telesign. The details described here are for notifications from Telesign Engage for SMS requests (excluding bulk requests). You can receive notifications from multiple Telesign services at the same endpoint.
Status codes
Status code | Associated text string | Description |
---|---|---|
200 | Delivered to handset | The SMS was delivered to the end user's phone. (Final) |
203 | Delivered to gateway | The SMS was delivered to the gateway. If the gateway responds with further information (including successful delivery to handset or delivery failure), the status is updated. (Intermediate) |
207 | Error delivering SMS to handset (reason unknown) | The SMS could not be delivered to the end user's handset for an unknown reason. (Final) |
210 | Temporary phone error | The SMS could not be delivered to the handset due to a temporary error with the phone. Examples - phone is turned off, not enough memory to store the message. (Final) |
211 | Permanent phone error | The SMS could not be delivered to the handset due to a permanent error with the phone. For example, the phone is incompatible with SMS, or illegally registered on the network. This can happen when a phone number is blacklisted, or is incorrectly provisioned. (Final) |
220 | Gateway/network cannot route message | The network cannot route the message to the handset. (Final) |
221 | Message expired before delivery | The message was queued by the mobile provider and timed out before it could be delivered tothe handset. (Final) |
222 | SMS not supported | SMS is not supported by this phone, carrier, plan, or user. |
229 | Message blocked by your request | This code can happen because you requested a block or because Telesign blocked on your behalf. The block is custom, meaning it applies to you and not others. |
230 | Message blocked by TeleSign | Telesign blocks a message if it is being sent to a phone number that is on a global blocklist. |
231 | Invalid/unsupported | The content of the message is not supported. |
233 | Message blocked due to high risk score. | It was determined that the risk score for the destination number is higher than configured maximum risk score. For that reason Telesign did not send the SMS. |
237 | Message blocked in requested country | You requested that messages in a specific country be blocked, and the message was being sent to this country. |
238 | Destination blocked by prefix | You requested that phone numbers with a particular prefix be blocked. |
250 | Final status unknown | The final status of the SMS cannot be determined. |
251 | Message successfully sent out for delivery, however final confirmation of delivery to handset was not received. | Message successfully sent out for delivery, however final confirmation of delivery to handset was not received. |
286 | Transaction not attempted | The SMS is blocked from being sent due to the phone type not being one of the following - mobile, prepaid, personal, or pager. |
292 | Queued by gateway | The SMS gateway has queued the message. |
295 | Status delayed | The status of the SMS is temporarily unavailable. |
521 | Requested Sender ID is not allowed for destination | The Sender ID included in this request cannot be used to send messages to this destination phone number. The Sender ID may either be blocklisted for this country or needs to be added to a whitelist for this country. |