CleverTap supports customers sending and receiving WhatsApp messages using Gupshup as their provider. Once a provider is selected, the user must create a template before creating a WhatsApp campaign.

Select Gupshup Provider

Perform the following steps to select Gupshup as the messaging provider for WhatsApp.

  1. From the CleverTap dashboard, navigate to Settings and click on Channels.
  2. Select WhatsApp > WhatsApp Connect.



Only one WhatsApp Provider account is supported per CleverTap project.

  1. Click +Providers, and select Gupshup from the Provider list.

Provider Setup

  1. Enter the following credentials:
  • Nickname: Enter the nickname for this set of credentials.
  • Inbound message callback URL: This is a non-editable field.

Note that the Gupshup must use the following payload format to configure incoming message callbacks at their end.

CleverTap_Sandbox Incoming Hits - Calling URL :: POST :: https://cb.wzrkt.com/gupshup/response?a=XXX-XXX-XXXX ==> {
  "waNumber": "91XXXXXXXXXX",
  "mobile": "91XXXXXXXXXX",
  "name": "John Doe",
  "text": "incoming text",
  "type": "text",
  "timestamp": "1658261071000"
  • Delivery reports callback URL: This is a non-editable field.

Note that the Gupshup must use the following payload format to configure DLR callbacks at their end.

2022-02-25 01:22:30 ################ KEYVALUE Forwarding: https://cb.wzrkt.com/gupshup/status?a=XXX-XXX-XXXX => headers:  => body: [response:[{
  "srcAddr": "CLVTAP",
  "extra": "9|1658264893|20220720|9|wzrk_default",
  "channel": "WHATSAPP",
  "externalId": "4687162516402008133-497817541934555810",
  "cause": "READ",
  "errorCode": "026",
  "destAddr": "+91XXXXXXXXXX",
  "eventType": "READ",
  "eventTs": 1658264959000
  • HSM account ID: Enter the HSM account user ID.
  • HSM account password: Enter the HSM account password.
  • Two-way account user ID: Enter the two-way account user ID.
  • Two-way account password: Enter the two-way account password.
  • Mobile Number: Enter either a Gupshup phone number or a shortcode. You can enter phone numbers or shortcodes listed under the Gupshup dashboard > Numbers > Your Numbers.


Non-Editable Fields

The inbound message callback URL and delivery reports callback URL are non-editable fields. These values must be set up in your Gupshup account to allow CleverTap to receive inbound messages from end-users and delivery reports for messages sent through Gupshup.


Auto Reply Checkbox

Select the checkbox if you want to set auto-replies for users who are not tracked in CleverTap. If a message is received from a phone number for which a profile is not present with CleverTap, then this default message is sent to the user.

  1. Send a Test WhatsApp notification:

Send Test Message on WhatsApp

To ensure that the integration is successful:
a. Click the Send Test WhatsApp hyperlink before you start creating WhatsApp campaigns and journeys. To begin with, activate the conversation window by following any one of the following methods:
i. Save the business contact and send a WhatsApp message to that number.
ii. Copy and share the link with the user you want to send the test notification to. Further, ask the user to click on the link and send a WhatsApp message to initiate a conversation.
iii. If you want to send a test notification to yourself, you can click the link and initiate a WhatsApp conversation.

b. Enter the following details:
Country Code and Mobile Number: Enter the country code and mobile number of the user to whom you want to send the test message.
Message: Here, you can enter the sample text message you want to send to the test user. Once you click on Send Test, the success or failure response displays on the dashboard. If the message is not delivered, you can copy the response payload and share it with the Gupshup team to debug the issue.

  1. Click Save.

Add Multiple WhatsApp Phone Numbers


Adding Multiple Numbers

Customers can add multiple phone numbers for WhatsApp irrespective of their service provider. In case the business has multiple numbers, the autoresponse, FAQ response, and agent replies will go from the number that received the last message from customers.

To add a phone number to your WhatsApp profile, follow steps 3 onwards here.

Select Template


Naming WhatsApp Templates

Template names 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, phone_2, you can use the same template name once within Phone_1 and Phone_2.

Once you have added Gupshup as the provider, create a template for the campaign.

  1. Select the Templates option, and click +Template.

Create a New Template

  1. Enter the template name in the Template Name field.
  2. Choose the type of template header (Text or Media). For Media headers, you can use Image, Video, Document, and Location
  3. Enter the message content.
  4. You can also choose to add a Footer text and a Button (Quick Reply or a Call To Action).

Define Template Body

  1. Click Save.

Testing a Message Template

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

  1. Hover over the desired template for which you want to send a test notification.
  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.

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 Nexmo team to debug the issue, as shown in the following figure:


Validate the Test Response

Create Campaign

To create a WhatsApp campaign using Gupshup as the provider, refer to Creating a WhatsApp Campaign for detailed instructions.


IP Whitelisting

Restricted IPs can cause errors during integration. Check that there are no IP restrictions enabled on the Gupshup account. To check the IPs from the CleverTap dashboard, go to Settings > Channels > WhatsApp. The FCM credentials _section lists the IPs that are used to send WhatsApp requests. These IPs must be whitelisted on both the _one-way _and _two-way account IDs of Gupshup.

Restricted IPs

Restricted IPs