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 - 


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 - 

  1. Login to https://web.postman.co and create an API request 

  2. Select method as POST

  3. Enter below HTTP API endpoint - https://<subdomain>/v1/Accounts/<your_sid>/Sms/send 

    1. 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.

    2. Replace <your_sid> with your Account's SID (Refer to step 2 for this)

  4. Under the Authorization tab, click on Basic Auth

    1. Enter API key in Username 

    2. Enter API Token in Password 

  1. Click on Send 

  2. Click on the </> icon which is near Send button

  3. 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.