SMS Connector

This guide explains how to configure Qikberry SMS as a provider in CleverTap and enable SMS delivery status tracking through Qikberry webhooks.

Video Walkthrough: Qikberry SMS Connector for Clevertap

1. Access SMS Settings in CleverTap

2. Configure Qikberry as the SMS Provider

Under SMS Connect, click Add Provider.

Select Generic (Other) as the provider.

Enter Qikberry SMS in the Nickname field.

In the HTTP Endpoint field, enter:

https://qikbridge.qikberry.ai/v1/clevertap/sms

3. Configure Request Headers

Under the Headers section, add the following entries:

Header	Value
Authorization	Bearer `<Qikberry Access Token>`
Content-Type	application/json

Note: Generate the access token from the Developers Section in App.

4. Configure CleverTap Delivery Callback URL in Qikberry

To receive SMS delivery status updates in CleverTap, configure a webhook in Qikberry.

Navigate to Developers → Webhooks.

Click Create Webhook and configure the webhook using the following details:

Field	Value
Method	POST
Service	CleverTap SMS
URL	Delivery Report Callback URL provided by CleverTap

Save the webhook configuration.

Once configured, Qikberry will automatically push SMS delivery status updates to CleverTap.

5. Configure Request Parameters

Navigate to the Parameters section and add the following JSON payload:

{
  "to": "$$To",
  "sender": "$$Sender",
  "service": "$$Service",
  "message": "$$Body",
  "template_id": "$$TemplateID",
  "custom": "$$MessageID",
  "webhook_id": "$$WebhookID"
}

Save the configuration once the payload has been added.

Parameter Description

Parameter	Description
`to`	Recipient mobile number
`sender`	Sender ID
`service`	SMS service type
`message`	SMS message content
`template_id`	DLT Template ID
`custom`	CleverTap Message ID for tracking
`webhook_id`	Qikberry Webhook ID used for delivery callbacks

Important: Configure a valid Qikberry Webhook ID in the webhook_id field to receive SMS delivery status updates from Qikberry.

Note: To copy the Webhook ID, navigate to Qikberry Developers Option → Webhooks, then locate and copy the Webhook ID

Sample Message:

After clicking Save, the system should send a sample message to validate the connector configuration.

The sample request can use the following placeholder values:

Key	Value
Template ID	120716993437302xxxx
Template Content	Your one time password - OTP is 123456 to sign in to your account
Webhook ID	b5080955-44de-4a12-b21c-92321ff7xxxx
Service	SI
Sender	YESBNK

Note: The template content must contain the final message text. Do not use template variables such as {{1}}.

Video-Walkthrough

Integration Complete

Your CleverTap account is now configured to send SMS messages through Qikberry and receive real-time delivery status updates for tracking and analytics.

1. Access SMS Settings in CleverTap#

2. Configure Qikberry as the SMS Provider#

3. Configure Request Headers#

4. Configure CleverTap Delivery Callback URL in Qikberry#

5. Configure Request Parameters#

Parameter Description#

Video-Walkthrough#

Integration Complete#