community / community.general / 2.5.9 / module / mattermost Send Mattermost notifications Authors: Benjamin Jolivot (@bjolivot)community.general.mattermost (2.5.9) — module
Install with ansible-galaxy collection install community.general:==2.5.9
collections: - name: community.general version: 2.5.9
Sends notifications to U(http://your.mattermost.url) via the Incoming WebHook integration.
- name: Send notification message via Mattermost community.general.mattermost: url: http://mattermost.example.com api_key: my_api_key text: '{{ inventory_hostname }} completed'
- 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
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
payload: description: Mattermost payload returned: success type: str webhook_url: description: URL the webhook is sent to returned: success type: str