# Configure SMS Gateway

The Configure SMS Gateway section is used to configure SMS delivery services for the platform.

The module contains the following configuration types:

* **Global Configuration**
* **Customer Specific Configuration**

## **Global Configuration**

Global Configuration defines **system-wide SMS** gateway settings that apply across the platform. Administrators can configure:

* SMS provider details
* Authentication parameters
* Request headers
* Query parameters
* SMS delivery methods
* SMPP settings

The configuration process contains two steps:

* Configuration
* Test

### **SMS Gateway Configuration**

Select SMS Gateway in the **SMS Config Type** field to configure API or HTTP-based SMS delivery services.

This configuration type is generally used for third-party SMS providers that support REST APIs or URL-based SMS requests.

Follow the table below for more details.

**Configuration Details |** SMS Gateway

<table><thead><tr><th width="182.5999755859375">Label</th><th width="186.7999267578125">Action</th><th>Description / Example</th></tr></thead><tbody><tr><td><strong>SMS Config Type</strong></td><td>Select SMS Gateway</td><td>Defines the SMS integration method using API-based or HTTP-based SMS gateway providers.<br><br>This option is commonly used for providers such as Fast2SMS, MSG91, TextLocal, and similar SMS services.</td></tr><tr><td><strong>Title</strong></td><td>Enter Title</td><td>Specify a unique name for the SMS gateway configuration for easy identification and management.<br><br><strong>Example:</strong> SMS Gateway Demo</td></tr><tr><td><strong>URL</strong></td><td>Enter URL</td><td>Specify the SMS provider's API endpoint URL for sending SMS requests from the platform.<br><br><strong>Example:</strong> www.fast2sms.com/dev/bulkV2</td></tr><tr><td><strong>Add Country Code</strong></td><td>Enable/Disable Toggle</td><td>Automatically appends the configured country code to recipient mobile numbers before sending SMS messages.</td></tr><tr><td><strong>Use GET Request</strong></td><td>Enable/Disable Toggle</td><td>Sends the SMS request using the <strong>HTTP GET</strong> method instead of the default <strong>POST method,</strong> depending on the provider API requirement.</td></tr><tr><td><strong>Use HTTPS</strong></td><td>Enable/Disable Toggle</td><td>Enables secure HTTPS communication for encrypted SMS API requests and secure data transmission.</td></tr><tr><td><strong>Status Code</strong></td><td>Enter Status Code</td><td>Specify the expected success response code returned by the SMS provider after successful SMS submission.<br><br><strong>Example:</strong> 200</td></tr><tr><td><strong>Send SMS Individually</strong></td><td>Enable/Disable Toggle</td><td>Sends SMS messages separately to each recipient instead of processing all recipients in a single bulk request. Useful for providers requiring individual message delivery.</td></tr></tbody></table>

![](/files/316331dc1cbcde03522477d2c450b9ccf9e7e99c)

#### **Request Parameters**

Configure request parameters required by the SMS provider API for authentication, recipient details, message content, routing, and other delivery settings.

<table><thead><tr><th width="199.4000244140625">Label</th><th width="197.199951171875">Action</th><th>Description/ Example</th></tr></thead><tbody><tr><td><strong>Key</strong></td><td>Enter Key</td><td>Specify the parameter name required by the SMS provider API.<br><br><strong>Example:</strong> numbers, message, authorization, route, Content-Type</td></tr><tr><td><strong>Value</strong></td><td>Enter Value</td><td>Specify the parameter value or dynamic system variable used during SMS processing.<br><br><strong>Example:</strong> gateway_sms_recipients, gateway_sms_message, API tokens, route values, or content types.</td></tr><tr><td><strong>Pass To Header</strong></td><td>Enable/Disable Toggle</td><td>Sends the configured parameter in the API request header. Typically used for authorization tokens, API keys, or content-type configurations.</td></tr><tr><td><strong>Pass to query params</strong></td><td>Enable/Disable Toggle</td><td>Sends the configured parameter as a URL query parameter in the SMS API request.</td></tr><tr><td><strong>Add</strong></td><td>Click Add</td><td>Adds a new request parameter row to configure additional API fields required by the SMS provider.</td></tr><tr><td><strong>Delete</strong></td><td>Click the Delete Icon</td><td>Removes the selected request parameter from the SMS gateway configuration.</td></tr></tbody></table>

<figure><img src="/files/dce8b631496881ccc31eb6c4ecd6b56ab904512a" alt=""><figcaption></figcaption></figure>

### **SMPP Gateway Configuration**

Select SMPP Gateway in the SMS Config Type field to configure SMPP protocol-based SMS communication.

This configuration type is generally used for enterprise-grade SMS delivery and telecom provider integrations supporting SMPP connectivity.

Follow the table below for more details.

<table><thead><tr><th width="211.39996337890625">Label</th><th width="171.2000732421875">Action</th><th>Description / Example</th></tr></thead><tbody><tr><td><strong>SMS Config Type</strong></td><td>Select SMPP Gateway</td><td>Defines the SMS integration method using SMPP protocol communication for enterprise or telecom-based SMS delivery services.</td></tr><tr><td><strong>Title</strong></td><td>Enter Title</td><td>Specify a unique name for the SMPP gateway configuration for identification and management purposes.<br><br><strong>Example:</strong> SMPP Gateway Demo</td></tr><tr><td><strong>SMPP Hostname</strong></td><td>Enter Hostname</td><td>Specify the hostname or server address provided by the SMPP service provider for establishing SMS communication.<br><br><strong>Example:</strong> mail.domain.extn</td></tr><tr><td><strong>SMPP Host Username</strong></td><td>Enter Username</td><td>Specify the username provided by the SMPP gateway provider for authentication and connection establishment.</td></tr><tr><td><strong>SMPP Host Password</strong></td><td>Enter Password</td><td>Specify the password associated with the SMPP account used for secure authentication.</td></tr><tr><td><strong>SMPP System ID</strong></td><td>Enter System ID</td><td>Specify the SMPP System ID provided by the SMS vendor or telecom provider for gateway identification.</td></tr><tr><td><strong>SMPP Host Port</strong></td><td>Enter Port</td><td>Specify the communication port number used for SMPP connectivity between the platform and the SMS provider.<br><br><strong>Example:</strong> 443</td></tr></tbody></table>

#### **DLT Parameters**

Configure DLT **(Distributed Ledger Technology)** parameters required for telecom regulatory compliance and SMS delivery validation in supported regions.

<table><thead><tr><th width="102.5999755859375">Label</th><th width="170.00006103515625">Action</th><th>Description/ Example</th></tr></thead><tbody><tr><td><strong>Key</strong></td><td>Enter Key</td><td>Specify the DLT parameter key required by the provider.<br><br>Example: PE_ID, Template_ID</td></tr><tr><td><strong>Value</strong></td><td>Enter Value</td><td>Specify the corresponding DLT parameter value provided by the SMS gateway or telecom operator.</td></tr><tr><td><strong>Add</strong></td><td>Click Add</td><td>Adds additional DLT parameter fields for configuring multiple regulatory or provider-specific parameters.</td></tr><tr><td><strong>Delete</strong></td><td>Click the Delete Icon</td><td>Removes the configured DLT parameter from the SMPP gateway configuration.</td></tr></tbody></table>

{% hint style="info" %}
Enable the **Secondary SMS/SMPP Gateway** option to configure an additional gateway that can be used as a **backup or failover** mechanism when the Primary Gateway is unavailable or fails to deliver messages.
{% endhint %}

* Once added, click on **Submit** to save the SMS gateway configuration details configured for the selected SMS provider.
* Click on **Test & Save** to validate the configured SMS gateway settings by sending a test request and saving the configuration after successful verification.

![](/files/c8ee17553e15a5fea54da2929cf82ac9c9a74e82)

## **Test Configuration**

After adding the SMS configuration details, users can move to the Test section to validate SMS delivery before saving the configuration.

The Test section helps administrators verify:

* Gateway connectivity,
* Message delivery,
* Request parameter configuration,
* And the SMS provider response.

Follow the table below for more details.

<table><thead><tr><th width="165">Label</th><th width="191.79998779296875">Action</th><th>Description / Example</th></tr></thead><tbody><tr><td><strong>Phone Number</strong></td><td>Enter Phone Number</td><td>Specify the recipient mobile number to which the test SMS should be sent to validate the configured SMS gateway.<br><br><strong>Example:</strong> 91XXXXXXXX90</td></tr><tr><td><strong>Message</strong></td><td>Enter Message</td><td>Specify a sample SMS content to verify message delivery and SMS gateway functionality.<br><br><strong>Example:</strong> Test SMS from Infraon Infinity</td></tr><tr><td><strong>Primary</strong></td><td>Click Primary</td><td>Tests the SMS delivery using the Primary SMS Gateway configuration configured in the module.</td></tr><tr><td><strong>Secondary</strong></td><td>Click Secondary</td><td>Tests the SMS delivery using the Secondary SMS Gateway configuration when secondary gateway settings are enabled.</td></tr></tbody></table>

{% hint style="info" %}
Click **Test** to send a test SMS request and validate the configured gateway settings, request parameters, authentication details, and the SMS provider's response.
{% endhint %}

![](/files/16bb472c4c7448a93041fead76efa061b5461cfb)

Click on **Save** to save the SMS gateway configuration after successful testing and validation of the configured settings.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infraon.io/infraon-help/infinity-user-guide/infraon-configuration/notifications/configure-sms/configure-sms-gateway.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.