rocketchat – Send notifications to Rocket Chat

From Get docs
Ansible/docs/2.7/modules/rocketchat module


rocketchat – Send notifications to Rocket Chat

New in version 2.2.


Synopsis

  • The rocketchat module sends notifications to Rocket Chat via the Incoming WebHook integration

Parameters

Parameter Choices/Defaults Comments

attachments

-

Define a list of attachments.

channel

-

Channel to send the message to. If absent, the message goes to the channel selected for the token specified during the creation of webhook.

color

-

  • normal

  • good
  • warning
  • danger

Allow text to use default colors - use the default of 'normal' to not send a custom color bar at the start of the message

domain

- / required

The domain for your environment without protocol. (i.e. example.com or chat.example.com)

icon_emoji

-

Emoji for the message sender. The representation for the available emojis can be got from Rocket Chat. (for example :thumbsup:) (if icon_emoji is set, icon_url will not be used)

icon_url

-

Default:

URL for the message sender's icon.

link_names

-

  • 1

  • 0

Automatically create links for channels and usernames in msg.

msg

-

Message to be sent.

protocol

-

  • http
  • https

Specify the protocol used to send notification messages before the webhook url. (i.e. http or https)

token

- / required

Rocket Chat Incoming Webhook integration token. This provides authentication to Rocket Chat's Incoming webhook for posting messages.

username

-

Default:

"Ansible"

This is the sender of the message.

validate_certs

boolean

  • no
  • yes

If no, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.



Examples

- name: Send notification message via Rocket Chat
  rocketchat:
    token: thetoken/generatedby/rocketchat
    domain: chat.example.com
    msg: '{{ inventory_hostname }} completed'
  delegate_to: localhost

- name: Send notification message via Rocket Chat all options
  rocketchat:
    domain: chat.example.com
    token: thetoken/generatedby/rocketchat
    msg: '{{ inventory_hostname }} completed'
    channel: #ansible
    username: 'Ansible on {{ inventory_hostname }}'
    icon_url: http://www.example.com/some-image-file.png
    link_names: 0
  delegate_to: localhost

- name: insert a color bar in front of the message for visibility purposes and use the default webhook icon and name configured in rocketchat
  rocketchat:
    token: thetoken/generatedby/rocketchat
    domain: chat.example.com
    msg: '{{ inventory_hostname }} is alive!'
    color: good
    username: ''
    icon_url: ''
  delegate_to: localhost

- name: Use the attachments API
  rocketchat:
    token: thetoken/generatedby/rocketchat
    domain: chat.example.com
    attachments:
      - text: Display my system load on host A and B
        color: #ff00dd
        title: System load
        fields:
          - title: System A
            value: 'load average: 0,74, 0,66, 0,63'
            short: True
          - title: System B
            value: 'load average: 5,16, 4,64, 2,43'
            short: True
  delegate_to: localhost

Return Values

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

Key Returned Description

changed

boolean

success

A flag indicating if any change was made or not.





Status

Authors

  • Ramon de la Fuente (@ramondelafuente)

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/rocketchat_module.html