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.PrerequisitesEnsure you have access to your Helo.ai Dashboard and have the API key for your VivaConnect account.
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:- Navigate to Settings -> Channel -> SMS -> Sender Configuration.
- Click +Add Service Provider at the top right corner.
- 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. |
- 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.
|
| 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"}]} |
- Send a test SMS to verify your configuration.
- Click Save to save the Sender Configuration.
- 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.
- 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).
Next Steps
- Create an SMS campaign using the Getting Started for creating SMS campaign.
- Set the Frequency Capping for SMS.
- Set the Current Service Provider.
- Read more about campaign analytics.