Flowroute SMS Integration
Before proceeding with the next steps, ensure that you have purchased a DID on the Flowroute platform with SMS enabled.
Important: A2P 10DLC Registration (U.S.)
Compliance Notice Under U.S. regulations (A2P 10DLC – Application-to-Person SMS), SMS-capable phone numbers must be registered with wireless carriers to avoid message blocking or filtering.
This requirement applies only to A2P messaging (application-generated messages).
It does not apply to P2P (Person-to-Person) messaging.
Failure to complete registration may result in:
SMS delivery failures
Message throttling
Complete blocking by carriers
Follow Flowroute’s official guide to complete A2P 10DLC registration before enabling SMS in the PBX.
Obtain Integration Details from Flowroute
The PBX requires API credentials from Flowroute to enable SMS/MMS integration.
Step 1: Create an API Key
Log in to the Flowroute Portal.
From the top menu, select Preferences.
Open the API Control tab.
Enter a name for your API key.
Click Add New to create the API key.
Step 2: Obtain the Access Key and Secret Key
After creating the API key, remain on the API Control page.
Locate the newly generated credentials.
Copy and securely store the following values:
Access Key
Secret Key
Security Best Practice Treat the Access Key and Secret Key as sensitive credentials. Do not expose them publicly or store them in plaintext files.
Configure SMS with Flowroute Trunk in the PBX
This section explains how to configure SMS messaging in the PBX using a Flowroute SIP trunk.
Prerequisites
Before configuring SMS in the PBX, ensure that:
A Flowroute SIP trunk has already been configured using the guide:
A Flowroute DID with SMS enabled is available
You have obtained the Flowroute Access Key and Secret Key
Sign in to the PBX Web Portal
You can sign in using one of the following methods:
System Administrator
Sign in as a PBX System Administrator.
Navigate to Tenants.
Select the tenant and click Manage to switch into that tenant.
Tenant Administrator
Sign in directly as a Tenant Admin to manage the tenant.
Note For more details, see Tenant Management.
Add an SMS Configuration in the PBX
Step 1: Create the SMS Configuration
In the PBX Web Portal, navigate to: Message Channel > SMS/MMS
Click Add.
Select your configured Flowroute Trunk.
Configure the following fields:
Sender ID
Enter the Sender ID created on the Flowroute platform if you want to use a custom sender.
Leave this field empty to use the DID associated with the Flowroute trunk as the Sender ID.
Access Key
Enter the Access Key obtained from Flowroute.
Secret Key
Enter the Secret Key obtained from Flowroute.
Click OK to save the configuration.
Step 2: Copy the PBX Webhook URL
Inbound SMS messages are delivered to the PBX through a webhook.
On the Message Channel > SMS/MMS list page, select the SMS configuration you just created.
Click Copy Webhook, or
Double-click the configuration and manually copy the Webhook URL.
Configure SMS for a Number in Flowroute
This section explains how to enable SMS for a specific DID in Flowroute and configure SMS webhook callbacks so inbound messages are delivered to the PBX.
Step 1: Enable SMS for a DID in Flowroute
Log in to the Flowroute Portal.
From the main menu, navigate to: DIDs > Manage
Select the phone number for which you want to enable SMS.
From the Choose a DID Action drop-down list, select Enable Messaging.
Configure SMS Webhook Callbacks
Flowroute delivers inbound SMS messages to your system using webhook callbacks. You can configure the webhook per number or globally, depending on your requirements.
Option 1: Configure a Webhook for a Specific Number
Use this option if you want to receive inbound SMS messages only for selected DIDs.
In the Flowroute Portal, navigate to: DIDs > Manage
Select the DID you want to configure.
Configure the Messaging Webhook URL for that number.
Paste the PBX Webhook URL copied from the SMS configuration.
Save the changes.
Use Case
Recommended when only certain numbers should deliver SMS to the PBX.
Option 2: Configure a Global Messaging Webhook (All Numbers)
Use this option if you want to receive inbound SMS messages for all DIDs under your Flowroute account.
In the Flowroute Portal, navigate to the Messaging / Webhooks configuration area.
Configure the Global Messaging Webhook URL.
Paste the PBX Webhook URL.
Save the configuration.
Use Case
Recommended when all SMS-enabled numbers should be handled by the PBX.
Verify the Configuration
At this point, the Flowroute SMS/MMS integration is complete.
You can now create outbound and inbound rules in the PBX to send and receive SMS/MMS messages using the Flowroute, just as you would configure rules for voice calls.
Last updated