Set up SMS on 3CX

Before you start

• 3CX must be on version 18.0 Update 7 or higher. Follow the 3CX upgrade guide if you are behind.
• You must be registered with TCR. Do that in the portal under Core-SMS → TCR Form, and read 10DLC registration and TCR first.

Enable SMS on your numbers

In the Wiretap Portal, go to Core-SMS → Manage Numbers, click the plus sign, select the number, and click Enable.

Create the trunk and move your DIDs

1. 1Log in to the 3CX management console.
2. 2Go to SIP Trunks and click Import Provider.
3. 3Upload the Wiretap 3CX template and click OK.
4. 4Open the DIDs tab on the new trunk, add your SMS-enabled numbers, and click Save.

Set the DID on the user

1. 1Go to the Users page and create or edit a user.
2. 2Set Direct Inbound Dialing (DID) at the bottom of the General tab to the correct DID.
3. 3Install the 3CX app on iOS or Android and scan the QR code with it.

Enable SMS and copy the webhook URL

1. 1Go to SIP Trunks and select the trunk you created.
2. 2Open the SMS tab and enable SMS.
3. 3Copy the Webhook URL.

Point the number at the webhook

1. 1In the Wiretap Portal, go to Core-SMS → Manage Numbers and click the SMS-enabled DID.
2. 2Enable Receive to Webhook API and choose 3CX Webhook as the webhook type.
3. 3Paste the webhook URI and save.

Generate an API key

1. 1In the portal, hover your avatar in the top right, click Company Settings, then API Keys.
2. 2Generate a new key or use an existing one.
3. 3Copy the Auth Token value — not the bearer token.
4. 4In the 3CX management console, open the SMS tab on the trunk, paste the key, and click Save.

Open the Chats tab in the 3CX mobile app and start sending.

The same key pair works against the messaging API if you also want to send from your own software.