How to Use HTTP POST to Link Custom SMS Gateways in XpressBot

Integrating Custom SMS Gateways in XpressBot Using HTTP POST #

XpressBot provides a powerful and flexible way to integrate your own SMS gateway using the HTTP POST method. Whether you’re working with a local SMS provider, a regional gateway, or your internal SMS infrastructure, this method allows seamless message delivery and total control over your communication flow.

Why Use a Custom SMS Gateway in XpressBot? #

Using a custom SMS gateway allows you to:

• Leverage local or regional SMS providers not pre-listed in XpressBot.
• Reduce costs by integrating in-house SMS servers or open-source gateways.
• Ensure compliance with country-specific telecom regulations.
• Customize delivery parameters and manage message routing independently.
• Achieve greater delivery accuracy with gateways optimized for your region.

Use Case Scenarios #

This integration is ideal for:

• Businesses that already use custom or self-hosted SMS solutions.
• Organizations needing local language or regional message delivery.
• Enterprises requiring advanced logging, reporting, or failover control.
• Companies prioritizing data privacy by keeping SMS operations internal.

Steps to Integrate a Custom SMS Gateway in XpressBot via HTTP POST #

Step 1: Access SMS Integration Settings #

• Go to your XpressBot dashboard.
• Click on Settings from the left-hand sidebar.
• Under the Integrations section, select SMS.
• Click on the “New” button at the top of the SMS Profiles list to start adding your custom gateway.

step 2: Select HTTP POST as Integration Type #

Once you’ve clicked “New” under the SMS Profiles section:

1. A modal window will open to create your SMS configuration.
2. From the Integration Type options on the right, select “HTTP POST”.
3. Give your integration an easy-to-remember API Name (e.g., MyCustomSMS, RegionalGateway2025).
4. Enter the Base URL of your SMS provider’s API — this is where XpressBot will send the POST requests. Example Base URLs:
   • https://api.mysmsgateway.com/send
   • https://sms.yourcompany.in/api/v1/message

Step 3: Set HTTP POST Parameters #

Now you’ll define the POST fields your SMS gateway needs to send messages.

Add Each Parameter Manually: #

Click “+ Add New Parameter” and enter the following details:

Field	Description	Example
Key	The name of the parameter expected by your SMS API	api_key, to, text
Type	– Fixed: for static values (like API key) – To: recipient number – Message: SMS text	Fixed, To, Message
Value	Only needed for Fixed types (e.g., your actual API key)	ABC123XYZ, leave blank for dynamic ones

Example Configuration #

Key	Type	Value
api_key	Fixed	ABC123XYZ
to	To	(auto-filled)
message	Message	(auto-filled)

Continue adding all required keys exactly as mentioned in your SMS provider’s documentation.

Step 4: Test the Integration #

Once all parameters are added:

• Click the “Test Response” button.
• Enter a test number and message to verify if your configuration is working.
• If successful, you’ll receive a confirmation or response code from your provider.

tep 4: Save and Activate Your Custom Gateway #

After completing all parameter configurations and testing the connection:

1. Click the “Save” button at the bottom of the modal window.
2. Your custom SMS gateway profile will now appear in the SMS Profiles list.
3. This profile is now ready to use in various features within XpressBot, including:
   • Automated SMS Campaigns & Broadcasts
   • OTP or Verification Message Flows
   • Bot-triggered SMS alerts or reminders

You can create multiple SMS profiles for different providers or regions and switch between them based on your campaign needs.

Conclusion #

Integrating a custom SMS gateway in XpressBot using the HTTP POST method offers a flexible and powerful way to manage your SMS communications. Whether you’re working with a local provider, a regional SMS service, or an in-house gateway, this method ensures full control over your delivery process.

By following the step-by-step setup — from defining the API endpoint and parameters to testing and activating the profile — you can seamlessly plug in any SMS provider that supports HTTP POST.

This approach empowers businesses to:

• Reduce costs,
• Stay compliant with regional regulations,
• Improve delivery accuracy,
• And tailor SMS flows to their unique requirements.

Start leveraging your own SMS infrastructure today — and make XpressBot work exactly how your business needs it.