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

# telSpiel

# Introduction

telSpiel offers enterprise communication services including SMS, WhatsApp Business Messaging, RCS, Voice & Email. With the MoEngage and telSpiel SMS Integration, you can communicate with your end users for the following:

* Bulk SMS communication of different categories – Promotional, Service Implicit, and Service explicit.
* Real-Time Delivery updates

In addition, you can also automate sales and marketing engagements by sending personalized texts through a secure SMS Platform.

# Integration

<Info>
  **Prerequisites**

  * You must have an SMS account with the respective SMS Push API details from telSpiel.
  * You must have DLT-approved details, i.e., templates, if the region of your account is in India.
</Info>

To configure telSpiel as a Custom SMS Connector, perform the following steps:

1. On the MoEngage dashboard, navigate to **Settings** > **Channel** > **SMS**.
2. On the **SMS** tab, click **Add SMS Sender**. <img src="https://mintcdn.com/moengage/7JhYx0SFgvEG_Jfv/images/partner_37447253166868.png?fit=max&auto=format&n=7JhYx0SFgvEG_Jfv&q=85&s=ec7fece6ab32d3c637dcbbad1327960d" alt="2025-05-13_16-47-31.png" width="3330" height="1454" data-path="images/partner_37447253166868.png" />
3. Click **Add custom service provider**. <img src="https://mintcdn.com/moengage/7JhYx0SFgvEG_Jfv/images/partner_37447212121620.png?fit=max&auto=format&n=7JhYx0SFgvEG_Jfv&q=85&s=7c197e8ab7a643045cc6f848734bec17" alt="2025-05-13_16-53-30.png" width="3350" height="1258" data-path="images/partner_37447212121620.png" />
4. Add the following details in the **Sender Details** screen:

| Field                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sender Type**       | Select Sender Type - <br />Promotional/Transactional based on SMS account at telSpiel.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Connector Name**    | Enter the Connector Name for the SMS Connector to uniquely identify it. Example: "telSpiel"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Sender Name**       | Enter Sender Name (DLT Approved Header)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **API URL**           | Select the GET or POST option depending on which HTTP Endpoint you have from telSpiel. <br />Now Enter the telSpiel SMS Push Endpoint (GET/POST) with respective credentials/details:<br /><br />GET API: Endpoint for Single API request: <br />`https://api.telsp.in/pushapi/sendmsg?username=xxxxxx&dest=xxxxxxx&apikey=xxxxx&signature=SENDERID&msgtype=TypeofMessage&msgtxt=template&entityid=entityIdvalue&templateid=templateIDvalue&custref=uniquereferenceid&hashId=dltChainvalue`<br />Endpoint for Multiple API request:<br />`https://api.telsp.in/pushapi/sendbulkmsg?username=xxxxxx&dest=xxxxxxx,xxxxxxx&apikey=xxxxx&signature=SENDERID&msgtype=TypeofMessage&msgtxt=template&entityid=entityIdvalue&templateid=templateIDvalue&custref=uniquereferenceid&hashId=dltChainvalue` <br />Key-value pair: Enter your keys and values. POST API: Endpoint for Single API request:<br />`https://api.telsp.in/pushapi/json/sendmsg`<br />Endpoint for Multiple API request:<br />`https://api.telsp.in/pushapi/json/sendBulkMsg`<br />Enter the JSON payload structure supported by the POST Endpoint. |
| **Parameter Details** | Key value pair / Json Parameter details: <ul><li>`username=<******>` \[telSpiel api username]</li><li>`dest= Moesms_message` \[Mobile no. on which SMS to be sent]</li><li>`apikey= User account Authentication key` provided by telSpiel</li><li>`signature=DLT approved Header/Sender`</li><li>`msgtype=Type of message` (PM for plain text or UC for Unicode message/multilingual message)</li><li>`msgtxt= Moesms_destination` \[DLT approved message text]</li><li>`entityid=DLT Entity ID Value`</li><li>`templateid=Template ID Value` \[DLT template id against approved template]</li><li>`custref=Reference unique ID` (optional)</li><li>`hashId=Dlt chain Value` (optional)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Headers**           | For POST Endpoint, please enter below key-value pairs:<br />Key: `Content-Type` \| Value: `application/json`<br />Key: `Accept` \| Value: `application/json`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Delivery tracking     | For Delivery tracking, after saving the “Custom Connector” edit it. Now select the option “Map fields manually” and do the below mapping: <ul><li>Unique sent ID field: `uuid`</li><li>Unique delivery ID field \*: `uuid`</li><li>Delivery status field \*: `status`</li><li>Success values for delivery status \*: `DELIVERY_SUCCESS`</li><li>Failure reason field \*: `description`</li></ul> Please share SMS delivery tracking URL with telSpiel for configuration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

5. **Body Type** (Only for POST), select “Raw” and enter the entire JSON payload structure:
   * For Single request:
     <CodeGroup>
       ```json JSON theme={null}
       {
         "username":"xxxxxx",
         "apikey":"xxxxxxxxxxx",
         "msgtype":"TypeofMessage",
         "msgtext":"Template",
         "signature":"SenderID",
         "entity":"EntityIDValue",
         "templateid":"TemplateIDValue",
         "tag":"CampaignNameGivenByUser”,     //OPTIONAL
         "custref":"Uniquereferenceid”,       //OPTIONAL 
         "hashId":"DltChainvalue",          //OPTIONAL
         "dest": ["xxxxxxxxx"]
       }
       ```
     </CodeGroup>
   * For Multiple request:
     <CodeGroup>
       ```json JSON theme={null}
       {
         "username":"xxxxxx",
         "apikey":"xxxxxxxxx",
         "entity": "xxxxxxxx",
         "msgtype": ["xx","xx"],
         "signature": ["xxxxx","xxxxx"],
         "msgtext": ["Template1","Template2"],
         "templateid": ["TemplateIdValue1","TemplateIdValue2"],
         "tag": "CampaignNameGivenByUser",       //OPTIONAL
         "hashId":"DltChainvalue",              //OPTIONAL
         "custref":"Uniquereferenceid",       //OPTIONAL
         "dest": ["xxxxxxxx","xxxxxxxxx"]
       }
       ```
     </CodeGroup>
6. Click **Save**.

# Troubleshooting

If any issue occurs while sending a test message or saving the configuration, follow the steps below:

* Ensure that the telSpiel Endpoint and respective parameters/JSON structure are added correctly, as they are case-sensitive.
* If the issue persists, raise a Support Request to MoEngage to get your error code.
* Connect with the telSpiel support team to get the issue resolved after you receive the error code from the MoEngage Support team. Support Email: [*care@telspiel.com*](mailto:care@telspiel.com).