Dokumentation

Teams-Benachrichtigungen: Pingsured-Alarme in einen Teams-Kanal

Pingsured kann eine Benachrichtigung in einen Microsoft-Teams-Kanal oder -Chat senden, wenn ein Ping ausfällt, wenn er wieder läuft und wenn sein Zertifikat ersetzt wird. Es ist ein Webhook, der Teams spricht: Sie geben Pingsured die URL eines Teams-Workflows, und jede Benachrichtigung erscheint als Karte in diesem Kanal oder Chat. Teams-Benachrichtigungen gibt es in denselben Tarifen wie Webhooks, also in jedem kostenpflichtigen Tarif. Eingerichtet werden sie von einem Eigentümer oder Manager des Accounts, für einen einzelnen Ping oder als Standard für alle Pings des Accounts.

Was Sie brauchen

  • Ein Microsoft-365-Konto, das in Teams Workflows anlegen darf. Ihre Administration kann die App Workflows abschalten.
  • Den Kanal oder Chat, in den die Benachrichtigungen gehen sollen. Ein Workflow schreibt in genau einen davon; für einen zweiten legen Sie einen zweiten Workflow an.

Den Workflow in Teams anlegen

Microsoft hat den alten, auf Connectors beruhenden „Incoming Webhook“ in Teams im Mai 2026 abgeschaltet. Ein Webhook in Teams ist jetzt ein Workflow, und an den sendet Pingsured.

  • Öffnen Sie in Teams die App Workflows und wählen Sie die Vorlage Post to a channel when a webhook request is received (Microsoft übersetzt den Namen je nach Sprache) oder die Vorlage für einen Chat.
  • Geben Sie dem Workflow einen Namen, zum Beispiel Pingsured, und wählen Sie Team und Kanal oder den Chat, in den er schreiben soll.
  • Kopieren Sie nach dem Anlegen die angezeigte Webhook-URL. Sie ist lang und endet mit einer Signatur, sig=….

Microsoft ändert die Namen seiner Menüs und Vorlagen von Zeit zu Zeit. Pingsured braucht die URL eines Workflows, der startet, wenn eine Webhook-Anfrage eingeht.

Behandeln Sie die URL wie ein Geheimnis: Wer sie kennt, kann in diesen Kanal schreiben. Pingsured zeigt sie nur Eigentümern und Managern vollständig an. Ein Workflow gehört der Person, die ihn angelegt hat, und funktioniert nicht mehr, wenn sie die Organisation verlässt und niemand sonst Besitzer ist; fügen Sie deshalb einen Mitbesitzer hinzu.

In Pingsured hinzufügen

  • Für alle Pings öffnen Sie Einstellungen → Benachrichtigungen, gehen unter Standardbenachrichtigungen zu Integrationen und wählen die Karte Teams.
  • Für einen Ping öffnen Sie den Ping, gehen zum Abschnitt Benachrichtigungen, wählen Benachrichtigung hinzufügen und dann Teams.

Fügen Sie die Webhook-URL vollständig ein, mit Signatur. Pingsured akzeptiert nur Adressen, wie Teams-Workflows sie haben (sie enden auf .logic.azure.com oder .api.powerplatform.com); die URL eines anderen Dienstes oder eine vor der Signatur abgeschnittene URL wird schon beim Speichern abgelehnt. Wählen Sie dann die Auslöser. Empfohlen sind Erster Fehler und Erstes OK, dazu Zertifikat geändert, wenn Sie Zertifikate prüfen: Sie erfahren, wenn etwas ausfällt und wenn es behoben ist.

Mit Test senden neben dem Kanal wird eine als Test gekennzeichnete Nachricht gepostet. So sehen Sie, ob URL und Kanal stimmen, bevor ein echter Alarm darauf angewiesen ist.

So sieht eine Nachricht aus

  • Eine Karte mit einer Überschrift aus dem Namen des Pings und einem Punkt, der den Zustand zeigt, in passender Farbe: rot bei Ausfall, gelb bei Beeinträchtigung, grün nach der Wiederherstellung.
  • Der Grund, wenn es einen gibt: der HTTP-Status, der Fehler oder warum eine Inhaltsprüfung fehlgeschlagen ist.
  • Wo es gesehen wurde: entweder der Standort, etwa Von de, oder bei einem Ping mit mehreren Standorten, welche davon ausfallen, etwa Fehler an de, sg (2 von 3 Standorten).
  • Eine Schaltfläche, Ping in Pingsured ansehen, die den Ping öffnet.

Ein Zertifikatswechsel lautet Zertifikat geändert bei dem Ping, oder Unerwartetes Zertifikat bei ihm, wenn der Wechsel nicht nach einer Erneuerung aussieht, mit den Gründen darunter.

Die Sprache der Nachrichten

Nachrichten sind in der Sprache der Benachrichtigungen des Accounts geschrieben, die ein Eigentümer unter Einstellungen → Account festlegt. Es gibt sie auf Englisch, Deutsch, Spanisch, Französisch und Italienisch. Solange nichts eingestellt ist, sind sie englisch. Dieselbe Einstellung ist die Ausweichsprache für Alarm-E-Mails an Mitglieder, die keine eigene Sprache gewählt haben. Die Grundzeile steht so da, wie der geprüfte Dienst sie gemeldet hat, in dessen Sprache.

Wann Nachrichten gesendet werden

Ein Teams-Kanal folgt denselben Regeln wie jeder andere Benachrichtigungskanal: welche Änderungen, wie viele Fehler zuerst, wie oft und von wo, ist auf der Seite zu den Benachrichtigungen beschrieben. Eine Statusänderung wird immer sofort gesendet, wiederholte Alarme für denselben Ping und Kanal werden 15 Minuten zurückgehalten.

Wenn eine Nachricht nicht ankommt

Teams bestätigt eine Anfrage normalerweise, bevor der Workflow gelaufen ist; Pingsured zeigt eine Zustellung deshalb als gesendet, sobald Teams sie angenommen hat. Ein Workflow, der danach scheitert, weil er abgeschaltet wurde, sein Besitzer gegangen ist oder der Kanal gelöscht wurde, erscheint im Ausführungsverlauf des Workflows in der App Workflows und nicht in Pingsured.

Ist Teams nicht erreichbar, hält es die Anfrage zurück (es erlaubt nur wenige pro Sekunde) oder antwortet mit einem Fehler, der vorübergehen kann, wird die Zustellung wiederholt, insgesamt 5 Versuche im Abstand von 30 Sekunden, 5 Minuten, 30 Minuten und 2 Stunden. Jede andere Antwort ist endgültig, und Pingsured zeigt, was Teams gemeldet hat, wenn Sie in Einstellungen → Benachrichtigungen mit der Maus über das Status-Badge neben dem Kanal fahren. Meist hilft ein neuer Workflow: in Teams anlegen, in Pingsured hinzufügen und den alten entfernen.

Grenzen

  • Teams-Kanäle zählen mit den Webhooks zu denselben Grenzen: 50 für den ganzen Account und 20 pro Ping.
  • Nachrichten werden von der App Workflows gepostet, nicht unter einem Namen und Symbol Ihrer Wahl. Erwähnungen, Direktnachrichten und Threads gibt es noch nicht.