> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Kaleyra
# Introduction
Kaleyra is the API-based platform to engage your clients with personalized messages, chatbots, programmable voice services, and more.
Use this setup to set Kaleyra as an **integrated** SMS Provider if you plan to send SMS in **India** via Kaleyra. Configure Kaleyra as a Custom Connector (Service Provider) for other regions.
**Prerequisites** Ensure that you have the login credentials: the API secret for the SMS Kaleyra Account. If you have any issues with the credentials or if you do not have the credentials, contact Kaleyra support.
# Configure as a Service Provider (Integrated)
To configure Kaleyra as an Integrated Service Provider, log in to the MoEngage Dashboard and follow these steps:
1. Navigate to **Settings** > **Channel** > **SMS** > **Sender configuration**.
2. Click **+Add Service Provider** at the top right corner.
3. Select **Kaleyra** in the **Add Sender** screen.
4. Add the following details in the **Sender Details** screen:
| Field | Description |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mark as default** | This toggle will be disabled during sender creation. The first sender to be created in your MoEngage account will be marked as the default sender for your SMS campaigns. You can change the default sender by following the steps mentioned in [Marking a sender as default](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-an-sms-sender). |
| **Sender name** | This field identifies the readable sender name that can be used while creating a campaign or alert. |
| **Sender type** | The Sender type can either be one of the following:
1. **Transactional**
2. **Promotional**
Select the appropriate sender type. |
| **Sender ID** | This is the number from which SMS will be sent to your users. |
| **API secret** | This is the secret key to authenticate API requests to your Kaleyra account. |
5. **Send a test SMS** to verify your configuration.
6. Click **Save** to save the Sender Configuration.
7. Delivery Callback - Delivery receipts will be automatically tracked by MoEngage. MoEngage passes the delivery callback URL in the API call to Kaleyra. You don't have to do any additional configuration for tracking the SMS delivery when using Kaleyra as an integrated service provider.
# Configure as a Custom Service Provider
1. Navigate to **Settings** > **Channel** > **SMS** > **Sender configuration**.
2. Click **+Add custom service provider** at the top right corner.
3. Add the following details in the **Sender Details** screen:
| Field | Description |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mark as default** | Turn on this toggle to mark the sender as the default sender for the service provider being configured. If marked as default, this sender would be used for sending all SMS campaigns from MoEngage unless you select a different sender while creating the campaign. |
| **Service provider name** | This field identifies the service provider you are configuring on the MoEngage Dashboard and has to be unique. Type the name of the service provider here. |
| **Sender name** | This field identifies the Sender. Type the name of the sender here. |
| **Sender type** | The Sender type can either be **Promotional** or **Transactional**. Choose the Sender type as Promotional when you would be using the Sender for sending information about your brand, promoting deals, or engaging with users. Choose the Sender type as Transactional when you would be using the Sender for sending alerts about transactions, OTPs, security information, or any information that can be classified as transactional in nature. |
4. Configure the Webhook by adding the following details:
| Field | Description |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API URL** | This field contains information about the URL that should be used to send an API request to the Sender. You can get this information from the API Documentation of the Sender. Type the API Endpoint of the sender here. The API URL for Kaleyra is: [https://moengage-sms-api.kaleyra.io/send-sms](https://moengage-sms-api.kaleyra.io/send-sms) |
| **SID** | This field contains the Sender ID for Kaleyra. |
| **Kaleyra Host** | Kaleyra Host URL: [https://api.in.kaleyra.io/](https://api.in.kaleyra.io/) |
| **Method** | Select **GET** as the HTTP method. |
| **URL Parameters** | The URL Parameters will be populated from the API URL.
1. Replace **YourApiKey** with the API key provided by Kaleyra. In the **to** field, you can invoke the personalization editor by typing using *@.* In the editor, you can select the user attribute that stores the user's mobile number. Ensure that the selected attribute consists of mobile numbers.
2. Replace **YourSenderId** with the sender ID of your account provided by your service provider.
3. Add the following values in the **to** and **message** fields:
- "to" Number to Moesms\_destination
- "message" to Moesms\_message |
5. **Send a test SMS** to verify your configuration.
6. Click **Save** to save the Sender Configuration.
7. You can configure delivery tracking after creating the sender in the MoEngage Dashboard. For information about Delivery Tracking, refer to [Delivery Tracking for Custom Connectors](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-custom-connector-for-sms).
8. You can map the attributes of the delivery tracking response manually or automatically.
# Next Steps
* Create an SMS campaign using the [Getting Started for creating SMS campaign](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/create-an-sms-campaign).
* Set the [Frequency Capping for SMS](/docs/user-guide/settings/channels/delivery-controls/frequency-capping).
* Set the [Current Service Provider](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-an-sms-sender).