FirstConnectt
SMS Provider
Overview
FirstConnectt is a Communications Platform as a Service (CPaaS) provider that enables businesses to engage customers across multiple channels. When integrated with CleverTap, FirstConnectt delivers transactional and promotional SMS messages directly from the CleverTap dashboard, with full DLR (Delivery Receipt) tracking for visibility into campaign performance and delivery status.
Here are a few use cases where businesses can integrate FirstConnectt 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.
Support for IntegrationThis integration is managed and supported by FirstConnectt. For any questions or issues related to this integration, contact FirstConnectt support.
Prerequisites for Integration
Before integrating FirstConnectt with CleverTap, ensure the following are in place:
- An active CleverTap account with SMS channels enabled.
- A FirstConnectt account with the following credentials, provided by your FirstConnectt point of contact:
- Username and password
- Sender ID
- DLT credentials (required for accounts registered in India)
- DLT compliance for your FirstConnectt account, if you are registered in India.
Integrate FirstConnectt with CleverTap
Integrating FirstConnectt with CleverTap involves the following three steps:
Find FirstConnectt API Credentials
To complete the setup, gather the following details from your FirstConnectt account or FirstConnectt support:
| Credential | Description | Where to Find |
|---|---|---|
| Endpoint URL | The API endpoint for FirstConnectt | Fixed value: https://connecttone.io/api/v1/sms/clevertap |
| API Key | Used in the Authorization request header | Profile Settings in your FirstConnectt Customer Portal |
| Sender ID (SID) | The sender ID linked to your account | Provided by your FirstConnectt point of contact |
Set Up CleverTap Dashboard
Configuring the CleverTap dashboard connects and authenticates your FirstConnectt SMS provider using the Generic SMS provider option. To set up your CleverTap dashboard, perform the following steps:
- Go to Settings > Channels > SMS in the CleverTap dashboard.
- Click + Add Provider. The Add SMS provider page opens.
- Under Provider, select Other (Generic) and enter the following details:
| Field | Description |
|---|---|
| Nickname | Enter a unique name for this provider. For example: FirstConnectt SMS. |
| Callback URL | Contact your FirstConnectt point of contact to obtain the callback URL and configure it on the FirstConnectt platform to receive SMS delivery status updates. |
| Request Type | Select POST as the HTTP method. |
| HTTP Endpoint | Enter the FirstConnectt API endpoint: https://connecttone.io/api/v1/sms/clevertap |

Provider Configuration in SMS Channel
- Under the Headers section, enter the following key-value pairs:
| Key | Value |
|---|---|
Authorization | Bearer <API_KEY> |
Content-Type | application/json |
Replace <API_KEY> with the API key from your FirstConnectt Customer Portal.

Headers Tab in the Providers Configuration section
- Under Parameters, select JSON as the request type. Use the following sample payload:
{
"route": "Transactional",
"sender": "$$hid",
"tid": "$$TemplateID",
"msgs": [
{
"message": "$$Body",
"mobile": "$$To",
"msg_id": "$$MessageID"
}
]
}
NoteCleverTap replaces
$$Body,$$To,$$TemplateID, and$$MessageIDdynamically at send time with the actual message content, recipient number, template ID, and a unique message identifier.$$MessageIDis required for accurate DLR (Delivery Report) tracking: FirstConnectt must return the same ID in the delivery callback for CleverTap to match and record the delivery status.
- Select the Batch option to send multiple SMS records in a single request. A single batch supports a maximum of 1,000 records.
- Click Save. A prompt appears to send a test SMS.

Parameters Tab in the Providers Configuration section
Send Test SMS
Sending a test SMS confirms that the FirstConnectt integration is working before you launch a live campaign. To do so, perform the following steps:
- Click the Send Test SMS link after saving your provider configuration.
- Enter the following details:
| Value | Description |
|---|---|
| Country Code | Extension Code of the Country |
| Mobile number | The mobile number of the User |
| Template ID | Unique ID for the template |
| Message | A custom message seen by the user |
- Click Send Test.

Test SMS Pop-Up
If the configuration is correct, the test message is delivered, and FirstConnectt returns a DLR update. If an error occurs, for example, due to incorrect credentials or an invalid endpoint, CleverTap displays a failure notification.
Set Up SMS Callbacks
Setting up SMS callbacks enables CleverTap to receive delivery status updates from FirstConnectt for accurate campaign reporting. To do so, perform the following steps:
- Go to Settings > Channels > SMS in the CleverTap dashboard.
- Open your FirstConnectt provider by clicking its nickname.
- Copy the Delivery Report Callback URL from the Provider Setup page.

Provider Configuration in SMS Channel
- Share this URL with FirstConnectt support so they can configure it on the FirstConnectt platform.
Verify Successful Integration
Your integration is successful when all three of the following criteria are met:
- The test SMS is delivered to the intended mobile number.
- You receive a DLR callback from FirstConnectt 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 SMS campaigns or set up Journeys using FirstConnectt as your SMS provider.
Create Campaign
For detailed instructions on creating an SMS campaign with FirstConnectt as your provider, refer to Create SMS Campaign.
Create Journey
For detailed instructions on creating an SMS journey using FirstConnectt as your provider, refer to Journeys.
Updated about 6 hours ago
