community.general.matrix module – Send notifications to matrix

Note

This module is part of the community.general collection (version 8.5.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. You need further requirements to be able to use this module, see Requirements for details.

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

Synopsis

  • This module sends html formatted notifications to matrix rooms.

Aliases: notification.matrix

Requirements

The below requirements are needed on the host that executes this module.

  • matrix-client (Python library)

Parameters

Parameter

Comments

hs_url

string / required

URL of the homeserver, where the CS-API is reachable

msg_html

string / required

HTML form of the message to send to matrix

msg_plain

string / required

Plain text form of the message to send to matrix, usually markdown

password

string

The password to log in with

room_id

string / required

ID of the room to send the notification to

token

string

Authentication token for the API call. If provided, user_id and password are not required

user_id

string

The user id of the user

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

- name: Send matrix notification with token
  community.general.matrix:
    msg_plain: "**hello world**"
    msg_html: "<b>hello world</b>"
    room_id: "!12345678:server.tld"
    hs_url: "https://matrix.org"
    token: "{{ matrix_auth_token }}"

- name: Send matrix notification with user_id and password
  community.general.matrix:
    msg_plain: "**hello world**"
    msg_html: "<b>hello world</b>"
    room_id: "!12345678:server.tld"
    hs_url: "https://matrix.org"
    user_id: "ansible_notification_bot"
    password: "{{ matrix_auth_password }}"

Authors

  • Jan Christian Grünhage (@jcgruenhage)