community.general.catapult – Send a sms / mms using the catapult bandwidth api

Note

This plugin is part of the community.general collection (version 4.2.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.catapult.

Synopsis

  • Allows notifications to be sent using sms / mms via the catapult bandwidth api.

Parameters

Parameter Choices/Defaults Comments
api_secret
string / required
Api Secret from Api account page.
api_token
string / required
Api Token from Api account page.
dest
list / elements=string / required
The phone number or numbers the message should be sent to (must be in E.164 format, like +19195551212).
media
string
For MMS messages, a media url to the location of the media to be sent with the message.
msg
string / required
The contents of the text message (must be 2048 characters or less).
src
string / required
One of your catapult telephone numbers the message should come from (must be in E.164 format, like +19195551212).
user_id
string / required
User Id from Api account page.

Notes

Note

  • Will return changed even if the media url is wrong.

  • Will return changed if the destination number is invalid.

Examples

- name: Send a mms to multiple users
  community.general.catapult:
    src: "+15035555555"
    dest:
      - "+12525089000"
      - "+12018994225"
    media: "http://example.com/foobar.jpg"
    msg: "Task is complete"
    user_id: "{{ user_id }}"
    api_token: "{{ api_token }}"
    api_secret: "{{ api_secret }}"

- name: Send a sms to a single user
  community.general.catapult:
    src: "+15035555555"
    dest: "+12018994225"
    msg: "Consider yourself notified"
    user_id: "{{ user_id }}"
    api_token: "{{ api_token }}"
    api_secret: "{{ api_secret }}"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
changed
boolean
always
Whether the api accepted the message.

Sample:
True


Authors

  • Jonathan Mainguy (@Jmainguy)