Bandwidth SMS Integration
Before proceeding, ensure that you have purchased a DID on the Bandwidth platform with SMS enabled.
Important: 10DLC Registration (U.S.)
Compliance Notice If you are using:
A newly added phone number
A newly created carrier account
Or SMS messaging has stopped working unexpectedly
You must complete the carrier’s 10DLC registration process before using SMS in PortSIP PBX.
10DLC registration is mandatory for all supported U.S. carriers
This requirement is enforced by wireless carriers for all A2P messaging traffic
Failure to complete 10DLC registration may result in message blocking or delivery failures.
Obtain Integration Details from Bandwidth
PortSIP PBX requires several identifiers from the Bandwidth platform to enable SMS/MMS integration.
Step 1: Obtain the Bandwidth User ID
Log in to your Bandwidth dashboard.
After logging in, locate the User ID:
In the Overview section, or
In the top-right corner next to Account Settings
Note The User ID is required later as the Account ID in PortSIP PBX.
Step 2: Create and Obtain the Application ID
The Application ID is generated when you create a messaging application.
In the Bandwidth dashboard, go to Applications.
Click Create New Application.
Enter an Application Name (for example, PortSIP-SMS).
Select Messaging as the application type.
Set the Callback URL. At this stage, you may use a temporary (fake) URL, such as:
Save the application.
Expected Result
Bandwidth generates an Application ID, which you will use later in PortSIP PBX.
Configure SMS with Bandwidth Trunk in PortSIP PBX
Please ensure a Bandwidth SIP trunk has already been configured in PortSIP PBX using:
Sign in to the PortSIP PBX Web Portal
You can sign in using one of the following methods:
Option 1: System Administrator
Sign in as a PBX System Administrator.
Go to Tenants.
Select the target tenant.
Click Manage to switch into that tenant.
Option 2: Tenant Administrator
Sign in directly as a Tenant Admin. For more details, see Tenant Management.
Add an SMS Configuration in PortSIP PBX
Step 1: Create the SMS Configuration
In the PortSIP PBX Web Portal, navigate to: Message Channel > SMS/MMS
Click Add.
Select your configured Bandwidth Trunk.
Configure the following fields:
Sender ID
Enter a Sender ID created on the Bandwidth platform if you want to use a custom sender.
Leave this field empty to use the DID associated with the Bandwidth trunk.
Account ID
Enter the User ID obtained earlier.
Application ID
Enter the Application ID created earlier.
Username
Enter your Bandwidth account username.
Password
Enter the password associated with your Bandwidth account.
Click OK to save the configuration.
Step 2: Copy the PortSIP PBX Webhook URL
Inbound SMS messages are delivered to PortSIP PBX through a webhook.
On the 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.
Step 3: Update the Callback URL in Bandwidth
Sign in to the Bandwidth Dashboard.
Navigate to Applications.
Open the messaging application you created earlier.
Replace the existing (fake) Callback URL with the Webhook URL copied from PortSIP PBX.
Click Save to apply the changes.
Verify the Configuration
At this point, the Bandwidth SMS/MMS integration is complete.
You can now create outbound and inbound rules in PortSIP PBX to send and receive SMS/MMS messages using the Bandwidth trunk, just as you would configure rules for voice calls.
Last updated