How to monitor the status of your SMS?
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
Ex: curl "https://asd23df:[email protected]/v1/Accounts/Exotel/SMS/Messages/4dd44cc0f7010ee43ca256126f3efc88"
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
SMS STATS: The SMS Stats dashboard gives you a high-level overview of your SMS stats.
The dashboard is accessible as SMS Stats (Beta) under the SMS section of your Exotel portal.