For an SMS sent via Exotel SMS API, you can find out the delivery status of the SMS via two means:
A. PULL: You can pull the status by querying Exotel for the specific SMS that you sent.
For this you need to make a GET request to SMS API
https://<your_api_key>:<your_api_token>@<subdomain>/v1/Accounts/<ExotelSid>/SMS/Messages/<SmsSid>
- Replace
<your_api_key>and<your_api_token>with the API key and token created by you. This can be found here: https://my.exotel.com/apisettings/site#api-credentials - Replace
<your_sid>with your “Account sid” - Replace
<subdomain>with the region of your account- <subdomain> of Singapore cluster is api.exotel.com
- <subdomain> of Mumbai cluster is api.in.exotel.com
B. PUSH: You can have Exotel push the SMS status to you after the SMS reaches any terminal state (ie, "sent", "failed" or "failed-dnd").
For this, you need to pass an additional parameter "StatusCallback" along with your other parameters (like 'From', 'To' and 'Body').
=> This parameter should be a URL that is hosted by you. Ex: http://example.com/
=> Exotel will make a POST request to the above URL with the following parameters:
- SmsSid - The Sid (unique id) of the SMS that you got in response to your request
- To - Mobile number to which SMS was sent
- Status - one of queued, sending, submitted, sent, failed-dnd, failed
- SmsUnits - The number of SMS units being sent
- DetailedStatus - Human readable word that explains what happened to the message
- DetailedStatusCode - Exotel’s Detailed Status code corresponding to the DetailedStatus
- DateSent - The date on which the message was sent
- CustomField - The custom field that was set in the POST request. (Will be returned only if it was set)
DASHBOARD: You can also monitor the status of your SMS from the Outbox section of the dashboard.
Also, refer to How to check SMS status from the dashboard
The dashboard is accessible as SMS Stats (Beta) under the SMS section of your Exotel portal.
kindly reach us at +918088919888 or write to us at hello@exotel.in. for any concerns.