A third-party SMS connector module for FreePBX 16
FreePBX offers SMS and MMS functionality through UCP (User Control Panel) and the Sangoma Connect softphones. This integrates tightly with Sangoma number services (SIPStation and VoIP Innovations) but until now there have been no open source modules allowing integration with third-party providers. The aim of this module is to provide a generic, expandable connector, with new providers added as contributed by the community.
- Send and receive SMS and MMS through UCP and Sangoma Connect
- Mix-and-match: if you have numbers on multiple providers you are not limited to just one
- Telnyx: Messaging API v2 (https://developers.telnyx.com/docs/api/v2/messaging)
- Flowroute: Messaging API v2.2, webhook v2.1 (https://developer.flowroute.com/api/messages/v2.2/)
- Twilio: Messaging API version 2010-04-01 (https://www.twilio.com/docs/sms)
- Commio/Thinq: (https://apidocs.thinq.com/#bac2ace6-7777-47d8-931e-495b62f01799)
- Voxtelesys: Messaging API v1 (https://smsapi.voxtelesys.com)
fwconsole ma downloadinstall https://github.com/simontelephonics/smsconnector/releases/download/v16.0.8/smsconnector-16.0.8.tar.gz
fwconsole r
For inbound SMS/MMS and outbound MMS to work, you will need an HTTPS path inbound to your PBX from your provider(s). This means:
- Import or generate a TLS certificate in Certificate Manager
- Enable it on the web server using Sysadmin Pro or by manually configuring Apache
- Allow your provider(s) webhook addresses through the FreePBX Firewall and/or your network firewall
- Set the public DNS name in the
AMPWEBADDRESS
setting: Advanced Settings -> FreePBX Web Address
Sending of SMS/MMS requires verification and registration performed through your provider and is outside of the scope of this module or document.
Once setup with your provider, generate an API key (Telnyx, Voxtelesys), an API key and secret (Flowroute), Account SID and Auth Token (Twilio), or API token (Commio) and enter these into the SMS Connector -> Provider Settings screen.
In the provider portal, set the webhook URL for inbound SMS/MMS in the format shown on the Provider Settings screen ("Webhook Provider").
Enter a number (DID), pick the user(s) to which the DID should be assigned, and select the provider for that number.
- Configuration within User Management (dummy screen right now)
- Automatic addition of FreePBX Firewall rules when module is installed and removal when module is uninstalled