technique:adminserv:wekan:hooks

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision		 Révision précédente
technique:adminserv:wekan:hooks [2021/01/14 15:22] – qduchemitechnique:adminserv:wekan:hooks [2022/05/24 21:00] (Version actuelle) – ppom
Ligne 1: Ligne 1:
 +{{indexmenu_n>10}}
  
 +## 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).
 +
 +<bootnote>Le déclenchement d'une action personnalisée lors d'un événement s'appelle un *hook* ("crochet").</bootnote>
 +
 +Ce mini-guide aide à configurer un hook sur Wekan.
 +
 +### Créer un hook entrant sur Mattermost
 +
 +Voir [[technique:adminserv:mattermost:hooks_commands#creer_et_tester_un_hook_entrant|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 :
 +{{ :technique:adminsys:wekan:wekan_menu.jpg?direct |}}
 +
 +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
 +
 +<bootnote web>Pour une explication plus complète sur le fonctionnement du filtrage, voir le [README de l'outil](https://gitlab.utc.fr/picasoft/projets/services/wekan).</bootnote>
 +
 +### Créer un hook sortant global
 +
 +L'[[technique:adminserv:wekan:admin_gui|interface d'administration]] donne cette possibilité.
 +
 +<bootnote critical>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é.</bootnote>