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

  1. Go to SMS → Settings → SMS Gateway
  2. 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:

ParameterDescription
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

SettingDescription
Send As POSTEnable if your API requires parameters in the request body. Disable to append parameters to the URL (GET request)
Encode MessageEnable to URL-encode the SMS content for compatibility

Step 6: Save and Test

  1. Click Save Changes
  2. Go to SMS → Send SMS
  3. 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

Last updated: December 26, 2024