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
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
Où MATTERMOST_URL est l’URL créée plus haut par Mattermost.
Seules les activités suivantes généreront un message sur Mattermost :
- Création d’une carte
- Déplacement d’une carte
- Ajout d’un commentaire
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é.