Dokumentation
Microsoft Teams-Benachrichtigungen und -Berichte
Erstellen Sie einen Workflows-Webhook in einem Teams-Kanal, fügen Sie ihn in AutoPSEO hinzu und erhalten Sie Benachrichtigungen und geplante Berichte als Adaptive Cards, die nach Schweregrad eingefärbt sind.
AutoPSEO sendet Nachrichten über einen Workflows-Webhook an Microsoft Teams. Teams stellt Ihnen eine URL bereit, die in einen einzelnen Kanal postet, und Sie fügen diese URL in AutoPSEO als Teams-Kanal hinzu. Benachrichtigungen, geplante Berichte, Testnachrichten und einmalige Berichtszusammenfassungen erscheinen dann als Adaptive Cards, deren Titel nach Schweregrad eingefärbt ist und die eine Schaltfläche zurück zum Bericht enthalten. Sie benötigen keinen Slack-Workspace, und in Teams muss keine AutoPSEO-App installiert werden.
Webhook-URL aus Teams abrufen
Die Anleitung von Microsoft für eingehende Webhooks erstellt die URL mit der Workflows-App:
- Wechseln Sie in Teams zu dem Kanal, der die Karten erhalten soll, und wählen Sie daneben Weitere Optionen (...).
- Wählen Sie Workflows und anschließend eine Webhook-Vorlage. Microsoft nennt sie derzeit Webhook-Benachrichtigungen an einen Kanal senden; der Hinweis von AutoPSEO auf der Einstellungsseite verwendet noch die ältere Bezeichnung Post to a channel when a webhook request is received.
- Prüfen Sie das Team und den Kanal, die die Vorlage vorausgefüllt hat, und klicken Sie auf Speichern.
- Kopieren Sie den Webhook-Link, den der Workflow anzeigt.
Eine URL des älteren Incoming-Webhook-Connectors (auf webhook.office.com) wird weiterhin akzeptiert. Microsoft stellt die Microsoft 365 Connectors ein und wird das Anlegen neuer Connectors blockieren. Verwenden Sie daher für alles, was Sie jetzt einrichten, Workflows.
Kanal in AutoPSEO hinzufügen
- Klicken Sie im Bereich Microsoft Teams unter Slack, Teams & Webhooks auf Neuer Teams-Kanal. Das Formular öffnet sich mit Microsoft Teams als Ziel.
- Geben Sie einen Namen ein, den Sie wiedererkennen, und fügen Sie die URL ein. Für einen Teams-Eintrag akzeptiert AutoPSEO Workflows- und Connector-Adressen (Hosts wie
logic.azure.com,powerautomate.com,azure-api.netundwebhook.office.com) und lehnt andere Hosts ab. - Klicken Sie auf Kanal hinzufügen und dann in der zugehörigen Zeile auf Test senden. Im Kanal sollte eine Karte erscheinen, deren Titel dem Namen des Eintrags entspricht.
- Erstellen Sie einen geplanten Bericht oder eine Benachrichtigung und wählen Sie diesen Kanal aus.
Eine Regel sendet an genau einen Kanal. Soll dieselbe Benachrichtigung in Slack und in Teams eingehen, legen Sie die Regel zweimal an, einmal für jedes Ziel.
Aufbau der Karte
Jede Nachricht wird zu einer Adaptive Card (Version 1.4, volle Breite), eingebettet in den message-Umschlag mit einem application/vnd.microsoft.card.adaptive-Anhang, wie ihn auch die Beispiele von Microsoft verwenden.
- Titel in großer, fetter Schrift. Bei Benachrichtigungen verwendet die Karte für kritisch und hoch die Farbe Attention, für mittel Warning und für niedrig die Standardfarbe; Berichte und Tests verwenden die Farbe Accent.
- Zusammenfassung: derselbe Satz, den eine Slack-Nachricht enthält, einschließlich des Datumsfensters.
- Fakten: bis zu 12 beschriftete Werte, etwa Klicks und deren Veränderung oder der aktuelle Wert einer Benachrichtigung im Vergleich zur Baseline.
- Tabelle: für Berichte und Berichtszusammenfassungen, bis zu zehn Zeilen in einer Festbreitenschrift.
- Fußzeile: die Property, ein Hinweis, dass die Daten der Search Console etwa einen Tag verzögert vorliegen und nur abgeschlossene Tage gezählt werden, sowie der Absender.
- Bericht öffnen: eine Schaltfläche, die zum passenden Bericht in AutoPSEO führt.
Warum eine Karte nicht angekommen ist
Test senden meldet einen Fehler sofort; bei geplanten Nachrichten speichert der Zustellungsverlauf die Antwort, die Teams gegeben hat.
| Was Sie sehen | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| „That does not look like a Teams Workflows or Incoming Webhook URL“ beim Speichern | Die URL liegt nicht auf einem Workflows- oder Connector-Host | Kopieren Sie den Link erneut aus dem Workflow |
| HTTP 400 bei Test senden | Doch kein Teams-Webhook: eine Slack-URL, ein Zapier-Hook oder ein Workflow, der so bearbeitet wurde, dass er einen anderen Body erwartet | Erstellen Sie einen neuen Workflow aus der Vorlage und fügen Sie dessen URL hinzu |
| Zeitüberschreitung nach 10 Sekunden | Teams hat nicht rechtzeitig geantwortet | Versuchen Sie es später erneut |
| Weiterleitungen werden nicht verfolgt | Die URL leitet an eine andere Adresse weiter | Fügen Sie stattdessen die endgültige URL hinzu |
| Die Karten blieben aus, nachdem ein Kollege das Unternehmen verlassen hat | Microsoft bindet jeden Workflow an die Personen, denen er gehört, und ein Workflow ohne Eigentümer kann ausfallen | Fügen Sie dem Workflow weitere Eigentümer hinzu oder erstellen Sie ihn neu |
Ein fehlgeschlagener geplanter Bericht wird im selben Zeitraum nicht erneut gesendet: Beheben Sie die Ursache und verwenden Sie Jetzt senden.
Wann stattdessen ein Webhook sinnvoll ist
Teams und ausgehende Webhooks können dieselben Regeln bedienen, richten sich aber an unterschiedliche Empfänger. Ein Teams-Kanal ist für Menschen gedacht: eine formatierte Karte, ohne dass Sie etwas entwickeln müssen. Ein Webhook ist für Software gedacht: das rohe Ereignis als signiertes JSON für Zapier, Make, n8n oder Ihren eigenen Dienst. Teams erwartet eine Karte und nicht das Ereignis-JSON von AutoPSEO, daher gehört eine Teams-URL immer unter Microsoft Teams.
Einen Überblick darüber, was Teams-Nutzer erhalten, finden Sie auf der Microsoft Teams-Seite.