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 Integration

This 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:

  1. Find your API credentials
  2. Set Up CleverTap Dashboard
  3. Send Test SMS

Find FirstConnectt API Credentials

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

CredentialDescriptionWhere to Find
Endpoint URLThe API endpoint for FirstConnecttFixed value: https://connecttone.io/api/v1/sms/clevertap
API KeyUsed in the Authorization request headerProfile Settings in your FirstConnectt Customer Portal
Sender ID (SID)The sender ID linked to your accountProvided 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:

  1. Go to Settings > Channels > SMS in the CleverTap dashboard.
  2. Click + Add Provider. The Add SMS provider page opens.
  3. Under Provider, select Other (Generic) and enter the following details:
FieldDescription
NicknameEnter a unique name for this provider. For example: FirstConnectt SMS.
Callback URLContact your FirstConnectt point of contact to obtain the callback URL and configure it on the FirstConnectt platform to receive SMS delivery status updates.
Request TypeSelect POST as the HTTP method.
HTTP EndpointEnter the FirstConnectt API endpoint: https://connecttone.io/api/v1/sms/clevertap
The provider configuration section in the SMS Channel section

Provider Configuration in SMS Channel

  1. Under the Headers section, enter the following key-value pairs:
KeyValue
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

Replace <API_KEY> with the API key from your FirstConnectt Customer Portal.

The Headers tab in the Providers Configuration section

Headers Tab in the Providers Configuration section

  1. 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"
    }
  ]
}
📘

Note

CleverTap replaces $$Body, $$To, $$TemplateID, and $$MessageID dynamically at send time with the actual message content, recipient number, template ID, and a unique message identifier. $$MessageID is 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.

  1. Select the Batch option to send multiple SMS records in a single request. A single batch supports a maximum of 1,000 records.
  2. Click Save. A prompt appears to send a test SMS.
The Parameters tab in the Providers Configuration section

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:

  1. Click the Send Test SMS link after saving your provider configuration.
  2. Enter the following details:
ValueDescription
Country CodeExtension Code of the Country
Mobile numberThe mobile number of the User
Template IDUnique ID for the template
MessageA custom message seen by the user
  1. Click Send Test.
The test-SMS pop-up in the SMS Configuration section

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:

  1. Go to Settings > Channels > SMS in the CleverTap dashboard.
  2. Open your FirstConnectt provider by clicking its nickname.
  3. Copy the Delivery Report Callback URL from the Provider Setup page.
The provider configuration section in the SMS Channel section

Provider Configuration in SMS Channel

  1. 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.


Did this page help you?
CleverTap Ask AI Widget (CSP-Safe)