Onextel is a leading CPaaS (Communication Platform as a Service) provider that offers seamless, end to end communication solutions. Our product offering includes channels like SMS, Voice, Whatsapp, Chatbot, RCS, EMail services tailored for businesses of all sizes.
Configure Onextel as a Custom SMS Connector (Service Provider) #
To configure Onextel Connector on MoEngage, follow these steps:
Prerequisites :
1. You should have an active Onextel Aura account with associated API key(s).
2. Make sure the Entity ID and Sender Id(s) are added in the Onextel account.
Note: Kindly disable DND scrubbing while creating the API key to ensure complete submission from the connector to Onextel platform.
Note : To create a new account or incase of any queries and concerns related to Onextel account, kindly reach out to Onextel Support team at support@onextel.com.
Recommended :
Add your DLT approved templates in Aura account using the bulk upload option.
- Navigate to Settings -> Channel -> SMS -> Sender Configuration.
- Click on Add Sender and go to “Add custom service provider”.
- Turn on the Mark as default 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.
- Enter Service provider name and Sender name. For example, Service provider name can be Onextel Transactional and Sender name should be the sender ID.
- Select Sender type as either 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.
- API URL field holds details about the URL needed to send an API request to the Sender. This information is provided in OneXtel’s API Documentation. Enter OneXtel’s API endpoint here:
GET API URL – https://api.onex-aura.com/api/sms
POST API URL – https://api.onex-aura.com/api/jsms
- (a) Configure the Webhook using GET as the HTTP Method: Refer to the table below and enter URL Parameters as per the requirements in OneXtel’s API key by clicking on +KV pair.
| Key | Value |
| key | Enter API Key |
| from | Enter Sender ID corresponding to the SMS type |
| to | Moesms_destination |
| body | Moesms_message |
| templateid | Moesms_dltTemplateId |
| entityid | Enter Entity ID |
Note – Headers section remains unchanged in this case.
(b) Configure the Webhook using POST as the HTTP Method: In this method, Body type can be selected as either JSON or Raw.
Note – URL Parameters section remains unchanged in this case. Under Headers section, Content-Type will be filled as application/json automatically as you enter OneXtel’s POST API URL.
Case 1 – Refer to the table below if entering Body type as JSON
| key | Enter API Key |
| from | Enter Sender ID corresponding to the SMS type |
| to | Moesms_destination |
| body | Moesms_message |
| templateid | Moesms_dltTemplateId |
| entityid | Enter Entity ID |
Case 2 – Refer to the JSON body below if entering Body type as Raw
{ "key":"Enter API Key",
"from":"Enter Sender ID corresponding to the SMS type",
"to":"Moesms_destination",
"body":"Moesms_message",
"templateid":"Moesms_dltTemplateId",
"entityid":"Enter Entity ID" }
- Click on Send Test SMS to enter Mobile Number and approved template content as Message. Hit Send to verify your configuration.
- Click Save. A “Settings updated successfully” pop-up will appear on the screen.
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.
Note – To configure Delivery Tracking, send a mail to OneXtel Support team at support@onextel.com sharing your API key and MoEngage’s SMS delivery tracking URL : https://api-01.moengage.com/sms/dlr/custom/xxxxx.
Sample response from Onextel for a successfully sent message
Sample response from Onextel for a delivered message
Mapping response fields
1. Manually
Enter details in the response mapping fields as shown below:
2. From delivery response
Choose fields from delivery response (refer to sample response screenshots above) to auto-populate the response mapping fields, as shown below.
Click Save to Save the delivery tracking configuration for the custom connector.