Skip to content
  • There are no suggestions because the search field is empty.

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.

 

 

 

 

 

 

test