Skip to content
Platform Documentation

SMS Gateways

In order to enable SMS and MMS services you have to configure these services at your service provider and in Configuration Manager.

SMS Gateways section allows you to configure SMS Gateways, your connections with SMS providers, that allow you to send and receive SMS messages.

You will also need to specify which DIDs/Phone Numbers are SMS enabled, and configure Inbound Messaging Routes so that inbound messages are delivered to users or queues.

Create/Edit SMS Gateway

Name. Unique alphanumeric name for the SMS Gateway (no spaces or special characters are allowed).

Provider. Name of the SMS service provider. Telnyx, Twilio, and Bandwidth are supported out of the box. Choose Custom to connect a provider we do not support natively.

Description. Description of the SMS Gateway, optional.

Domain. Domain to be used to receive inbound SMS messages and status information sent by your SMS provider

The rest of the parameters may be different, and depends on the SMS provider you selected.

Telnyx

API Key. Provided by Telnyx.

Twilio

Account SID. Provided by Twilio.

Auth Token. Provided by Twilio.

Bandwidth

Application ID. Provided by Bandwidth.

Account ID. Provided by Bandwidth.

Auth Token. Provided by Bandwidth.

API Secret. Provided by Bandwidth.

Custom

Use Custom when your SMS carrier is not one of the built-in providers. Configuration Manager exposes standard inbound and delivery-status webhooks on the selected domain; your own gateway (or a custom adapter you run) is responsible for sending outbound traffic and forwarding inbound/status events back to those webhooks.

Provider’s URL. Full URL that Configuration Manager submits outbound send requests to. Point this at your own carrier adapter (or, for lab use, at the reference sample gateway).

Account SID. Identifier passed in outbound requests; reused as a generic credential.

Auth Token. Secret paired with Account SID.

Once the gateway is saved, Configuration Manager generates:

  • Webhook URL for inbound messages: https://<domain>/sms/<gateway-name>/generic
  • Delivery Status URL: https://<domain>/sms/<gateway-name>/generic/status

For a full setup walkthrough, request/response contracts, and a downloadable Twilio reference adapter you can run locally, see Custom SMS Gateway implementation.

Set URL at a service provider

Once the SMS Gateway is created, Configuration Manager will generate a URL for receiving inbound SMS messages and status information sent by your SMS provider. You need to specify these URLs at your SMS provider’s portal.