archive
/
alerta_alerta-contrib
mirror of https://github.com/alerta/alerta-contrib.git
0
0
Fork 0
Code Issues Projects Releases Wiki Activity
alerta_alerta-contrib/plugins/twilio
History
Nick Satterly 2a6632b78f Fix multiple linting errors 2023-03-21 00:15:34 +01:00
..
README.md Update READMEs 2020-11-20 22:39:32 +01:00
alerta_twilio_sms.py Fix multiple linting errors 2023-03-21 00:15:34 +01:00
setup.py Fix multiple linting errors 2023-03-21 00:15:34 +01:00

README.md

Twilio SMS Plugin

Send SMS messages for new alerts using Twilio.

For help, join Slack chat

Installation

Clone the GitHub repo and run:

$ python setup.py install

Or, to install remotely from GitHub run:

$ pip install git+https://github.com/alerta/alerta-contrib.git#subdirectory=plugins/twilio

Note: If Alerta is installed in a python virtual environment then plugins need to be installed into the same environment for Alerta to dynamically discover them.

Configuration

Add twilio_sms to the list of enabled PLUGINS in alertad.conf server configuration file and set plugin-specific variables either in the server configuration file or as environment variables.

PLUGINS = ['twilio_sms']
TWILIO_ACCOUNT_SID = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
TWILIO_AUTH_TOKEN = ''

TWILIO_TO_NUMBER = ''
TWILIO_FROM_NUMBER = ''

Multiple destination phone numbers can be configured in the TWILIO_TO_NUMBER configuration setting if separated by a comma:

TWILIO_TO_NUMBER = '+15555555,+4471234567'

Troubleshooting

Restart Alerta API and confirm that the plugin has been loaded and enabled.

References

License

Copyright (c) 2016 Nick Satterly. Available under the MIT License.