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.

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.

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

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

  • technique/adminserv/wekan/hooks.1599070259.txt.gz
  • de qduchemi