Route Mobile
Learn how to integrate Route Mobile with CleverTap to send SMS notifications, OTPs, and campaigns globally with delivery tracking and DLT compliance.
Overview
Route Mobile is a cloud communications platform that provides scalable and secure SMS delivery across global markets. When integrated with CleverTap, it allows businesses to send real-time SMS notifications and promotional messages with advanced tracking and delivery insights.
Hereโs how businesses use Route Mobile with CleverTap:
- OTP and Alerts: Send authentication codes, transaction updates, and critical account messages.
- Promotional Campaigns: Reach user segments with marketing offers and time-bound deals.
- Order Notifications: Deliver shipping, order, and service status updates instantly to customers.
Integrate CleverTapโs segmentation and campaign engine with Route Mobile's SMS delivery pipeline for high-engagement, context-driven messaging.
Prerequisites for Integration
To integrate Route Mobile with CleverTap, ensure the following:
- You must have Route Mobile credentials (username, password, sender ID, DLT credentials), provided by the Route Mobile SPOC.
- You must have a CleverTap account with SMS channels enabled.
- If registered in India, your Route Mobile account must be DLT-compliant.
Support for Integration
This integration is managed and continuously improved by Route Mobile. The CleverTap and Route Mobile integration has undergone stringent testing to ensure seamless functionality. For any questions or issues, contact Route Mobile for support and resolution.
Integrate Route Mobile with CleverTap
To integrate Route Mobile SMS with CleverTap, follow these three steps:
Route Mobile API for Integration
CleverTap sends HTTP(S) requests to Route Mobile's API for SMS delivery. Following are the common endpoints based on the message region:
-
Domestic SMS API: Used to send messages to Indian mobile numbers with DLT compliance.
http://sms6.rmlconnect.net:8080/bulksms/personalizedbulksms?...parameters...
-
International SMS API: Used for sending messages to numbers outside India.
https://api.rmlconnect.net/bulksms/bulksms?...parameters...
These are the static authentication and sender parameters typically required in the Route Mobile API:
Parameter | Description |
---|---|
username | Route Mobile account username. |
password | Route Mobile account password. |
source | Sender ID used for sending SMS. |
These parameters are set once during configuration and do not change per campaign.
System Dynamic Replacements
CleverTap dynamically replaces the following placeholders during SMS campaign execution to personalize and route each message appropriately:
Dynamic Parameter | Description | Required |
---|---|---|
$$To | Recipientโs phone number | Yes |
$$Body | SMS content | Conditional |
$$TemplateID | DLT Template ID (required for India) | Conditional |
$$TemplateVariables | Additional values for customizing DLT templates | Optional |
$$CampaignID | Unique CleverTap campaign identifier | Optional |
$$MessageID | Unique message ID for tracking delivery reports | Required for DLR |
These dynamic fields must be used in the request URL or payload and will be replaced by CleverTap at send time.
Set Up CleverTap Dashboard
Set up the CleverTap dashboard to connect and authenticate your Route Mobile SMS provider. To configure the CleverTap dashboard:
- Go to Settings > Engage > Channels > SMS in the CleverTap dashboard.
- Click + Add Provider. The Add SMS provider page opens.

Add Provider
- Under Provider, select Other (Generic) and enter the following details:
Field | Description |
---|---|
Nickname | Enter the nickname of the SMS provider to identify it uniquely. For example:RouteMobile . |
Callback URL | Enter this URL in the Route Mobile platform to receive delivery status updates for your SMS messages. Refer to Set Up SMS Callbacks. |
Request Type | Select POST , then specify the Route Mobile API endpoint: https://ap.awsigateway.com/v1/enterprises/messages.json . Refer to Sample Payload Structure (JSON). |
HTTP Endpoint | Paste the URL received from Route Mobile. Ensure that the URL is in HTTPS format, that is, your URL must begin with https:// . |
Authentication | Under Authentication, select one of the following options: - No Authentication. - Basic Authentication: Enter the username and password. |
- Enter the following details under the Headers section.
Key | Value |
---|---|
Authorization | Bearer <API_KEY> |
Content-Type | application/json |

Set Headers
- Under Parameters, select
JSON
as the request type for the POST request.
Refer to the following sample payload below for the expected structure.
Sample Payload Structure (JSON):
Use the following sample JSON payload when configuring the Route Mobile provider in CleverTap. The payload represents the structure used to send an SMS message via Route Mobile. Replace placeholder variables with system dynamic replacements such as $$To
and $$Body
.
{
"username": "xxxx",
"password": "xxxx",
"source": "xxxx",
"destination": "$$To",
"message": "$$Body",
"entityid": "xxxx",
"tempid": "$$TemplateID",
"tagname": "$$CampaignID",
"msgid": "$$MessageID"
}
This structure ensures that message-specific data, such as recipient, sender, content, and a unique message ID are correctly passed to the Route Mobile API.

Provider Configuration
Note
$$MessageID
is required for accurate DLR (Delivery Report) tracking. Route Mobile must return the same ID in the delivery callback.
- Select the Batch option to upload multiple SMS records. Enter the required details for each record.
Single Batch Limit
A single batch can have a maximum of 1,000 records.
- 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 Route Mobile 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:
- Click the Send Test SMS hyperlink before creating SMS campaigns and journeys.
- Enter the following details:
- Country Code and Mobile Number: Enter the country code and mobile number to which you want to send the message.
- Message: Enter sample text, such as This is a test message powered by Route Mobile.

Send a Test SMS
- Click Send Test.
DLT Compliance Requirements for Messaging
- Domestic messages must exactly match DLT templates.
- International messages do not require DLT compliance.
If the configuration is correct, the test message will be delivered, and Route Mobile 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 Route Mobile team.
- You can find the Delivery report callback URL on the CleverTap dashboard under the Provider Setup page Settings > Channels > SMS > Provider Nickname.
- Share this URL with Route Mobile Support.

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 Route Mobile 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 Route Mobile as your SMS provider.
Updated about 5 hours ago