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. 


kindly reach us at +918088919888 or write to us at hello@exotel.in. for any concerns.