8x8 CPaaS (Communications Platform as a Service) offers a robust suite of APIs and tools for integrating voice, video, chat, WhatsApp (among other messaging apps channels) and SMS capabilities into your applications.

Configure 8x8 as a Custom SMS Connector (Service Provider)

This article helps you configure 8x8 as a Custom SMS Connector (Service Provider) on the MoEngage dashboard.

Configure 8x8 in MoEngage UI

Log in to the MoEngage Dashboard and follow these steps:

1. Navigate to Settings -> Channel -> SMS -> Sender Configuration.
2. Click +Add Service Provider at the top right corner.
3. Add the following details in the Sender Details screen. Turn on Mark as default toggle to mark the sender as the default sender for the service provider being configured. If marked as default, this sender would be used for sending all SMS campaigns from MoEngage unless you select a different sender while creating the campaign.
   

   Field	Description
   Service provider name	This field identifies the service provider you are configuring on the MoEngage Dashboard and has to be unique. Enter 8x8 SMS as service provider name.
   Sender name	This field identifies the Sender. Enter 8x8 SMS as the name of the sender.
   Sender type	The Sender type can either be Promotional or Transactional. Choose the Sender type as Promotional when you would be using the Sender for sending information about your brand, promoting deals, or engaging with users. Choose the Sender type as Transactional when you would be using the sender for sending alerts about transactions, OTPs, security information, or any information that can be classified as transactional in nature.

4. Configure the Webhook by adding the following details:
   

   Field	Description
   API URL	This field contains information about the URL that should be used to send an API request to the sender. You can get this information from the API documentation of the sender. Enter the API Endpoint of the sender here. The API URL for 8x8 is: https://sms.8x8.com/api/v1/subaccounts/{Subaccount}/messages {Subaccount} in the URL should be replaced by your 8x8 subaccount. This can be found from the 8x8 Connect Dashboard in the API Keys section.
   Method	Select POST as the HTTP method.
   URL Parameters	Add the URL Parameters to be passed to the API as Key-Value pairs using this option. You can get this information from the API documentation of the sender. For example, if the API URL call uses the GET method, all the parameters such as API Key, Authorization, and so on, are passed as URL Parameters.
   Headers	Add the Request Headers to be passed to the API as key-value pairs using below option. Content-Type: application/json Authorization: Bearer {Api Key} You can find your API key in the 8x8 Connect Dashboard's API Keys section.
   Body Type	Configure the body for your requests. Select JSON and add the following details: In the message field, add Moesms_message to pass the MoEngage message into the request. In the sender field, add the Sender ID in your 8x8 account. In the recipient field, add Moesms_destination to add the recipient to the message.

5. Send a test SMS to verify your configuration.
6. Click Save to save the sender configuration.
7. You can configure delivery tracking after creating the sender in the MoEngage Dashboard. For information about Delivery Tracking, refer to Delivery Tracking for Custom Connectors.
8. You can map the attributes of the delivery tracking response manually or automatically.