This guide demonstrates how to integrate ValueFirst Digital with CleverTap for WhatsApp communication
This integration is completed by ValueFirst, and they are dedicated to maintaining and enhancing it. The CleverTap <> ValueFirst integration has undergone stringent testing to ensure its seamless functionality. In the event of any questions or issues, users must rely on ValueFirst for support and resolution.
CleverTap users can now leverage the WhatsApp capabilities of ValueFirst Digital to communicate with their customers. The communication includes:
- Sending just-in-time offers to customers to drive purchases
- Gathering feedback on the services
- Keeping customers informed and more
Prerequisites for Integration
- You must have WhatsApp add-on enabled on the Clevertap account in addition to the basic price plan.
- You need to have an XML account for WhatsApp channel API. (Raise a request at [email protected] to get the WhatsApp XML account in case you do not have one). Expect a response with the WhatsApp account details (Username, Password, WhatsApp number.)
- Ensure that the IP (18.104.22.168) is whitelisted against the XML account at the ValueFirst side.
Integrate ValueFirst with CleverTap
This process involves the following three steps:
- Signup for ValueFirst-CleverTap Integration Plugin
- Configure ValueFirst
- Configure CleverTap dashboard.
Signup for ValueFirst-CleverTap Integration Plugin
To get started with the integration, the first step is to sign up for ValueFirst-CleverTap WhatsApp Integration. Click this link to sign up. Signup by entering the Name, Email, Company name, and Password.
The next step is to log into the ValueFirst portal and configure the connection.
- To configure the ValueFirst-WhatsApp connection, you need to log in to the ValueFirst portal using the credentials configured in the previous step.
- After you log in, enter the credentials - Username, Password, WhatsApp Phone number (received as part of a prerequisite) and click Authenticate to configure the connector.
After successful authentication, you will get a message - Successfully authenticated ValueFirst account
You can copy the webhook URL available at the bottom (as shown in the image above) and share it with the ValueFirst sales or support team for inbound message and delivery reports configuration.
Configure CleverTap Dashboard
To configure the CleverTap dashboard:
- Navigate to Settings > Channels > WhatsApp from the CleverTap dashboard.
- Click + Add Provider and select Generic (Other) from the dropdown.
- Enter the following details:
|Provider||Select Other (Generic) from the dropdown list.|
|Nickname||Enter the nickname as ValueFirst|
|WhatsApp Business Number||Enter your phone number onboarded to WhatsApp API by ValueFirst.|
|Request Type||Ensure Request Type is Post|
|HTTP End point||You need to paste the Auth URL from ValueFirst post its configuration.|
- Click Header > Enter the Key name as Authorization and paste the Basic Token Value from the ValueFirst plugin.
- Select the Mark this as default checkbox to make this service provider the default provider to send a WhatsApp message.
- To send an automatic reply to users who message on WhatsApp, but are not tracked on the CleverTap dashboard, you can select the Set auto reply for users not tracked on CleverTap checkbox.
- Send a Test WhatsApp notification:
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.
- Click Save to save the details.
You can find the Auth URL under the CleverTap tab on the ValueFirst connector as shown below.
Configure CleverTap Webhooks
To configure the webhooks, you need to:
Copy the Delivery report callback URL and Inbound Message Callback URL from CleverTap and paste them into Valuefirst’s Status Callback and Incoming Callback fields respectively
You can find the Delivery report callback URL and Inbound Message Callback URL under the Provider Setup page ( Settings > Channels > WhatsApp > Provider Nickname)
To paste the callback URLs, navigate to ValueFirst-CleverTap WhatsApp Plugin > select the CleverTap tab next to the ValueFirst tab and paste the Status Callback & Incoming Callback. After pasting the URLs, click Save to save the configuration.
Adding Message Template
In order to create WhatsApp campaigns, you need to have pre-approved WhatsApp message templates saved in the CleverTap dashboard. Follow the procedure below to add the templates.
- Navigate to Settings > Channels > WhatsApp > Provider Nickname in the CleverTap dashboard. Further Select the Templates option, and click +Template.
- Enter the template name in the namespace field.
- Choose the type of template header (Text or Media). For Media headers, you can use Image, Video, Document, and Location
- Enter the message content.
- You can also choose to add a Footer text and a Button (Quick Reply or a Call To Action).
- You can also choose the language in which you want to display the message.
- Click Save Template.
Testing a Message Template
You can send a test message using the saved templates from the CleverTap dashboard as follows:
- Hover over the desired template for which you want to send a test notification.
- Click Send Test.
- Select the test profiles or manually enter the mobile number to whom you want to send the test message and click Send Test.
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 ValueFirst team to debug the issue, as shown in the following figure:
To create a WhatsApp campaign using ValueFirst as the provider, refer to Create a WhatsApp Campaign for detailed instructions.
Creating a Journey
To create a WhatsApp journey using ValueFirst as the provider, refer to Create a WhatsApp Journey for detailed instructions.
Updated 29 days ago