--- title: 3CX SMS Configuration guide description: 3CX Business Messaging SMS --- [Skip to content](https://support.2talk.co.nz/3cx-sms-configuration-guide#main-content) [![2tlogo](https://support.2talk.co.nz/hs-fs/hubfs/2tlogo.png?width=128&height=60&name=2tlogo.png)](https://www.2talk.co.nz//) Open main navigation Close main navigation Hi. How can we help? - There are no suggestions because the search field is empty. 1. [2talk](https://support.2talk.co.nz/?hsLang=en) 2. [Messaging](https://support.2talk.co.nz/messaging?hsLang=en) # 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 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 trunk you would like to use. 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](https://support.2talk.co.nz/how-to-connect-a-3cx-v20-pbx-to-2talk?hsLang=en) Note: If you do not see an SMS tab option on your existing trunk then the trunk type you have configured does not support SMS, in this case you can create a new trunk with the generic template or follow the 3CX to 2talk guide linked above. 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. ![](https://support.2talk.co.nz/hs-fs/hubfs/image-png-Aug-01-2025-03-16-09-4547-AM.png?width=670&height=308&name=image-png-Aug-01-2025-03-16-09-4547-AM.png) **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** In order to use the SMS number for either inbound or outbound services, the SMS DID will need to be assigned to that user. This allows the user to select the SMS number as a provider when creating a SMS chat within 3cx, and receive messages to that SMS number back into their chat. 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. ![](https://support.2talk.co.nz/hs-fs/hubfs/image-png-Aug-01-2025-03-16-57-6002-AM.png?width=670&height=310&name=image-png-Aug-01-2025-03-16-57-6002-AM.png) This will bring up a list of numbers assigned to that user. Select the SMS Enabled number you wish to send from. ![](https://support.2talk.co.nz/hs-fs/hubfs/image-png-Aug-01-2025-03-17-43-6597-AM.png?width=670&height=313&name=image-png-Aug-01-2025-03-17-43-6597-AM.png) Type your message and click send. Congratulations! You have sent an SMS using your new SMS Enabled number. ![](https://support.2talk.co.nz/hs-fs/hubfs/image-png-Aug-01-2025-03-18-00-4393-AM.png?width=670&height=312&name=image-png-Aug-01-2025-03-18-00-4393-AM.png)             - [Accounts & Billing](https://support.2talk.co.nz/accounts-billing?hsLang=en#main-content) - [Manage Account](https://support.2talk.co.nz/accounts-billing?hsLang=en#manage-account) - [Billing & Payment](https://support.2talk.co.nz/accounts-billing?hsLang=en#billing-payment) - [Getting Help](https://support.2talk.co.nz/accounts-billing?hsLang=en#getting-help) - [Broadband](https://support.2talk.co.nz/broadband?hsLang=en#main-content) - [Getting Started](https://support.2talk.co.nz/broadband?hsLang=en#getting-started) - [Troubleshooting](https://support.2talk.co.nz/broadband?hsLang=en#troubleshooting) - [Broadband Plans](https://support.2talk.co.nz/broadband?hsLang=en#broadband-plans) - [Device Guides](https://support.2talk.co.nz/broadband?hsLang=en#device-guides) - [Voice](https://support.2talk.co.nz/voice?hsLang=en#main-content) - [Getting Started with 2talk Voice](https://support.2talk.co.nz/voice?hsLang=en#getting-started-with-2talk-voice) - [Troubleshooting](https://support.2talk.co.nz/voice?hsLang=en#troubleshooting) - [2talk Cloud PBX](https://support.2talk.co.nz/voice?hsLang=en#2talk-cloud-pbx) - [SIP Trunks](https://support.2talk.co.nz/voice?hsLang=en#sip-trunks) - [Softphones and Devices](https://support.2talk.co.nz/voice?hsLang=en#softphones-and-devices) - [2talk Voice Plans and Services](https://support.2talk.co.nz/voice?hsLang=en#2talk-voice-plans-and-services) - [2talk Lyra Voice Platform](https://support.2talk.co.nz/voice?hsLang=en#2talk-lyra-voice-platform) - [Mobile](https://support.2talk.co.nz/mobile?hsLang=en#main-content) - [Getting Started](https://support.2talk.co.nz/mobile?hsLang=en#getting-started) - [Troubleshooting](https://support.2talk.co.nz/mobile?hsLang=en#troubleshooting) - [Mobile Plans and Services](https://support.2talk.co.nz/mobile?hsLang=en#mobile-plans-and-services) - [3G Shutdown](https://support.2talk.co.nz/mobile?hsLang=en#3g-shutdown) - [Messaging](https://support.2talk.co.nz/messaging?hsLang=en) - [Voice AI](https://support.2talk.co.nz/voice-ai?hsLang=en) [![2talk_logo_17](https://support.2talk.co.nz/hs-fs/hubfs/2talk_logo_17.png?width=50&height=23&name=2talk_logo_17.png "2talk_logo_17")](https://www.2talk.co.nz) Copyright © 2025, 2talk