A CLI to send SMS via twilio's API.

The CLI takes as argument the path to a configuration file that contains credentials to the API. It also has a number of sub commands, and each sub command is associated with a specific action.

For each action, a section in the configuration file is expected. The two actions currently supported are:

• reboot
• hello

hello is a simple one used for testing, it sends "hello world".

reboot is used to create a message that contains the host's name and the IP address of the network interface specified in the configuration file.

Usage

The tool supports sub-commands, which are profiles with predefined messages.

Output using one of the test phone numbers:

> sendsms -c sendsms-test.toml reboot
failed to send the message: (400) The 'From' number +15005550001 is not a valid phone number, shortcode, or alphanumeric sender ID.

For example, you can write a systemd unit that is triggered after a reboot to send an SMS with sendsms reboot. The SMS will contain the host's name and the IP of a predefined interface.

Configuration

A configuration looks like this:

account_sid='xxx'
auth_token='xxx'
from='+1500xxx'
to='+1415xxxxxx'

[reboot]
ifname='wlan0'

You can find the account_sid and auth_token information in the console.

Testing

For testing, you can use the testing credentials. This will not send an SMS and you won't be charged.

When testing, you can use the following phone numbers for from:

For to:

Build

This can be build via nix build . from the root of the repository, or cargo build from inside the directory.