Connecter Microsoft Teams

Mirox peut publier vos notifications directement dans un canal Microsoft Teams — alarmes, activité des tickets, rapports —, pour que toute votre équipe les voie là où elle travaille déjà. La connexion est un flux de travail de webhook entrant standard de Teams : Teams vous fournit une URL, et vous enregistrez cette URL comme webhook dans vos paramètres de notification Mirox. Aucun plugin ni installation d'application n'est nécessaire.

Avant de commencer

• Vous devez avoir, dans Microsoft Teams, l'autorisation d'ajouter des flux de travail au canal cible (la plupart des membres du canal l'ont ; votre administrateur Teams peut la restreindre).
• Décidez quel canal doit recevoir les notifications Mirox — un canal dédié comme Mirox Alerts les garde faciles à suivre.

Étape 1 — Créer le flux de travail de webhook dans Teams

1. Dans Microsoft Teams, allez dans le canal qui doit recevoir les notifications.
2. Cliquez sur les trois points (⋯) à côté du nom du canal et choisissez Flux de travail (Workflows).
3. Sélectionnez le modèle « Publier dans un canal lorsqu'une requête de webhook est reçue » (en anglais : "Post to a channel when a webhook request is received").
4. Connectez-vous ou confirmez la connexion si demandé, conservez ou ajustez le nom du flux, puis cliquez sur Suivant.
5. Confirmez l'équipe et le canal, puis cliquez sur Ajouter un flux de travail.
6. Teams affiche alors l'URL du webhook. Copiez-la, puis cliquez sur Terminé.

Étape 2 — Ajouter le webhook dans Mirox

1. Ouvrez votre Profil et sélectionnez l'onglet Notifications.
2. Dans la carte Canaux, sous Webhooks, cliquez sur Ajouter un webhook.
3. Donnez-lui un nom reconnaissable, par exemple Teams — Exploitation.
4. Collez l'URL du flux de travail issue de Teams.
5. Réglez le format sur Microsoft Teams — Mirox enverra ainsi des messages que Teams peut afficher sous forme de cartes.
6. Enregistrez. Mirox affiche le secret de signature une seule fois — pour une connexion Teams, vous pouvez simplement fermer cette fenêtre, voir À propos des en-têtes de signature ci-dessous.

Étape 3 — Envoyer un message de test

1. Sur la ligne du nouveau webhook, cliquez sur Tester.
2. En quelques instants, un message de test Mirox apparaît dans votre canal Teams.

Si rien n'arrive, vérifiez que l'URL a été copiée en entier et que le flux de travail est activé dans Teams, puis testez à nouveau.

Acheminer les notifications vers Teams

L'ajout du webhook rend le canal disponible — assurez-vous maintenant que les notifications l'utilisent réellement :

• Activez l'interrupteur principal Envoyer des notifications en dehors de l'application dans l'onglet Notifications.
• Vérifiez que le canal webhook est activé et sélectionné pour les groupes de notification qui vous intéressent dans la carte Ce qui me notifie (par défaut, les groupes suivent votre sélection globale de canaux).

Dès lors, les notifications correspondantes sont publiées dans votre canal Teams au fil de l'eau.

À propos des en-têtes de signature

Chaque requête de webhook envoyée par Mirox est signée : elle porte des en-têtes de signature et d'horodatage calculés à partir du secret de signature du webhook, afin qu'un système récepteur puisse vérifier que la requête provient réellement de Mirox et n'est pas une répétition. Microsoft Teams ignore ces en-têtes — le flux de travail accepte toute requête bien formée qui connaît l'URL —, vous n'avez donc jamais besoin du secret pour une connexion Teams. Il devient utile lorsque vous pointez un webhook Generic JSON vers votre propre système et souhaitez authentifier les requêtes entrantes ; vous pouvez le réémettre à tout moment avec Renouveler le secret.

Dépannage

Guides associés

• Notifications — le guide complet des paramètres de notification : canaux, groupes, sourdines et heures de travail
• Tickets — l'activité des tickets qui peut être publiée dans Teams