Skip to content

xFrieDSpuDx/SMS-Bulk-Sender

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

  • Ensure your Telnyx account has been verified so the account isn't disabled when sending large numbers of messages.
  • Telnyx has rate limiters on certain number formats. UK long numbers for example are 6 messages a minute by default. Once the SMS Bulk Sender has successfully sent the messages from Telnyx, there may be a delay in the message being delivered while these rate limits are in place. Please speak with Telynix to have this limit removed.

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!