> For the complete documentation index, see [llms.txt](https://docs.infraon.io/infraon-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infraon.io/infraon-help/infinity-user-guide/infraon-configuration/notifications/configure-sms/configure-sms-gateway.md).

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