Step 1. Account Setup

If you do not have an account with Exotel yet, follow the steps here. Once you have registered yourself on DLT and created an Exotel account, you can then add Exotel Integration in Raven.

If you are sending SMSs in India, TRAI has mandated to register their business, headers (sender IDs), and templates on any of the DLT platforms.

Step 2. Exotel Integration in Raven

KeysDetails
API KeyAPI Key (username). Find your API credentials here.
API TokenAPI Token (password). Find your API credentials here.
SenderOnce approved on the DLT platform, you can edit an existing SENDER ID or assign it while adding a new ExoPhone, on the Exotel dashboard. navigate to Account > Settings > SMS Sender IDs. Specify one of your ExoPhone or Sender ID (header) linked to it.
For more details see here  SMS Configuration Setting
Use 6 Digit numeric sender for Promotional SMS or 6 alpha Characters for Transactional SMS.
ExoPhone: From = ‘080XXXXXX’
Transactional Sender ID: From = ‘EXOTEL’ (If linked to your ExoPhone)
Promotional Numeric Sender ID: From = ‘600XXX’ (If linked to your ExoPhone)
Account SIDAccount SID. Find your API credentials here.
RegionDefault is Singapore. If the Exotel Account URL is my.in.exotel.com then select India. More details here.
RouteApplicable only for SMSes sent by Indian businesses to Indian destination numbers. Use the route type specified when registering your templates. Possible values: Transactional, OTP, Promotional.
DLT Entity IDApplicable only for SMS sent by Indian businesses to Indian destination numbers. Your Entity Id as registered on DLT (Distributed Ledger Technology) portal of operators in India. This is mandatory to be passed in API or configured on Dashboard for SMSes towards Indian destination (Learn more about DLT).

Step 3. Delivery Reports

There is no additional configuration required to setup delivery reports. Raven manages the delivery callback internally for Exotel.

💫 Advanced

Send additional parameters to Exotel

Raven sends the fields present in the SMS template to Exotel by default. To send additional fields, please check our Override doc.

IP Whitelisting

You can control access by specifying Raven’s IP address, or make sure Raven’s IP addresses are whitelisted and not blocked. Please follow the guide here.

IPs: 65.2.109.100, 65.2.58.233

If you are facing issues with this integration or find something missing, please write to us at support@ravenapp.dev