Configure Provider for SMS

Kaleyra as an SMS Service Provider (SSP) allows you to send SMS campaigns by integrating with CleverTap.

Prerequisite:

  • You must have an active kaleyra.io account to use the Kaleyra SMS plugin on the CleverTap platform.
  • To register a new account on kaleyra.io, you can contact our Support team.
  • You must obtain an HTTP Endpoint for CleverTap from our Support team.

To configure the provider, perform the following steps:

  1. Sign in to your CleverTap account.
  2. From the left menu bar, click Settings.

The Settings page appears.

  1. Click Channels. The Channels page appears.
  1. Click SMS. The SMS Providers page appears.
  1. Click + Add Provider. The Setup tab details appear.
  1. The Add SMS Provider section has the following fields:

a. Click the arrow in the Provider field to view the list of supported providers. Select the (Other)Generic option.

b. In the Nickname field, provide any name to identify the provider. This is a mandatory field. For example, Kaleyra SMS.

c. The Callback URL field is required to get callback reports of the campaign in the CleverTap dashboard. Enter the Callback URL from the CleverTap configuration page. This will be needed also under the Headers tab table.

d. Click the arrow in the Request Type field to view the list of supported types. Select the POST method (See point 5 for the screenshot).

e. In the HTTP Endpoint field, enter the CleverTap endpoint URL provided by the Kaleyra Support team.

  1. In the Headers tab, click Add Pair, and then update the following keys and their corresponding values.
KeyValueMandatory
api-keyAPI Key generated by kaleyra.io. For more information on how to get the api-key details, see View API Key and SID.Yes
sidEnter the SID value retrieved from your Kaleyra application. For more information, see View API Key and SID.Yes
kaleyra-hostEnter the API domain URL from your Kaleyra application. https://api.kaleyra.io/Yes
callback_urlCopy and paste the link from the Callback URL field available in the Add SMS Provider section.Yes
  1. In the Parameters tab, select the Type as x-www-form-urlencoded. click Add Pair, and then update the following keys and their corresponding values. Any dynamic parameter, whose value will be defined at the campaign creation or execution time, shall be written in the form $$DynamicParameter, For example, $$To
KeyValueMandatory
to$$TOYes
senderSenderID of the customer. If you want to make this as a dynamic value,
add $$Sender (if you want to make this dynamic so that it is specific during the campaign creation, where you can choose which is the sender ID to be sent out campaign).
Yes
body$$Body. The message content that is delivered to the handset. Yes
template_id $$TemplateID. The template that is used by the Kaleyra customer. Unique ID of the template.Optional - India only
message_id$$MessageID. For each message in a campaign, CleverTap generates a unique message ID. The Customer needs to add $$MessageID to indicate that receiving a callback call via SMS status update is mandatory.Yes
campaign_id$$CampaignID. CleverTap generates a unique ID for every campaign that is configured on their platform. Yes
typeType can be either Dynamic or Constant. For Indian customers, you can use one of the following:
OTP, MKT, or TXN.
For non-Indian customers, you can use Default or OTP. Similar to the sender key, if you want to make this field dynamic and want to select the value during campaign creation use value $$TYPE.
Yes
long_urlThe long_url contains the URL that needs to be shortened and used in the campaign. You can either add a long URL like a static value or make it a dynamic parameter. In this latter case use $$LongURL. Yes, if you want to shorten the callback URL.
  1. Click Send test SMS. The Send a Test SMS page appears.
  1. The Send a Test SMS page has the following fields:

a. In the Country Code field, enter the required country code. For example +91.

b. In the Mobile number field, enter the number to which you need to get a sample message.

c. In the Template ID field, enter the template ID from the kaleyra.io application. For Indian customers, this must be the DLT template id of the saved template.

d. In the Message field, enter the body of the message.

For the long URL to work in the body text use {long_url}. For example, This is a Test message {long_url}

e. If the sender and type are made dynamic as explained in the Parameters tab table, then you need to enter those values too. In the Message body Key-value pair field, for the SENDER key enter the value as $$Sender, and for the TYPE key enter the value $$TYPE (if you want to make this field dynamic and want to select the value during campaign creation).

πŸ“˜

Note:

You need to enter the valid sender ID and type while creating the provider.

f. In the LONGURL field, enter the long URL to be shortened.

πŸ“˜

Note:

For customers in India, ensure you register the message content with DLT (India Telecom Regulations).

  1. Click Send Test. The message "1 out of 1 successfully sent" appears.
  1. Select Mark as default, if you want every time the same provider is selected.
  2. Click Save. If all the details get validated, Review provider credentials? message appears.
  1. Click Save. A pop-up message "Saved sms settings successfully" appears.

πŸ“˜

Note:

You can view the message sent under Kaleyra.io>Channels>SMS>Logs page.