Table des matières

Déclencher des messages Mattermost

Les logiciels de gestion de tâches sont souvent couplés avec un outil type Mattermost : l’idée est qu’une nouvelle activité déclenche un message sur Mattermost.

Ainsi, les personnes concernées voient les activités (nouvelle tâche, tâche terminée, etc).

Note:

Le déclenchement d’une action personnalisée lors d’un événement s’appelle un hook (“crochet”).

Ce mini-guide aide à configurer un hook sur Wekan.

Créer un hook entrant sur Mattermost

Voir la page sur les intégrations Mattermost.

Créer un hook sortant sur Wekan

Depuis un board Wekan, on se rend dans les paramètres :

On clique ensuite sur Webhooks sortants.

Il y a ensuite deux possibilités.

Recevoir toutes les activités

Il suffit de choisir pour l’URL celle générée par Mattermost, de laisser le jeton vide et de créer le webhook.

L’inconvénient est que toutes les activités, même les plus “insignifiantes”, généreront un message, ce qui peut vite spammer le canal cible.

Filtrer par activité

On entrera comme URL :

http://wekan-filter-hooks:5000/forward_hooks?url=MATTERMOST_URL

MATTERMOST_URL est l’URL créée plus haut par Mattermost.

Seules les activités suivantes généreront un message sur Mattermost :

Lien:

Pour une explication plus complète sur le fonctionnement du filtrage, voir le README de l'outil.

Créer un hook sortant global

L’interface d'administration donne cette possibilité.

Important:

Il est vraiment peu probable qu’on se serve de cette fonctionnalité : les boards des autres, même publics, ne devraient générer des messages que si leurs administrateurs l’ont décidé.