3CX SMS Setup
Before you begin please check the following prerequisites first!
1. Ensure your 3CX is updated to Version 18.0 Update 7 or higher before proceeding with this guide. Follow this guide by 3CX to learn how to upgrade to v18.
2. Please note that Wiretap Telecom requires all customers sending SMS messages to be registered with TCR, this can be done on our Portal by navigating to Core-SMS -> TCR Form.
1. Enable SMS for a DID(s) if you have not already (Wiretap Portal)
- Navigate to Core-SMS -> Manage Numbers -> Click on "Plus sign" -> Select Number -> Click "Enable"
2. Create a new trunk and migrate DID(s)/settings (3CX Management Console)
- Download the Wiretap 3CX Template here
- Login to your 3CX Management Console
- Navigate to SIP Trunks and click on "Import Provider"
- Upload the newly downloaded Wiretap 3CX template and click "OK"
- Go to the "DIDs" tab in your newly created trunk, add your SMS enabled numbers and click "Save".
IMPORTANT: DIDs must be entered in E.164 format. I.e. +19542223333 and ensure that number isn't already assigned to another trunk.
3. Create or Edit existing User (3CX Management Console)
- Go to the "Users" page and edit or create a new User
- Ensure "Direct Inbound Dialing (DID)" (located at the bottom of the "General" tab) is populated with the correct DID.
- Download the 3CX app on iOS or Android and scan the QR code with the app
4. Enable SMS and Copy Webhook URL in new trunk (3CX Management Console)
- Go to the "SIP Trunks" page and select the newly created trunk
- Navigate to the "SMS" tab and enable SMS
- Copy the "Webhook URL" to your clipboard
5. Enable Webhook on SMS enabled DID (Wiretap Portal)
- Go to the Wiretap Portal and login
- Navigate to Core-SMS -> Manage Numbers and click on the SMS enabled DID
- Enable "Receive to Webhook API" and choose "3CX Webhook" for Webhook Type
- Paste Webhook URI & Save
6. Generate APIv2 Key and populate it in 3CX Trunk (Wiretap Portal & 3CX Management Console)
- Hover over your Avatar in the top right -> Click "Company Settings" -> Click "API Keys" on the left hand side -> Generate a new API key or use an existing key
- Copy the "Auth Token" value (ignore bearer token) into your clipboard
- Go to the "SMS" tab in the Trunk on the 3CX Management Console, paste in your API Key and click "Save"