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
SMS Config Type
Select SMS Gateway
Defines the SMS integration method using API-based or HTTP-based SMS gateway providers. This option is commonly used for providers such as Fast2SMS, MSG91, TextLocal, and similar SMS services.
Title
Enter Title
Specify a unique name for the SMS gateway configuration for easy identification and management. Example: SMS Gateway Demo
URL
Enter URL
Specify the SMS provider's API endpoint URL for sending SMS requests from the platform. Example: www.fast2sms.com/dev/bulkV2
Add Country Code
Enable/Disable Toggle
Automatically appends the configured country code to recipient mobile numbers before sending SMS messages.
Use GET Request
Enable/Disable Toggle
Sends the SMS request using the HTTP GET method instead of the default POST method, depending on the provider API requirement.
Use HTTPS
Enable/Disable Toggle
Enables secure HTTPS communication for encrypted SMS API requests and secure data transmission.
Status Code
Enter Status Code
Specify the expected success response code returned by the SMS provider after successful SMS submission. Example: 200
Send SMS Individually
Enable/Disable Toggle
Sends SMS messages separately to each recipient instead of processing all recipients in a single bulk request. Useful for providers requiring individual message delivery.
Request Parameters
Configure request parameters required by the SMS provider API for authentication, recipient details, message content, routing, and other delivery settings.
Key
Enter Key
Specify the parameter name required by the SMS provider API. Example: numbers, message, authorization, route, Content-Type
Value
Enter Value
Specify the parameter value or dynamic system variable used during SMS processing. Example: gateway_sms_recipients, gateway_sms_message, API tokens, route values, or content types.
Pass To Header
Enable/Disable Toggle
Sends the configured parameter in the API request header. Typically used for authorization tokens, API keys, or content-type configurations.
Pass to query params
Enable/Disable Toggle
Sends the configured parameter as a URL query parameter in the SMS API request.
Add
Click Add
Adds a new request parameter row to configure additional API fields required by the SMS provider.
Delete
Click the Delete Icon
Removes the selected request parameter from the SMS gateway configuration.
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.
SMS Config Type
Select SMPP Gateway
Defines the SMS integration method using SMPP protocol communication for enterprise or telecom-based SMS delivery services.
Title
Enter Title
Specify a unique name for the SMPP gateway configuration for identification and management purposes. Example: SMPP Gateway Demo
SMPP Hostname
Enter Hostname
Specify the hostname or server address provided by the SMPP service provider for establishing SMS communication. Example: mail.domain.extn
SMPP Host Username
Enter Username
Specify the username provided by the SMPP gateway provider for authentication and connection establishment.
SMPP Host Password
Enter Password
Specify the password associated with the SMPP account used for secure authentication.
SMPP System ID
Enter System ID
Specify the SMPP System ID provided by the SMS vendor or telecom provider for gateway identification.
SMPP Host Port
Enter Port
Specify the communication port number used for SMPP connectivity between the platform and the SMS provider. Example: 443
DLT Parameters
Configure DLT (Distributed Ledger Technology) parameters required for telecom regulatory compliance and SMS delivery validation in supported regions.
Key
Enter Key
Specify the DLT parameter key required by the provider. Example: PE_ID, Template_ID
Value
Enter Value
Specify the corresponding DLT parameter value provided by the SMS gateway or telecom operator.
Add
Click Add
Adds additional DLT parameter fields for configuring multiple regulatory or provider-specific parameters.
Delete
Click the Delete Icon
Removes the configured DLT parameter from the SMPP gateway configuration.
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.
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.
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.
Phone Number
Enter Phone Number
Specify the recipient mobile number to which the test SMS should be sent to validate the configured SMS gateway. Example: 91XXXXXXXX90
Message
Enter Message
Specify a sample SMS content to verify message delivery and SMS gateway functionality. Example: Test SMS from Infraon Infinity
Primary
Click Primary
Tests the SMS delivery using the Primary SMS Gateway configuration configured in the module.
Secondary
Click Secondary
Tests the SMS delivery using the Secondary SMS Gateway configuration when secondary gateway settings are enabled.
Click Test to send a test SMS request and validate the configured gateway settings, request parameters, authentication details, and the SMS provider's response.
Click on Save to save the SMS gateway configuration after successful testing and validation of the configured settings.
Last updated
Was this helpful?