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:adminsys:wekan:hooks [2020/09/02 20:11] qduchemitechnique:adminserv:wekan:hooks [2022/05/24 21:00] (Version actuelle) ppom
Ligne 1: Ligne 1:
-## Utiliser les hooks Wekan avec Mattermost+{{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. 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.
Ligne 5: Ligne 7:
 Ainsi, les personnes concernées voient les activités (nouvelle tâche, tâche terminée, etc). Ainsi, les personnes concernées voient les activités (nouvelle tâche, tâche terminée, etc).
  
-Ce mini-guide aide à les configurer.+<bootnote>Le déclenchement d'une action personnalisée lors d'un événement s'appelle un *hook* ("crochet").</bootnote>
  
-### Créer un webhook entrant sur Mattermost+Ce mini-guide aide à configurer un hook sur Wekan.
  
-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](https://docs.mattermost.com/developer/webhooks-incoming.html).+### Créer un hook entrant sur Mattermost
  
-Les webhook entrants ne peuvent être créés que par les administrateur système sur Mattermost.+Voir [[technique:adminserv:mattermost:hooks_commands#creer_et_tester_un_hook_entrant|la page sur les intégrations Mattermost]].
  
-On se rend pour ce faire sur ce lien (pour l'équipe Picasoft) : https://team.picasoft.net/picasoft/integrations/incoming_webhooks +### Créer un hook sortant sur Wekan
- +
-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 : Depuis un board Wekan, on se rend dans les paramètres :
Ligne 33: Ligne 29:
  
 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. 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é #### Filtrer par activité
Ligne 40: Ligne 34:
 On entrera comme URL : On entrera comme URL :
 ``` ```
-https://kanban.picasoft.net/forward_hooks?url=MATTERMOST_URL+http://wekan-filter-hooks:5000/forward_hooks?url=MATTERMOST_URL
 ``` ```
  
 Où `MATTERMOST_URL` est l'URL créée plus haut par Mattermost. 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 :+Seules les activités suivantes généreront un message sur Mattermost :
  
 * Création d'une carte * Création d'une carte
 * Déplacement d'une carte * Déplacement d'une carte
 * Ajout d'un commentaire * 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>
  • technique/adminserv/wekan/hooks.1599070304.txt.gz
  • de qduchemi