famedly.matrix.matrix_notification (0.2.2) — module

Install collection

Install with ansible-galaxy collection install famedly.matrix:==0.2.2

Add to requirements.yml

  collections:
    - name: famedly.matrix
      version: 0.2.2

Description

This module sends html formatted notifications to matrix rooms.

Requirements

• matrix-nio (Python library)

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Send matrix notification with user_id and password
  matrix_notification:
    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 }}"

Inputs

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

hs_url:
    description:
    - URL of the homeserver, where the CS-API is reachable
    required: true

room_id:
    description:
    - ID of the room to send the notification to
    required: true

user_id:
    description:
    - The user id of the user

msg_html:
    description:
    - HTML form of the message to send to matrix
    required: true

password:
    description:
    - The password to log in with

msg_plain:
    description:
    - Plain text form of the message to send to matrix, usually markdown
    required: true