> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# VivaConnect

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

<Info>
  **Prerequisites**

  Ensure you have access to your [Helo.ai](http://Helo.ai) Dashboard and have the API key for your VivaConnect account.
</Info>

# 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](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. <ul><li>Content-Type: application/json</li><li>apikey: `{{Workspace_ID or APP_ID}}`</li></ul>                                                    |
| **Body Type**      | Choose the Body Type as **JSON** and add the following details:<br />`{`<br />`"msg_type": 2,`<br />`"list": [`<br />`{`<br />`"d": "993055xxxx",`<br />`"s": "SAMPLE",`<br />`"m": "This is a test message"`<br />`}`<br />`]`<br />`}`                                                                                                    |

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](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-custom-connector-for-sms).
8. You can map the attributes of the delivery tracking response manually or automatically.\
   <img src="https://mintcdn.com/moengage/cJSG0nHne5L3-Q_X/images/partner_30658292896276.png?fit=max&auto=format&n=cJSG0nHne5L3-Q_X&q=85&s=242e80670c271342c4769748d90e5137" alt="gupshup.png" width="2204" height="1908" data-path="images/partner_30658292896276.png" />\
   In the **Delivery tracking URL** field, enter the following URL:\
   [https://api-0X.moengage.com/sms/dlr/custom/2962625414](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](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/create-an-sms-campaign).
* Set the [Frequency Capping for SMS](/docs/user-guide/settings/channels/delivery-controls/frequency-capping).
* Set the [Current Service Provider](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/other-settings/configure-sms-mms-and-rcs-general-settings).
* [Read more about campaign analytics.](/docs/user-guide/campaigns-and-channels/connectors/analyze/connector-campaign-analytics)