Documentation

Alertes Teams : envoyer les alertes Pingsured dans un canal

Pingsured peut publier une alerte dans un canal ou une discussion Microsoft Teams quand un ping tombe en panne, quand il est rétabli et quand son certificat est remplacé. C’est un webhook qui parle Teams : vous donnez à Pingsured l’URL d’un workflow Teams, et chaque alerte arrive dans ce canal ou cette discussion sous la forme d’une carte. Les alertes Teams sont disponibles dans les mêmes offres que les webhooks, c’est-à-dire toutes les offres payantes. Elles sont configurées par un propriétaire ou un gestionnaire du compte, pour un seul ping ou comme valeur par défaut de tous les pings du compte.

Ce qu’il vous faut

  • Un compte Microsoft 365 autorisé à créer des workflows dans Teams. Votre administrateur peut désactiver l’application Workflows.
  • Le canal ou la discussion où les alertes doivent arriver. Un workflow publie dans un seul des deux ; pour en alerter un second, créez un second workflow.

Créer le workflow dans Teams

Microsoft a retiré en mai 2026 l’ancien « Incoming Webhook » de Teams, fondé sur les connecteurs. Un webhook dans Teams est désormais un workflow, et c’est vers lui que Pingsured publie.

  • Dans Teams, ouvrez l’application Workflows et choisissez le modèle Post to a channel when a webhook request is received (Microsoft traduit son nom selon la langue), ou celui d’une discussion.
  • Donnez un nom au workflow, par exemple Pingsured, et choisissez l’équipe et le canal, ou la discussion, où il doit publier.
  • Une fois créé, copiez l’URL du webhook qu’il affiche. Elle est longue et se termine par une signature, sig=….

Microsoft change de temps à autre le nom de ses menus et de ses modèles. Ce dont Pingsured a besoin, c’est l’URL d’un workflow qui démarre à la réception d’une requête webhook.

Traitez l’URL comme un secret : quiconque la possède peut publier dans ce canal. Pingsured ne l’affiche en entier qu’aux propriétaires et aux gestionnaires. Un workflow appartient à la personne qui l’a créé et cesse de fonctionner si elle quitte l’organisation sans que personne d’autre en soit propriétaire : ajoutez-lui donc un copropriétaire.

L’ajouter dans Pingsured

  • Pour tous les pings, ouvrez Paramètres → Notifications, allez à Intégrations sous Notifications par défaut et choisissez la carte Teams.
  • Pour un seul ping, ouvrez le ping, allez à sa section Notifications, choisissez Ajouter un abonnement puis Teams.

Collez l’URL du webhook en entier, signature comprise. Pingsured n’accepte que les adresses que portent les workflows Teams (elles se terminent par .logic.azure.com ou .api.powerplatform.com) : l’URL d’un autre service, ou une URL coupée avant sa signature, est refusée à l’enregistrement. Choisissez ensuite les déclencheurs. Le réglage recommandé est Première erreur et Premier OK, avec Certificat changé si vous vérifiez les certificats : vous savez quand quelque chose tombe et quand c’est réparé.

Envoyer un test, à côté du canal, publie un message marqué comme test. C’est le moyen le plus rapide de vérifier que l’URL et le canal sont les bons avant qu’une alerte en dépende.

À quoi ressemble un message

  • Une carte avec un titre formé du nom du ping et d’un point qui montre son état, de la couleur correspondante : rouge en cas de panne, jaune s’il est dégradé, vert une fois rétabli.
  • La raison, s’il y en a une : le statut HTTP, l’erreur ou la raison de l’échec d’une vérification de contenu.
  • Où cela a été vu : l’emplacement, comme Depuis de, ou, pour un ping vérifié depuis plusieurs, lesquels sont en échec, comme En panne depuis de, sg (2 sur 3 emplacements).
  • Un bouton, Voir le ping dans Pingsured, qui ouvre le ping.

Un changement de certificat s’écrit Certificat changé sur le ping, ou Certificat inattendu sur lui quand le changement ne ressemble pas à un renouvellement, avec les raisons en dessous.

La langue des messages

Les messages sont rédigés dans la langue des notifications du compte, qu’un propriétaire règle sous Paramètres → Compte. Ils existent en anglais, allemand, espagnol, français et italien. Tant qu’elle n’est pas réglée, ils sont en anglais. Le même réglage est la langue de repli des e-mails d’alerte pour les membres qui n’ont pas choisi la leur. La ligne de la raison s’affiche telle que le service vérifié l’a rapportée, dans sa langue.

Quand les messages sont envoyés

Un canal Teams suit les mêmes règles que tout autre canal d’alerte : quels changements, combien d’échecs d’abord, à quelle fréquence et depuis où sont décrits dans la page des notifications. Un changement d’état est toujours envoyé aussitôt, et les alertes répétées pour le même ping et le même canal sont retenues 15 minutes.

Si un message n’arrive pas

Teams accuse normalement réception d’une requête avant que le workflow ait tourné : Pingsured affiche donc un envoi comme envoyé dès que Teams l’a accepté. Un workflow qui échoue ensuite, parce qu’il a été désactivé, que son propriétaire est parti ou que le canal a été supprimé, apparaît dans l’historique des exécutions du workflow, dans l’application Workflows, et non dans Pingsured.

Quand Teams est injoignable, retient la requête (il n’en admet que quelques-unes par seconde) ou répond par une erreur qui peut passer, l’envoi est retenté, 5 tentatives en tout, espacées de 30 secondes, 5 minutes, 30 minutes et 2 heures. Toute autre réponse est définitive, et Pingsured affiche ce que Teams a dit en survolant le badge d’état à côté du canal dans Paramètres → Notifications. Le remède est le plus souvent un nouveau workflow : créez-le dans Teams, ajoutez-le dans Pingsured et supprimez l’ancien.

Limites

  • Les canaux Teams comptent avec les webhooks pour les mêmes limites : 50 pour tout le compte et 20 sur un ping.
  • Les messages sont publiés par l’application Workflows, et non sous un nom et une icône de votre choix. Les mentions, les messages privés et les fils de discussion ne sont pas encore disponibles.