ansible-role-textbelt

Textbelt is a straightforward SMS API designed for developers who need to send SMS messages easily. Many clients choose Textbelt because it’s easy to set up, has clear and simple pricing, and offers great personal support.

Requirements

You need an API key from textbelt.com or if you decide to host it yourself. You also need a phone number to send the message to, and you might want to customize the message content.

For more information on how to use the Textbelt API, visit here.

Role Variables

Required

• api_key - your Textbelt API key (found in vars/main.yml)
• phone_number - the phone number you want to send the message to (found in vars/main.yml)

Optional

• textbelt_url - the API endpoint to send your request to: https://textbelt.com/text (found in defaults/main.yml)
• message_contents - the message you wish to send: this is a test. nicely done :D (found in defaults/main.yml)
• quota_warning_number - the number that will trigger a notification when you have less than this many messages remaining: 100 (found in defaults/main.yml)

Dependencies

This role uses the uri module, so you just need to have any necessary dependencies for that.

Example Playbook

Here’s an example of how to use this role, including passing in variables:

    - hosts: servers
      roles:
         - { role: elreydetoda.ansible_role_textbelt, api_key: xyz, phone_number: +xxxxxxxxxxx }

License

MIT

Author Information

https://elrey.casa/blog