Skip to main content

A utility for sending SMS using a mustache temlate

Project description


A command-line tool for sending bulk SMS using Twilio.

The utility lets you define a mustache template and provide a CSV file with matching columns for bulk SMS sends.


The utility requires python3.7

python -m pip install twilio_sendsms


The first time you run, you will be prompted to provide your Twilio account details.

All configuration settings get stored in ~/.twilio-sendsms.config. To reconfigure you can delete this file.


First, you need to define a mustache template and save to a file, e.g. example.mustache:

Hi {{first_name}}, this is a test SMS. 

Next, you need to create a bulk send CSV file. The file must have a mobile_number column. The mobile number must be in the international format, e.g. +614XXXXXXXX. The other column names need to match the variable names used in the mustache template.



To process the batch file:

sendsms --template example.mustache test.csv 


Before processing a bulk CVS file, it's a good idea to sample some entries and send them to yourself first. Testing is useful to confirm the formatting and the number of segments are as expected.

To sample and override the mobile_number in the CSV file:

sendsms --template example.mustache --sample 1 --sendto +614XXXXXXXX test.csv

The command outputs destination mobile number, the Twilio message identifier and the SMS message sent.

+614XXXXXXXX,SM8c6335fdcffe4bb88313a16fabc9234d,Hi Joe, this is a test SMS. 

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

twilio-sendsms-0.1.6.tar.gz (3.5 kB view hashes)

Uploaded Source

Built Distribution

twilio_sendsms-0.1.6-py3-none-any.whl (3.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page