Custom Gateway Setup
Configure a custom SMS gateway for providers not natively supported.
WSMS allows you to integrate SMS providers that aren’t included in the default gateway library using the Custom Gateway feature.
Step 1: Select Custom Gateway
- Go to SMS → Settings → SMS Gateway
- Select Custom Gateway from the dropdown menu
Step 2: Configure API Endpoint
Enter your SMS provider’s API endpoint URL. This is the server address where SMS requests will be sent.
Step 3: Set HTTP Headers
Add the required headers for your API. Common headers include:
Content-Type: application/json;charset=UTF-8
Authorization: Bearer YOUR_API_TOKEN
Step 4: Configure Parameters
Define the parameters your API expects as key-value pairs:
| Parameter | Description |
|---|---|
from:{from} | Sender ID or phone number |
to:{to} | Recipient phone number |
message:{message} | SMS content |
Use the placeholders {from}, {to}, and {message} which WSMS will replace with actual values.
Step 5: Request Settings
| Setting | Description |
|---|---|
| Send As POST | Enable if your API requires parameters in the request body. Disable to append parameters to the URL (GET request) |
| Encode Message | Enable to URL-encode the SMS content for compatibility |
Step 6: Save and Test
- Click Save Changes
- Go to SMS → Send SMS
- Send a test message to verify the configuration
Use Cases
- Regional SMS providers not in the default list
- Private or enterprise SMS gateways
- Custom API integrations
Related
- Gateway Configuration - Standard gateway setup
Last updated: December 26, 2024