**Ceci est une ancienne révision du document !**
Utiliser les hooks Wekan avec 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).
Ce mini-guide aide à les configurer.
Créer un webhook entrant sur Mattermost
Sur Mattermost, un webhook entrant est une URL qui peut recevoir des requêtes POST
avec des données au format JSON
, qui indiquent qu’un message doit être posté dans un canal donné. La documentation complète est ici.
Les webhook entrants ne peuvent être créés que par les administrateur système sur Mattermost.
On se rend pour ce faire sur ce lien (pour l’équipe Picasoft) : https://team.picasoft.net/picasoft/integrations/incoming_webhooks
On clique sur Ajouter un webhook entrant
. On peut ensuite choisir le canal qui sera concerné par ce webhook, le nom du bot qui postera le message, sa photo de profil…
Une fois le webhook créé, on obtient une URL de la forme https://team.picasoft.net/hooks/XXX
qu’on conserve pour plus tard.
Créer un webhook 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.
De plus, les messages sont en anglais et contiennent beaucoup de détails.
Filtrer par activité
On entrera comme URL :
https://kanban.picasoft.net/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 simplifié, en français : * Création d’une carte * Déplacement d’une carte * Ajout d’un commentaire