MSG91

WhatsApp Provider

Overview

MSG91 offers robust WhatsApp messaging solutions that enable businesses to engage with customers through rich media messages, feedback collection, and automated processes. By integrating MSG91 with CleverTap, you can enhance your customer communication strategies by:

  • Sending engaging carousels and interactive messages to deliver dynamic content to captivate your audience.
  • Collecting valuable customer feedback to gain insights to improve your services.
  • Building automated flows and enabling seamless payment processes to streamline operations and enhance user experience.

🚧

Support for Integration

This integration is managed and continuously improved by MSG91. The CleverTap and MSG91 integration has undergone stringent testing to ensure seamless functionality. For any questions or issues, contact MSG91 for support and resolution.

Prerequisites for Integration

The following are the prerequisites:

  • You must have WhatsApp add-on enabled on the CleverTap account in addition to the Basic or Essentials Plan.
  • Ensure that WhatsApp onboarding for the phone number to be used with CleverTap is completed. If you want to activate a new phone number with WhatsApp Business API via MSG91, contact your Account Manager or send an email to [email protected].
  • Ensure that you have the API URL and credentials from MSG91.

Integrate MSG91 with CleverTap

This process involves the following two steps:

  1. Configure CleverTap Dashboard.
  2. Set Up CleverTap Callbacks in MSG91.

Configure CleverTap Dashboard

To configure the CleverTap dashboard:

  1. Go to Settings > Channels > WhatsApp > WhatsApp Connect from the CleverTap dashboard.
  2. Click + Add Provider and select Generic (Other) from the dropdown.
Provider Setup

Provider Setup

  1. Enter the following details:
FieldDetails
NicknameEnter the nickname as MSG91 or MSG91 <10-digit phone number> for easy reference.
Mobile NumberAdd your WhatsApp Integrated number with country code (for example, 918889500122)
Request TypeEnsure the Request Type is POST.
HTTP End PointEnter HTTP Endpoint as the following:https://api.msg91.com/api/v5/whatsapp//outbound/clevertap/
AuthenticationSelect Basic Authentication and enter the Username of your MSG91 account.
  1. (Optional) Select Mark this as default to make this service provider the default provider to send a WhatsApp message via MSG91.
  2. (Optional) Select Set auto-reply for users not tracked on CleverTap to automatically reply to users who message on WhatsApp but are not tracked on the CleverTap dashboard.
  3. (Optional) Set the Maximum Concurrent API requests between 30 and 1000. Consider your requirements and the provider's limitations when defining this value.

Set Up CleverTap Callbacks in MSG91

To set up CleverTap callbacks in MSG91, follow the steps below:

  1. Locate Callback URLs in CleverTap: Go to Settings > Channels > WhatsApp > WhatsApp Connect > MSG91 from the CleverTap dashboard. You will find the required Callback URLs on the Provider Configuration page.
Callback URLs

Callback URLs

  1. Configure Inbound Message Callback in MSG91: Copy the Inbound Message Callback URL from the CleverTap dashboard and paste it into the Inbound Messages section of the webhook in the MSG91 panel.
Configure Inbound Message Callback in MSG91

Configure Inbound Message Callback in MSG91

  1. Configure Outbound Message Callback in MSG91: Copy the Delivery Report Callback URL from the CleverTap dashboard and paste it into the Outbound Messages section of the webhook in the MSG91 panel.
Configure Outbound Message Callback in MSG91

Configure Outbound Message Callback in MSG91

  1. Add the following header values to your webhook configuration in the CleverTap dashboard:
FieldDetails
AuthkeyEnter your MSG91 Authkey. This is a unique key used to authenticate API requests. Refer to the MSG91 Auth key to obtain your Authkey.
Content-typeSet this to application/json to indicate that the request body is in JSON format.
AcceptSet this to application/json to specify that the response should be in JSON format.
Configure Headers

Configure Headers

  1. Enable the CleverTap toggle in the MSG91 panel's WhatsApp number settings before clicking the Save button.
  2. Test the integration, then click Save to finalize the setup.

πŸ“˜

Note:

You have to get your templates approved on the MSG91 dashboard. Once approved, add the same templates in the CleverTap dashboard for sending out messages. For more information and queries about the MSG91 integration, write to [email protected].

Adding Message Templates

To create WhatsApp campaigns, you must have pre-approved WhatsApp message templates saved in the CleverTap dashboard. To add the templates, follow these steps:

  1. Go to Settings > Channels > WhatsApp > WhatsApp Connect > Provider Nickname in the CleverTap dashboard. Further, Select the Templates option and click +Template.
Create a New Template

Create a New Template

  1. Enter the template name.

    πŸ“˜

    Naming WhatsApp Templates

    Template names and language variants must be unique for each provider configuration. This means that you can use the same template name once for each provider configuration.

    For example, if you have multiple provider configurations, such as Phone_1 and Phone_2, you can use the a particular template name once within Phone_1 and Phone_2.

  2. You can also choose the language in which you want to display the message.
  3. Select the type of template header (Text or Media). For Media headers, you can use Image, Video, Document, or Location.
  4. Create a Limited Time Offer Template, if required.
  5. Enter the message content.
  6. Select Footer to add a footer text and a button (Quick Reply or a Call To Action).
Define Template Content

Define Template Content

  1. Click Save Template.

Testing a Message Template

You can send a test message using the saved templates from the CleverTap dashboard as follows:

  1. Right-click the ellipsis below the template.
  2. Click Send Test.
  3. Select the test profiles or manually enter the mobile number to whom you want to send the test message and click Send Test.
1304

Test a Message Template

The success or failure response is displayed on the dashboard. If the message is not delivered, you can copy the response payload and share it with the MSG91 team to debug the issue, as shown in the following figure:

Screen shows the format of a successful delivery response after sending a WhatsApp Message

Successful Delivery Response

Create Campaign

For detailed instructions on creating a WhatsApp campaign using MSG91 as the provider, refer to Create a WhatsApp Campaign.

Creating a Journey

For detailed instructions on creating a WhatsApp journey using MSG91 as the provider, refer to Create a WhatsApp Journey.