**Ceci est une ancienne révision du document !**
Gérer les intégrations
Par intégration, on entend les interactions entre Mattermost et d’autres applications.
Préambule
Deux fonctionnalités méconnues de Mattermost mais néanmoins utiles sont la création de hooks entrants et de commandes slash.
- Un hook entrant (abrévié hook par la suite) est une URL spéciale qui permet de poster un message sur un canal particulier lorsque l’URL est requêtée.
- Une commande slash (abrévié commande par la suite) est un mot clé précédé d’un symbole
/qui déclenche l’appel à une URL externe et remplace le message par la réponse.
Les commandes sont à différencier des commandes de plugin (comme /spoiler), qui ne requêtent pas nécessairement une URL extérieure.
Note:
Les hooks sont très pratiques pour réagir à un événement extérieur et poster un message suite à cet événements. Voici quelques exemples :
- Ajout d’une nouvelle tâche sur un kanban : un message est posté sur le canal concerné
- Ouverture d’une nouvelle issue sur Gitlab : une mention est envoyée aux membres du dépôt
- CPU au dessus de 80% sur une des machines virtuelles : une mention est envoyée à l’équipe technique.
Attention:
Les hooks ne fonctionnent qu’avec des outils “compatibles” Slack ou Mattermost.
Note:
Les commandes slash sont utiles pour déclencher une action extérieure ou générer un message contenant une information dynamique. Exemples :
- Obtenir les statistiques d’un service, les mettre en forme et les poster
- Déclencher la génération d’un rapport journalier quelconque
- Générer et poster une citation d’un personnage de Kaamelott
Pour résumer, les hooks permettent d’être informés d’un événements, les commandes permettent de déclencher un événement ou de générer des informations dynamiques.
Administration et portée
Les hooks et les commandes sont circonscrits à une équipe. Une commande mise en place sur une équipe ne fonctionnera que sur cette équipe.
Les administrateurs d’équipes sont les seules personnes à pouvoir gérer les hooks et commandes. Ceci étant, c’est très pratique car il n’y a pas besoin d’un administrateur système pour créer ses propres commandes/hooks.
La personne qui crée une équipe en est automatiquement administrateur, et peut ensuite étendre ce rôle aux autres membres depuis la gestion des membres de l’équipe. La plupart des personnes ne sont pas au courant de ce rôle, il ne faut pas hésiter à leur signaler si ça peut être utile. :)
La gestion des intégrations se fait depuis l’URL suivante, construite à partir du nom de l’équipe :
https://team.picasoft.net/<equipe>/integrations
Ou depuis le menu (clic sur le burger à côté du nom de compte → Intégrations).