New open source SMS Connector module

It’s possible to develop against the API specs without testing but not likely to work well in my experience :slight_smile:

Someone who uses Bulkvs would be a good person to take this on.

If all you need is a couple of snipits of code to send or receive sms via their API, I have them. My sending gets an error since I have not setup a campaign, but that shows that it doing the correct things.

I will be releasing a new version later this week without the “beta” label. Thanks to all who have tested it. Contributions are exceedingly welcome. Right now I am engaged in other projects and will not be developing the module further other than bug fixes, which you can report on the github repo. Later I may be able to add more provider connections but my hope is that those in the community who use alternate providers will help with the code effort.


This topic was automatically closed 31 days after the last reply. New replies are no longer allowed.

SMS Connector v16.0.8 includes a contribution from provider Voxtelesys.

This module will remain hosted on github but now has “Third party module hosting” configured so that once you install it manually, thereafter, updates will be available from the Module Update screen or at the CLI using fwconsole ma upgrade smsconnector or fwconsole ma upgradeall.

Thanks to everyone who has helped test, given feedback, and of course contributed code.


Hi @billsimon,

I’ve created a couple of PRs to automate updating the module.json file with a github workflow.
You just have to create the new version release, example v16.0.8 and automatically generate the compressed file, the md5 of the file, this file is uploaded (Release v16.0.8 · simontelephonics/smsconnector · GitHub) , and update the json with data from the module.xml (version, changelog) file, the url of the new file, and the md5 of the generated file.

I hope this helps.
Best regards.


Do you think this can work with SMS factory?
SMS Factory | White Label Text Marketing | Business Line Text Messaging

Yes if it has a REST API.

Do anyone have a screenshot of what it looks like in UCP, trying to show to a stakeholder for buy in.

Thank you @vsc55, I think we can use at least part of this contribution. I’m not sure we can use the automatic packaging of the tar.gz file because I am manually signing the package and including the signature file (module.sig). I do not think there is a secure way to handle the signing in an automated pipeline, so the packaging may have to remain a manual process.

hi Bill,
thank you for this contribution. Is it possible to connect GOIP device directly or do we need to do some additional configurations ? and if there is no way out of the box, i have wrote a c code application, that receives the UDP datagram and parse the SMS content, but then i need to pass the SMS content received to your module or convert it to a standard sip header to be forwarded to a SIP user as text message. How can i integrate in your module. Sending out sms is still on going, i could not get the device to accept the BulkSMSSend request, i am still trying with it.

SMS connector is a generic interface to FreePBX’s SMS subsystem. So far, the providers implemented have been REST APIs but if you can interface with the GOIP using PHP then you could probably use this module with your GOIP device.

It would be super cool if we could add into this application

1 Like

this module is fantastic! Thank you! I have successfully set it up with Twilio - SMS works but MMS does not… any ideas?

Most likely you have not specified AMPWEBADDRESS as noted in the info box:

This field is used to construct the URL by which the provider (Twilio) will fetch your MMS image.

When you send MMS it is stored as a blob in the database. The media.php script makes it available to your provider. The constructed URL that is passed to your provider for fetching media will look like https://{AMPWEBADDRESS}/smsconn/media.php?...

can you tell me how to setup it up with telnyx ? i am not be able to

do you have a manual to set it up with telnyx how to?

im working on similar solution but to work with direct smpp gateways like kannel, that just needs a simple SQL injection to send sms once the gateway is properly configured.

good job!! @billsimon


@billsimon Great work, this is a turn key solution that opens a world of functionality for the FreePBX community. I do have a few notes id like to add if I may.

I just installed v16.0.8 and noticed that from the SMS connector screen despite adding two separate DIDs, the table in the main screen remains empty. With that being said I am still able to login to UCP as the assigned user and do see both of those numbers available and was able to successfully receive messages. This just leaves me with the inability to edit the DID assignments once they are created.

Secondly, I would love to see some type of notification workflow that could send an email to the assigned users and possibly even include the message.