/ home / community / community.general / 1.3.14 / module / mattermost

community.general.mattermost (1.3.14) — module

Send Mattermost notifications

Authors: Benjamin Jolivot (@bjolivot)

Install collection

Install with ansible-galaxy collection install community.general:==1.3.14

Add to requirements.yml

  collections:
    - name: community.general
      version: 1.3.14

Description

Sends notifications to U(http://your.mattermost.url) via the Incoming WebHook integration.

Usage examples

Scanned by Steampunk Spotter

- name: Send notification message via Mattermost
  community.general.mattermost:
    url: http://mattermost.example.com
    api_key: my_api_key
    text: '{{ inventory_hostname }} completed'

Scanned by Steampunk Spotter

- name: Send notification message via Mattermost all options
  community.general.mattermost:
    url: http://mattermost.example.com
    api_key: my_api_key
    text: '{{ inventory_hostname }} completed'
    channel: notifications
    username: 'Ansible on {{ inventory_hostname }}'
    icon_url: http://www.example.com/some-image-file.png

Inputs

    
url:
    description:
    - Mattermost url (i.e. http://mattermost.yourcompany.com).
    required: true
    type: str

text:
    description:
    - Text to send. Note that the module does not handle escaping characters.
    required: true
    type: str

api_key:
    description:
    - Mattermost webhook api key. Log into your mattermost site, go to Menu -> Integration
      -> Incoming Webhook -> Add Incoming Webhook. This will give you full URL. api_key
      is the last part. http://mattermost.example.com/hooks/C(API_KEY)
    required: true
    type: str

channel:
    description:
    - Channel to send the message to. If absent, the message goes to the channel selected
      for the I(api_key).
    type: str

icon_url:
    default: https://www.ansible.com/favicon.ico
    description:
    - Url for the message sender's icon.
    type: str

username:
    default: Ansible
    description:
    - This is the sender of the message (Username Override need to be enabled by mattermost
      admin, see mattermost doc.
    type: str

validate_certs:
    default: true
    description:
    - If C(no), SSL certificates will not be validated. This should only be used on personally
      controlled sites using self-signed certificates.
    type: bool

Outputs

payload:
  description: Mattermost payload
  returned: success
  type: str
webhook_url:
  description: URL the webhook is sent to
  returned: success
  type: str