Kaleyra

SMS Provider

Overview

Kaleyra is a Communications Platform as a Service (CPaaS) provider that helps businesses send and receive SMS messages across global markets.

By integrating Kaleyra with CleverTap, you can manage SMS campaigns directly from the CleverTap dashboard, alongside other engagement channels. This integration supports message delivery and DLR (Delivery Report) tracking, allowing you to run personalized, targeted SMS campaigns as part of your omnichannel strategy.

Here are a few ways businesses use Kaleyra with CleverTap:

  • Transactional Alerts: Deliver real-time OTPs, order confirmations, and payment updates.
  • Promotional Campaigns: Announce offers, discounts, or product launches to targeted user segments.
  • Abandoned Cart Reminders: Prompt users to complete their purchase with time-sensitive nudges.

Integrate CleverTap’s segmentation engine with Kaleyra SMS to trigger context-aware messages and increase engagement.

Prerequisites for Integration

To integrate ICS with CleverTap, check the following:

  • You must have an active Kaleyra account with API access.
  • You must obtain the HTTP Endpoint, API Key, SID, and Kaleyra host URL from Kaleyra support.
  • You must have a CleverTap account with SMS setup enabled.
  • If your account is based in India, ensure your message templates and sender IDs are registered with DLT.

🚧

Support for Integration

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

Integrate Kaleyra with CleverTap

The integration includes three major steps:

  1. Find Kaleyra API Credentials
  2. Set Up CleverTap Dashboard
  3. Send a Test SMS

Find Kaleyra API Credentials

To complete the setup, gather the following details from your Kaleyra account or Kaleyra support:

  • API Key: Found under API Settings in your Kaleyra Customer Portal. Used in the api-key header.
  • SID: Sender ID linked to your Kaleyra account. Used in the sid header.
  • API Host Domain: The base URL used to send requests. Set this in the kaleyra-host header.

For more information on locating Kaleyra API credentials, refer to View API Key and SID

Set Up CleverTap Dashboard

Set up the CleverTap dashboard to connect and authenticate your Kaleyra SMS provider. To configure the CleverTap dashboard:

  1. Go to Settings > Engage > Channels > SMS in the CleverTap dashboard.
  2. Click + Add Provider. The Add SMS provider page opens.
Add Provider

Add Provider

  1. Under Provider, select Other (Generic) and enter the following details:
FieldDescription
NicknameEnter the nickname of the SMS provider to identify it uniquely. For example:Kaleyra_SMS
Callback URLEnter this URL in the Kaleyra platform to receive delivery status updates for your SMS messages. Refer to Set Up SMS Callbacks.
Request TypeSelectPOST
HTTP EndpointPaste the URL received from Kaleyra team.
Ensure that the URL is in HTTPS format, that is, your URL must begin with https://.
AuthenticationUnder Authentication, select one of the following options:

- No Authentication.
- Basic Authentication: Enter the username and password.
  1. Under Headers, enter the following Key/Value pair.
KeyValue
api-keyAPI Key from Kaleyra
sidSID from Kaleyra
kaleyra-hostAPI domain from Kaleyra
callback_urlCleverTap callback URL
Provider Configuration

Provider Configuration

  1. In the Parameters tab, set the Type to x-www-form-urlencoded. Enter the following as a Key/Value pair:
  2. Under the Parameters tab:
    • Set Type to x-www-form-urlencoded
    • Add the following key-value pairs:
KeyValueDescriptionRequired
to$$ToRecipient’s phone numberYes
sender$$SenderSender ID (dynamic if mapped)Yes
body$$BodyMessage contentYes
template_id$$TemplateIDDLT Template ID (mandatory for messages in India)Optional
message_id$$MessageIDUnique CleverTap message ID for trackingYes
campaign_id$$CampaignIDCleverTap campaign IDOptional
type$$TYPEMessage type (OTP, MKT, TXN, or Default, OTP)Optional
long_url$$LongURLLong URL to shorten and insert into the message (if supported)Optional

πŸ“˜

Note

$$MessageID is required for accurate DLR (Delivery Report) tracking. Kaleyra must return the same ID in the delivery callback.

Set Parameters

Set Parameters

  1. Click on Save. A pop-up box will appear, prompting you to Send Test SMS.

Send a Test SMS

Sending a test SMS helps confirm that your Kaleyra integration is working before launching a live campaign. This ensures the API endpoint is correctly configured, authentication is valid, and messages can be delivered.

To validate your configuration:

  1. Click the Send Test SMS hyperlink before creating SMS campaigns and journeys.
  2. Enter the following details:
    • Country Code and Mobile Number: Enter the country code and mobile number to which you want to send the message.
    • Template ID: (if applicable)
    • Message: Enter sample text, such as This is a test message powered by Kaleyra.
    • Dynamic Fields: If sender, type, or long_url are dynamic, provide those values as key-value pairs
Send a Test SMS

Send a Test SMS

  1. Click Send Test.

If the configuration is correct, the test message will be delivered, and Kaleyra will return a DLR update. If there is an error (for example, incorrect credentials or endpoint), CleverTap will display a failure notification.

Set Up SMS Callbacks

To track SMS requests, copy the Delivery report callback URL from the CleverTap dashboard and share it with the Kaleyra support team.

  1. You can find the Delivery report callback URL on the CleverTap dashboard under the Provider Setup page Settings > Channels > SMS > Provider Nickname
  2. Share this URL with Kaleyra support.
Set Up SMS Callbacks

Set Up SMS Callbacks

Verifying Successful Integration

Your integration is considered successful when the following criteria are met:

  • The test SMS is delivered to the intended mobile number.
  • You receive a DLR (Delivery Report) callback from Kaleyra at the configured CleverTap callback URL, indicating delivery, failure, or queue status.
  • CleverTap logs show no errors related to authentication, payload structure, or message transmission.

Once these conditions are met, you can proceed to build and launch SMS campaigns or set up Journeys using Kaleyra as your SMS provider.