Aller au contenu

Mattermost#

Support mattermost#

Vous avez besoin d'aide avec Mattermost (problème ou demande d'information) et/ou vous n'avez pas trouvé l'information que vous cherchiez dans la documentation de Mattermost, vous pouvez nous contacter par les 2 moyens suivants :

Warning

  • Concentrez-vous en priorité sur le "Community support",
  • Sur le canal Mattermost, prenez d'abord le temps de rechercher si votre problème ou demande d'information n'a pas déjà été traité.

Créer un hook sur un channel avec un compte bot#

Pour utiliser cette fonctionnalité, un bot disposant d'un token est nécessaire. Si vous ne disposez pas encore d’un bot, vous pouvez en faire la demande en cliquant sur Demande Bot.

Page demande bot

Ensuite, ajoutez le bot en tant que membre dans le channel souhaité.

Mattermost ajout membre

Puis récupérez l’ID de ce channel.

Mattermost channels id

Une fois tous les éléments requis réunis, vous pouvez exécuter la commande suivante pour créer le hook :

curl -i -X POST -H 'Content-Type: application/json' \
-d '{
  "channel_id": "Votre_channel_id",
  "display_name": "test_bot"}' \
-H 'Authorization: Bearer Votre_Token_BOT' \
https://mattermost.tech.orange/api/v4/hooks/incoming

Réponse attendue :

{"id":"mge51i5XXXXXXXXXXXXXX","create_at":173281010XXXX,"update_at":173281010XXXX,"delete_at":0,"user_id":"XXXXXXXXXXXXX","channel_id":"XXXXXXXXXXXXXXX","team_id":"XXXXXXXXXXXXXX","display_name":"test_bot","description":"","username":"","icon_url":"","channel_locked":false}

Le "id" retournés sont ceux des hooks créés ci-dessus avec le compte bot. Pour tester si tout fonctionne, vous pouvez exécuter une commande avec un message à l'aide du compte bot.

curl -i -X POST -H 'Content-Type: application/json' \
-d '{
  "text": "This is a message from a bot"
    }' \
https://mattermost.tech.orange/hooks/mge51i5XXXXXXXXXXXXXX(id_récupéré_via_curl)

Sauvegarde dans Vault#

Ceux créés via l'API ne sont pas enregistrés dans les Incoming Webhooks. Il est donc fortement recommandé de les enregistrer dans Vault infra-prd : /secret/applications/mattermost/bot.

Créer un sondage#

Mattermost DIOD embarque le plugin matterpol qui permet de créer des sondages.

Exemples :

  • "Qui vient à Stadium ?"

    /poll "Qui vient à Stadium la semaine prochaine ?" "Lundi" "Mardi" "Mercredi" "Jeudi" "Vendredi" --progress --votes=5

  • "Qui vient à Bridge ?"

    /poll "Qui vient à Bridge la semaine prochaine ?" "Lundi" "Mardi" "Mercredi" "Jeudi" "Vendredi" --progress --votes=5

  • "Poker Planning vote"

Remplacez les deux occurences de BPF-xxx par le ticket

```
/poll "[BPF-xxx](https://portail.agir.orange.com/browse/BPF-xxx)" "1 - Fini à la fin de la réunion" "2 - Fini en quelques heures" "3 - Fini aujourd'hui ou demain" "5 - Fini en une semaine" "8 - Il va y avoir des surprises" "13 - Templates Helm" "20 - Ca durera un Sprint" "40 - Recrute un PO" "100 - Change de travail"
```