Introduction 

VivaConnect is a leading mobile engagement and communication solution provider dedicated to helping businesses create personalized and impactful customer interactions. By offering various services across multiple channels, VivaConnect enables companies to enhance their marketing efforts and deliver superior customer support, ensuring meaningful and responsive connections with their audiences.

Configure VivaConnect as a Custom SMS Connector (Service Provider)

This article will help you set VivaConnect as a Custom Connector on the MoEngage dashboard.

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.

   Mark as default

   Enable the toggle to mark the sender as the default sender for the configured service provider. If marked as default, this sender will be used to send 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 must be unique. Type the service provider's name here.
   Sender name	This field identifies the readable sender name that can be used while creating a campaign or alert.
   Sender type	The Sender type can either be Promotional or Transactional. Choose the Sender type as Promotional when you would be using the Sender to send information about your brand, promote deals, or engage with users. Choose the Sender type as Transactional when you would be using the Sender to send 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 Sender's API Documentation. Type the sender's API Endpoint here. The API URL for VivaConnect is: https://promoapp.helo.ai/vivasmpp/sms/submit
   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 this option. You can get this information from the API Documentation of the Sender. Add the Authorization Header. Content-Type: application/json apikey: {{Workspace_ID or APP_ID}}
   Body Type	Choose the Body Type as JSON and add the following details: {   "msg_type": 2,   "list": [              {                "d": "993055xxxx",                "s": "SAMPLE",                "m": "This is a test 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.
   
   In the Delivery tracking URL field, enter the following URL:
   https://api-0X.moengage.com/sms/dlr/custom/2962625414
   where X is the number of the data center (DC).