Skip to main content

A utility for sending SMS using a mustache temlate

Project description

twilio-sendsms

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.

Installation

The utility requires python3.7

python -m pip install twilio_sendsms

Setup

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.

Running

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.

buld_send.csv

"mobile_number","first_name"
"+614XXXXXXXX","Joe"

To process the batch file:

sendsms --template example.mustache test.csv 

Testing

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.

Files for twilio-sendsms, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size twilio_sendsms-0.1.5-py3-none-any.whl (3.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size twilio-sendsms-0.1.5.tar.gz (3.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page