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

# OneXtel

# Introduction

OneXtel is a leading Communication Platform as a Service (CPaaS) provider that offers seamless, end-to-end communication solutions. Its offering includes channels such as SMS, Voice, WhatsApp, Chatbot, Rich Communication Services (RCS), and Email services tailored for businesses of all sizes.

<Info>
  * Ensure you have an active OneXtel Aura account with associated API key(s).
  * Ensure the Entity ID and Sender ID(s) are added to the OneXtel account.
  * It is recommended to add your DLT-approved templates to the Aura account using the bulk upload option.\
    **Note**: To create a new account or if you have any queries and concerns related to the OneXtel account, contact the OneXtel support team at [support@onextel.com](mailto:support@onextel.com).
</Info>

# Configure OneXtel as a Custom SMS Connector (Service Provider)

This article will help you configure OneXtel as a Custom Connector.

Log in to the MoEngage Dashboard and perform the following steps:

1. Navigate to **Settings** -> **Channel** -> **SMS** -> **Sender configuration**.
2. Click **+ Add Sender** at the top right corner. The Add sender page is displayed.
3. In step 1 "Service Provider", click **+ Add custom service provider**. The Add Custom Connector sender page is displayed.
4. Add the following details in step 2 "Sender Details":

| Field                 | Description                                                                                                                                                                                                                                                                                                                                                                                              |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mark as default       | Turn this toggle on to mark the sender as the default sender for the service provider being configured. If marked as default, this sender will be used to send 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. Enter “OneXtel”.                                                                                                                                                                                                                                                                          |
| Sender name           | This field identifies the readable sender name that can be used while creating a campaign or alert. For example, OneXtel SMS or Aura SMS.                                                                                                                                                                                                                                                                |
| Sender type           | Select the sender type. Available options are: <ul><li>**Transactional** : Select this option to use the sender to send alerts about transactions, OTPs, security information, or any information that can be classified as transactional in nature.</li><li>**Promotional** : Select this option to use the sender to send information about your brand, promote deals, or engage with users.</li></ul> |

5. Configure the Webhook by adding the following details:
   1. Using **GET** as the HTTP method:

| 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 Sender's API Documentation. Type the sender's API Endpoint here. The GET API URL for OneXtel is: <br />[https://api.onex-aura.com/api/sms](https://api.onex-aura.com/api/sms)                                               |
| **Method**         | Select **GET** as the HTTP method.                                                                                                                                                                                                                                                                                                                                        |
| **URL Parameters** | Add the URL Parameters to be passed to the API as Key-Value pairs using this option. <ul><li>key: Enter the API Key.</li><li>entityid: Enter the Entity ID.</li><li>from: Enter the Sender ID corresponding to the SMS type.</li><li>to: Enter "Moesms\_destination".</li><li>body: Enter "Moesms\_message".</li><li>templateid: Enter "Moesms\_dltTemplateId".</li></ul> |
| **Headers**        | The Headers section remains unchanged in this case.                                                                                                                                                                                                                                                                                                                       |

2. Using **POST** as the HTTP method:
   | 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 Sender's API Documentation. Type the sender's API Endpoint here. The POST API URL for OneXtel is: [https://api.onex-aura.com/api/jsms](https://api.onex-aura.com/api/jsms) |
   | Method         | Select POST as the HTTP method.                                                                                                                                                                                                                                                                                          |
   | URL parameters | The URL parameters section remains unchanged in this case.                                                                                                                                                                                                                                                               |
   | Headers        | Content-Type will be filled as application/json automatically as you enter the POST API URL of OneXtel.                                                                                                                                                                                                                  |
   | Body type      | Select the body type as either **JSON** or **Raw**.                                                                                                                                                                                                                                                                      |

Refer to the following table if you select the Body type as **JSON**:

| Key        | Value                                              |
| ---------- | -------------------------------------------------- |
| body       | Enter "Moesms\_message".                           |
| entityid   | Enter Entity ID.                                   |
| from       | Enter the Sender ID corresponding to the SMS type. |
| key        | Enter the API key.                                 |
| templateid | Enter "Moesms\_dltTemplateId".                     |
| to         | Enter "Moesms\_destination".                       |

Refer to the following JSON body if you select the Body type as **Raw**:

<CodeGroup>
  ```json JSON theme={null}
  {
      "key":"Enter API Key", 
      "body":"Moesms_message", 
      "to":"Moesms_destination", 
      "from":"Enter Sender ID corresponding to the SMS type", 
      "entityid":"Enter Entity ID", 
      "templateid":"Moesms_dltTemplateId" 
  }
  ```
</CodeGroup>

6. Click **Send test SMS** to verify your configuration.
7. Click **Save** to save the sender configuration.

# Create an SMS Campaign

1. On the MoEngage Dashboard, go to **Segment** > **Import Users** to add recipient details.
2. Once recipients are added, from the MoEngage Dashboard, click **Engage** > **Campaigns**. The All campaigns page is displayed.
3. Click **+ Create campaign**.
4. Under **Outbound**, click **SMS** and select the SMS Campaign type as One Time, Periodic, or Event Triggered based on your requirements. For more information about delivery types, refer to [Delivery Types](/docs/user-guide/campaigns-and-channels/getting-started/introduction/moengage-channels). The SMS creation page is displayed.
5. Enter the campaign name and select the target audience from your user list. Click **Next**.
6. Enter the DLT-approved template ID and message. A preview of the message will be displayed on the right side of the screen.
7. It is highly recommended that the campaign is tested before making it live. In the Test Campaign section, add a phone number and click **Test**. Click **Next**.
8. Under the **Send campaign** section:
   1. To send immediately, select **As soon as possible**.
   2. To send at a preferred date and time, select **At specific date and time** and set start date and send time.
9. Click **Publish**.

# Delivery Tracking

You can configure delivery tracking after creating the sender in the MoEngage Dashboard. For information about Delivery Tracking, refer to [Delivery Tracking in Custom Connectors](/docs/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-custom-connector-for-sms).

<Info>
  To configure Delivery Tracking, send an email to the OneXtel Support team at [support@onextel.com](mailto:support@onextel.com) sharing your API key and the SMS delivery tracking URL of MoEngage: [https://api-01.moengage.com/sms/dlr/custom/1598820387](https://api-01.moengage.com/sms/dlr/custom/1598820387).
</Info>

## Sample Response from OneXtel

### For a Successfully Sent Message

<Frame>
  <img src="https://mintcdn.com/moengage/7RtT_ikLFfH0sLR_/images/sms-sent-response.png?fit=max&auto=format&n=7RtT_ikLFfH0sLR_&q=85&s=9f9c918ea5010f050b87bea113357f78" alt="Sms Sent Response" width="1192" height="398" data-path="images/sms-sent-response.png" />
</Frame>

### For a Delivered Message

<Frame>
  <img src="https://mintcdn.com/moengage/7RtT_ikLFfH0sLR_/images/sms-delivery-response.png?fit=max&auto=format&n=7RtT_ikLFfH0sLR_&q=85&s=c06f5ef17573c361ab9be0b41b2038e8" alt="Sms Delivery Response" width="1146" height="454" data-path="images/sms-delivery-response.png" />
</Frame>

## Mapping Delivery Response

Select the fields from the Delivery Response to auto-populate the response mapping fields, as shown below:

<Frame>
  <img src="https://mintcdn.com/moengage/Wf9uoFrhUQOFSAMK/images/id-field.png?fit=max&auto=format&n=Wf9uoFrhUQOFSAMK&q=85&s=3394c30a77a087d57c89f07dc39bc51b" alt="Id Field" width="1322" height="576" data-path="images/id-field.png" />
</Frame>

Click **Save** to save the delivery tracking configuration for the custom connector.
