Message your customers by sending a single SMS or starting an SMS broadcast using Exotel's generic plugin on MoEngage. To complete the integration and enjoy seamless communication, follow the steps below.
Step 1 - Login to your Exotel account and upload details to be DLT compliant
To send an SMS, the DLT mandate requires the following information. Please configure these in the Settings section of your Exotel Dashboard.
Entity ID - Entity ID is the unique ID provided to your business.
Sender ID - The Sender ID which will be used to send the SMSes.
Template ID - Template ID is the unique ID for each transactional or promotional SMS that you wish to use.
Template Details - Upload the DLT-approved templates for the messages you would like to send to your customers.
SMS Type - SMS Types are used to classify different types of messages as per the purpose, e.g. transactional, service explicit, service implicit, and promotional.
Step 2 - Keep the information from Exotel Dashboard handy -
Find your Account sid, API KEY and API TOKEN on Dashboard > SETTINGS: API
Find your Sender ID on Dashboard > SETTINGS: API > Sender ID
Find your Entity ID on Dashboard > SETTINGS: API > SMS DLT Settings
Find your DLT Template ID on https://my.exotel.com/Exotel/settings/site#sms-settings
Step 3 - Login to your MoEngage account and enter configuration details
On the MoEngage Dashboard, go to settings > Channel > SMS and Connector.
Click on SMS Connector Config under SMS and Connector Settings. Under Custom connectors, click on create.
Fill in the requested details
General Details -
Connector Name - Exotel will be selected here by default.
Sender Name - Select a nickname for the configuration to uniquely identify it.
API URL - Enter below HTTP API endpoint - https://<subdomain>/v1/Accounts/<your_sid>/Sms/send
Replace <subdomain> with api.exotel.com If you access Exotel via my.exotel.com, enter api.in.exotel.com If you access Exotel via my.mum1.exotel.com.
Replace <your_sid> with your Account's SID (Refer to step 2 for this)
Select the API type as POST from the dropdown.
URL Parameters -
Keep URL parameters empty for this configuration
Headers -
Key - Authorization
Value - Add the 64-bit encoded token here. You can follow the below methods to access the 64-bit token -
OPTION 1 -
Login to https://web.postman.co and create an API request
Select method as POST
Enter below HTTP API endpoint - https://<subdomain>/v1/Accounts/<your_sid>/Sms/send
Replace <subdomain> with api.exotel.com If you access Exotel via my.exotel.com, enter api.in.exotel.com If you access Exotel via my.mum1.exotel.com.
Replace <your_sid> with your Account's SID (Refer to step 2 for this)
Under the Authorization tab, click on Basic Auth
Enter API key in Username
Enter API Token in Password
Click on Send
Click on the </> icon which is near Send button
You will see a cURL request with the basic Authorization token. Take the value of the token to use in the MoEngage configuration.
OPTION 2 -
Drop an email to hello@exotel.com to get your basic authorization token.
Body Type -
Select "Form" as the body type
From - Select the Sender ID to send the SMS from (Refer to step 2 for this)
To - Customer's number who will be receiving the SMS. Enter “Moesms_destination” as the value for this field to set up the configuration
Body - Body of the SMS which will be sent to the customer. Enter “Moesms_message” as the value for this field to set up the configuration
Key - Keep this field empty for this configuration
Step 4 - Send a Test SMS
To ensure that the integration is working as expected, you can send a test SMS by clicking on Send SMS to Test. In the dialogue box presented, enter these details, then hit Send Test.
Country Code and Mobile number to which you would like to send the message
Message: Enter a sample message which you would like to test. Eg -This is a test message powered by Exotel. Report abuse to +918088919888 -Exotel
Step 5 - Start using the plugin!
Now that your SMS plugin is ready, you can use it to send SMS to customers.
Create a campaign by referring to Create SMS Campaign – User Guide and choose the Configuration created in step 3 as the provider.
You can also refer to Configure SMS Custom Connector – User Guide for more details on configuring the SMS connector.
Please connect with the MoEngage team to set up throttling (eg - 100 RPM) for the SMS connector to make sure the campaign runs successfully. Refer to Push Throttling – User Guide for more details.
If you have any questions or clarifications, please feel free to get in touch with hello@exotel.com.