matrix – Send notifications to matrix
New in version 2.8.
Synopsis
- This module sends html formatted notifications to matrix rooms.
Requirements
The below requirements are needed on the host that executes this module.
- matrix-client (Python library)
Parameters
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| hs_url  - / required  | URL of the homeserver, where the CS-API is reachable | |
| msg_html  - / required  | HTML form of the message to send to matrix | |
| msg_plain  - / required  | Plain text form of the message to send to matrix, usually markdown | |
| password  -  | The password to log in with | |
| room_id  - / required  | ID of the room to send the notification to | |
| token  -  | Authentication token for the API call. If provided, user_id and password are not required | |
| user_id  -  | The user id of the user | 
Examples
- name: Send matrix notification with token
  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
  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 }}"
   Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Jan Christian Grünhage (@jcgruenhage)
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.9/modules/matrix_module.html