xFrieDSpuDx / SMS-Bulk-Sender

SMS message bulk sender using the Telnyx API
18 stars 3 forks source link
alphanumeric bulk-sms bulk-sms-sending sms telnyx telnyx-api text-messages text-messaging

SMS-Bulk-Sender

SMS message bulk sender using the Telnyx API

Use the Telnyx API to bulk send SMS services. This project does initial checks of the numbers. It calculates how many SMS' the input text will be split into to help estimate send costs. There is the option to send the message with an alphanumeric title instead of the number. This will require a Telnyx messaging profile being created and the unique ID being used.
The messages are sent as quickly as the browser can send post requests.
To try this out before self hosting use https://sms.lily-pad.uk where this code is hosted.

Install:
Configure a webserver and copy the contents of this repository into the directory.

Latest Commit Functionality:
A huge update to the user interface, error handling and overall functionality.
The application now uses a tab step system where you can only move on to the next section once the current page is complete and valid.
The user interface offers a lot more support for what is needed in each section, prompting the user with suggestions and information on one side and colour feedback for form input status.

The error handling has been improved, the send to number is now verified and works with all countries that Telnyx supports.
The invalid phone numbers are displayed in a more user friendly way, giving the option to download them all as CSV or simply deleting them from the input field. These errors are split into three different categories:
Invalid Numbers
Missing country code
Duplicates

The system will try to send to the numbers it detects as invalid so long as there is a single valid number in the list.

There is now a confirmation page showing useful information about what was sent and gives the option to download a summary of which numbers sent correctly, which failed and what the message was.
The confirmation page also shows much more useful error messages to help diagnose exactly what went wrong if a fatal error is encountered.

TODO:
Add functionality to allow for variables in the text message.
Functionality would be driven from a CSV file used to populate the numbers, the format should be

Number, Variable 1 Text, Variable 2 text....

E.g. +447123456789, John, john@email.com

The message would be written as follows:

Hi {column1}!
To help us keep our records up to date please can you confirm your current email address is {column2}?
Have a great day!

This would display to John as:

Hi John!
To help us keep our records up to date please can you confirm your current email address is john@email.com?
Have a great day!