{{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>