3CX SMS Configuration guide
3CX SMS Guide
Connect a 2talk Business Messaging Number to your 3CX PBX to send and receive business messages.
Before you get started
The following guide is for SMS with 3CX v20.
You need a Professional or Enterprise license for your 3CX instance.
The 3CX system you wish to add SMS to needs to be accessible from the internet to receive inbound SMS
Step One: Provision a Business Messaging Number for Your 3CX System
Please open a support ticket to request for a Business Messaging number to be added to your account.
Note: This service is only available to NZ based customers who have a NZ registered legal entity
Step Two: Obtain API Token & API Endpoint from 2talk
Select the end customer account you which to connect to the 3CX instance in CAP -> Customer
Select View As -> Cloud PBX
Select the Business Messaging Number from the Number Summary Page
SMS will appear as a navigation option in the Cloud PBX Feature Menu, select this option.
API Token: Click “Get Token” to obtain your token, copy and paste as required
SMS Gateway URL: Scroll down the page to obtain the SMS Gateway URL, copy and paste as required
Step Three: Connect your 3CX Instance
Log in to the 3CX management console with the admin account.
Head to Admin > Voice & Chat > Select the relevant 2talk trunk.
If you do not have a trunk set up already or need to set up a 2talk trunk for voice services, refer to the 3CX v20 setup guide. https://support.2talk.co.nz/how-to-connect-a-3cx-v20-pbx-to-2talk
Select the SMS section.
Click Enable SMS and enter the API token shared by 2talk into the API Key section.
Enter the SMS Gateway URL into the Provider URL section.
Enable Inbound SMS
If you want to enable inbound SMS copy the Webhook provided by your 3CX system (also in the SMS tab). This will likely be a URL of the FQDN (Fully Qualified Domain Name) that you setup your 3CX with.
Head back to the 2talk portal and paste this webhook into the Webhook URL box in the SMS settings page and click Save.
When entering the webhook you can choose the number format for your inbound messages.
Carrier Defined - default
Local format - number format will be set to local format
Country format - number format will be set to country format - eg 64x for NZ
Next enter the SMS Enabled number as a DDI on your trunk in your 3CX system.
This is done the same way you would add any other DDI number to your 3CX system. To do this, head back to editing your trunk on your 3CX webpanel > DID Numbers > Add.
Add the SMS Enabled number in E164 format (e.g 642825600000). Click save.
Configure Users
Each user can use the SMS number to send outbound messages, but if the user needs to receive the SMS messages back into the 3CX chat, the DDI will need to be assigned to that user. From the admin panel, head to Users > Click on the user to assign to > Assigned DID Numbers > Select the SMS Enabled number > Save.
To send an SMS, log in to the 3CX user account > Chat > + > Send SMS. Enter the number you wish to send the SMS to > Start chat > Ok.
This will bring up a list of numbers assigned to that user. Select the SMS Enabled number you wish to send from.
Type your message and click send. Congratulations! You have sent an SMS using your new SMS Enabled number.