3CX SMS Setup
3CX SMS Setup
Before you begin please check the requirements below!!
- Ensure your 3CX is updated to Version 18 Update 5 (18.0.5.415) or higher before proceeding with this guide.
- Please note that Voxtelesys can only support numbers registered with the TCR, this can be done on our Portal. At this time numbers can still be SMS enabled without the TCR but they are subject to SMS Surcharges passed from the wireless carriers.
1. Enable SMS on your 3CX SIP Trunk (Voxtelesys)
Navigate to SIP Trunks > Edit your Voxtelesys SIP Trunk
SMS > Enable
Keep this page open while we create the Messaging Application on the Voxtelesys Portal.
2. Copy the Webhook URL
3. Create a Messaging Application
Log into the Voxtelesys Portal and navigate to the Messaging Applications
APIs > Messaging Applications > Click on Create Application
Fill in the information for your new Messaging Application
Profile Name: 3CX SMS
Trunk Group: Select your service trunk
HTTP Method: POST
Events: Inbound Messages (MOs)
MO Webhook: Paste in the copied webhook from the 3CX SIP Trunk
Authentication: None
4. Create an API Key
APIs > Keys > Create Key
Enabled: Checked
Name: 3CX SMS
Trunk Group: Select your service trunk, same as the application trunk
Copy the new Key
5. Add API key to 3CX
Navigate back to your 3CX and paste in the API key under the SIP trunk SMS settings and click on "OK"
6. SMS Enabled numbers
On the Voxtelesys Portal you will need to SMS enable your numbers and apply the messaging application.
Navigate to Phone Numbers > Numbers > Search for the number you are SMS enabling
Edit the number
Enabled SMS, add the application, and assign your SMS Campaign.
- You cannot enabled SMS on your number without a campaign, go to https://portal.voxtelesys.net/sms-campaigns-registry to create your brand and register your campaign. Note that Low Volume campaigns are best for 3CX/PBX customers.
7. Send some Test Messages!
You are all done! Please note that your messages will follow your incoming rules on 3CX, if you have your number pointed to a call queue it will message the available agents, if to a direct user it will message them directly.