Twilio SMS Integration
Last updated
Last updated
Before proceeding with the next steps, you need to purchase a DID on the Twilio platform with the SMS/MMS enabled.
According to US legislation (A2P 10DLC SMS), 10DLC (10-digit Long Code) phone numbers that are used for A2P (Application-to-Person) messaging MUST be registered, otherwise, SMS messages sent to US numbers from the unregistered 10DLC numbers will be blocked.
If your business communicates with US-based customers, you should confirm the registration requirements with the SMS service provider and complete the phone number registration to avoid disruption in message delivery.
Login to the Twilio Console, and click the Account Dashboard, copy and note the Account SID and Auth Token in Account Info section.
An Alphanumeric Sender ID is your company name or brand used as the Sender ID in one-way SMS messages sent to supported countries. Alphanumeric Sender IDs may be up to 11 characters long. Accepted characters include both upper- and lower-case Ascii letters, the digits 0 through 9, and the space character. They may not be only numerals.
If you want to enable the Sender ID, under Twilo Console, navigate to the menu Develop > Phone Numbers > Alphanumeric Sender IDs, and follow the instructions to register a Sender ID.
For more details please check the article Alphanumeric Sender ID.
Before configuring SMS in PortSIP PBX, you must have already configured a Twilio SIP trunk using one of the following guides:
You can sign in to the PortSIP PBX Web portal using one of the following methods:
Sign in as the PBX system administrator, navigate to the Tenants menu, choose a tenant, and click the Manage button to switch to that tenant.
Sign in as a tenant admin to manage the tenant.
For more details please reference Tenant Management.
Please follow the below steps:
In the PortSIP PBX Web portal, navigate to the left menu, select SMS/MMS, and click the Add button.
Choose your configured Twilio Trunk:
Sender ID: If you want to send the SMS with a Sender ID, enter the Sender ID that you created in the Register a Sender ID section. You can leave it as empty.
Account SID: Paste your copied Twilio Account SID here.
Auth Token: Paste your copied Twilio Auth Token here.
Click OK to be brought to the SMS/MMS list page. You can select that SMS configuration, then press the Copy Webhook button to copy the Webhook URL. Or Double-click the SMS configuration to edit the SMS configuration, in the details copy the Webhook URL.
Log in to your Twilio console
Navigate to the menu Develop > Phone Numbers > Manage > Active Numbers, and you will see the numbers you have purchased.
Click a number to edit it and configure the messaging webhook with PBX's Webhook URL that you copied in PortSIP PBX in the above steps.
Enable the geographic permission for the desired region(s) where you want to send SMS messages so that messages can be successfully sent to the phone numbers within the region(s).
Now you can create the outbound and inbound rules in PortSIP PBX for sending and receiving SMS/MMS using the Twilio Trunk, just like you create the rules for making and receiving calls.
