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:abcdefgh@api.exotel.com/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. 


If you have any questions or concerns, please connect with us using the chat widget on your Exotel Dashboard or Whatsapp us on 08088919888