Sur cette page

Microsoft Teams

L’Integrator publie chaque alerte dans un canal Teams sous forme d’Adaptive Card, par un POST HTTP vers une URL de webhook. Dans Teams, cette URL se cree avec l’app Workflows.

Etape 1 : creer le workflow de webhook

Il faut etre membre de l’equipe, et votre organisation doit autoriser l’app Workflows.

  1. Dans Teams, ouvrez le canal, cliquez sur ⋯ (Plus d’options) a cote de son nom et choisissez Workflows. (Vous pouvez aussi ouvrir l’app Workflows et chercher parmi ses modeles.)
  2. Choisissez le modele Send webhook alerts to a channel (Envoyer des alertes webhook a un canal).
  3. Nommez le workflow, par exemple Alertes Mugnsoft, connectez-vous aux connexions demandees, puis Next.
  4. Verifiez l’equipe et le canal, et cliquez sur Add workflow (ou Save).
  5. Copiez l’URL du webhook affichee a la fin (elle se retrouve aussi dans le detail du workflow, sous le declencheur When a Teams webhook request is received).

Guide officiel : Creer des webhooks entrants avec Workflows pour Microsoft Teams.

L’URL contient une signature (sig=...) : quiconque la possede peut publier dans le canal. Traitez-la comme un secret. Mugnsoft la stocke chiffree. Les cartes sont publiees sous l’identite du bot Workflows (Flow bot) ; un nom ou une icone personnalises ne sont pas possibles. Le workflow appartient a la personne qui l’a cree : si ce compte est desactive, le workflow s’arrete. Un compte de service partage evite ce cas.

Etape 2 : configurer Mugnsoft

Par defaut pour tous les moniteurs d’un Integrator - Integrator → General → Notifications → Teams : activez On fail et/ou On change, et collez l’URL dans Default webhook.

Par moniteur - moniteur → Actions → carte Teams : activez le ou les declencheurs. Laissez Webhook vide pour utiliser le defaut de l’Integrator, ou collez l’URL d’un autre workflow pour publier ce moniteur dans un autre canal.

Enregistrez les deux formulaires avec l’icone disquette.

Ce qui est publie

Une Adaptive Card (version 1.4, pleine largeur) avec :

  • un en-tete dans la couleur du statut (vert OK, jaune MINOR/MAJOR/TIMEOUT, rouge sinon) portant le titre ;
  • les faits (moniteur, type, statut et duree, cible, sonde, heure du controle) et le message de la sonde ;
  • un bouton Locate in 3D view.

Tester

Depuis Mugnsoft - dans le bloc Notifications de l’Integrator, cliquez sur ⚡ sur la carte Teams. L’Integrator publie une carte [TEST] Mugnsoft notification test sur le webhook du champ (ou son defaut enregistre) et renvoie l’erreur HTTP s’il y en a une.

A la main - publiez une carte de la meme forme que celle de l’Integrator, depuis la machine de l’Integrator :


curl -s -X POST "https://...url-de-votre-workflow..." \
  -H "Content-Type: application/json" \
  -d '{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","type":"AdaptiveCard","version":"1.4","body":[{"type":"TextBlock","text":"Carte de test Mugnsoft","weight":"Bolder"}]}}]}'

Le workflow repond 202 Accepted et la carte apparait dans le canal en quelques secondes (une execution est listee dans l’historique d’execution du workflow). Mettez l’URL entre guillemets : elle contient des &.

Lancez ensuite le test de bout en bout.

Depannage

L’Integrator journalise le statut HTTP et le debut de la reponse : teams webhook returned HTTP <code>: ....

Symptome Cause et action
HTTP 401 / 403 Le workflow exige une authentification (mauvais modele), ou l’URL a perdu une partie de ses parametres (sig=). Recreez-le avec Send webhook alerts to a channel et copiez l’URL entiere.
Toute erreur sur une URL webhook.office.com Une ancienne URL de connecteur Office 365 : les connecteurs ne fonctionnent plus depuis mai 2026. Creez un webhook Workflows.
202 mais aucune carte dans le canal Ouvrez l’historique d’execution du workflow : l’execution montre l’etape en echec. Causes habituelles : le proprietaire du workflow n’a plus acces a l’equipe, le canal a ete supprime, ou le workflow a ete desactive.
Les cartes arrivent en retard Workflows s’execute de facon asynchrone ; un delai de quelques secondes a une minute est normal.
Trop de cartes Une regle ON FAIL for 0 checks publie a chaque controle. Utilisez for N checks ou ON CHANGE.

Plus d’elements dans Depannage.

Traductions

PagerDuty