Dokumentation
Slack, Teams & Webhooks
Senden Sie geplante Search Console-Berichte und Benachrichtigungen an Slack, Microsoft Teams oder einen beliebigen HTTPS-Endpunkt. Alles wird auf einer Seite verwaltet, inklusive Zustellprotokoll.
AutoPSEO kann seine Kennzahlen auf zwei Wegen aus der App heraustragen: über geplante Berichte mit den wichtigsten Search Console-Zahlen einer Property und über Benachrichtigungen, die ausgelöst werden, sobald ein Detektor Veränderungen bei Klicks, CTR, Positionen, Indexierung, getrackten Rankings oder Audits erkennt. Beides läuft über einen Kanal, den Sie einmalig anlegen: einen eingehenden Slack-Webhook, eine Microsoft Teams-Workflows-URL oder einen beliebigen öffentlichen HTTPS-Endpunkt, der signiertes JSON akzeptiert. Sie verwalten alles auf einer einzigen Seite.
Wo Sie die Funktion finden
Öffnen Sie in der linken Seitenleiste Slack, Teams & Webhooks, oder gehen Sie zu Konto und wählen Sie bei der Karte „Slack, Teams & Webhooks" die Option Verwalten (in der App öffnen). Die Seite enthält je einen Abschnitt pro Ziel (Slack - Verbundene Workspaces, Microsoft Teams, Ausgehende Webhooks), gefolgt von Geplante Berichte, Benachrichtigungen und Zustellverlauf.
Kanäle, Regeln und Zustellungen
Die Funktion besteht aus drei Bausteinen.
- Kanal: eine Ziel-URL, gekennzeichnet als Slack, Microsoft Teams oder Webhook. AutoPSEO speichert die URL verschlüsselt und zeigt danach nur noch den Host und die letzten Zeichen an. Ein Konto kann 25 Kanäle enthalten.
- Regel: ein geplanter Bericht oder eine Benachrichtigung, die genau einem Kanal zugeordnet ist. Ein Kanal kann beliebig viele Regeln speisen, pro Konto sind es bis zu 50 Regeln. Wenn dieselbe Benachrichtigung in Slack und in Teams ankommen soll, legen Sie zwei Regeln an.
- Zustellung: ein einzelner Versuch, eine Nachricht zu senden. Der Zustellverlauf speichert die letzten 50 Versuche über alle Kanäle hinweg, einschließlich Tests und einmaliger Zusammenfassungen, jeweils mit Status (gesendet, fehlgeschlagen oder übersprungen), HTTP-Status, der Antwortzeit des Ziels und dem Grund, den ein Fehler angegeben hat.
Kanäle und Regeln gehören zu Ihrem eigenen Login. Wer im Team Benachrichtigungen in einem eigenen Kanal erhalten möchte, richtet diese selbst ein.
Vom Start bis zur ersten Nachricht
- Verbinden Sie die Search Console-Properties, über die berichtet werden soll (Search Console verbinden). Die Demo-Property erscheint in jeder Auswahl, sodass Sie eine Regel ausprobieren können, bevor Ihre eigenen Daten vorliegen.
- Fügen Sie einen Kanal mit Add to Slack, Neuer Teams-Kanal oder Neuer Webhook hinzu: Vergeben Sie einen Namen und fügen Sie die URL ein. Woher Sie die jeweilige URL bekommen, erfahren Sie hier: Slack, Microsoft Teams, Webhooks.
- Klicken Sie in der Zeile des Kanals auf Test senden und prüfen Sie, ob die Nachricht angekommen ist.
- Erstellen Sie eine Regel mit Neuer geplanter Bericht oder Neue Benachrichtigung. Beide Schaltflächen bleiben ausgegraut, solange noch kein Kanal existiert.
Wann Nachrichten gesendet werden
Zu Beginn jeder vollen Stunde (UTC) läuft ein Job, der ermittelt, was fällig ist.
| Nachricht | Zeitpunkt des Versands |
|---|---|
| Geplanter Bericht | Zur gewählten Stunde, täglich, wöchentlich oder monatlich, höchstens einmal pro Zeitraum |
| Benachrichtigung zu Klicks, CTR, Position, verlorenen Suchanfragen, Rank-Tracking oder Audits | Einmal täglich geprüft, im Lauf um 06:00 UTC |
| Benachrichtigung zu Indexwechseln | Stündlich geprüft |
| Test senden, Jetzt senden, Regel testen | Sofort |
| An Slack senden auf einer Berichtsseite | Sofort (AutoPSEO in Slack nutzen) |
Die Zeiträume für Berichte und Benachrichtigungen enden am Tag vor dem Lauf, da die Search Console ihre Daten mit Verzögerung veröffentlicht. Jede Nachricht nennt die verwendeten Datumsangaben, sodass niemand raten muss.
Voraussetzungen
- Ein aktiver Tarif oder eine laufende Testphase. Endet die Testphase ohne Tarif, werden geplante Berichte und Benachrichtigungen eingestellt. Neue Kanäle, Regeländerungen, Tests und Sendungen werden abgelehnt, bis Sie einen Tarif wählen (Tarife und Abrechnung).
- Ein Ziel, das Sie kontrollieren: die Berechtigung, in Slack einen eingehenden Webhook anzulegen, einen Workflows-Webhook in einem Teams-Kanal einzurichten oder einen eigenen HTTPS-Endpunkt zu betreiben.
Wer den Kanal lesen kann
Jede Nachricht enthält Daten zur Suchleistung: Klicks, Impressionen, Suchanfragen und Seitenadressen. Jeder, der den Slack- oder Teams-Kanal oder das System hinter einem Webhook lesen kann, sieht diese Daten. Veröffentlichen Sie Kundenproperties daher in privaten Kanälen. Auch die Ziel-URL ist geheim: Wer sie kennt, kann in Ihren Kanal posten, wie Slack bei seinen Webhooks hervorhebt. Deshalb zeigt AutoPSEO sie nach dem Speichern nie wieder an.
Weiterlesen
- Slack über einen eingehenden Webhook verbinden: die URL in Slack erstellen, hinzufügen und die Fehler, die Slack zurückgeben kann.
- Geplante Berichte: Berichtstypen, Zeiträume, Rhythmus und die Regel „einmal pro Zeitraum".
- Benachrichtigungen: die neun Detektoren, Schwellenwerte, Schweregrad und Stummschaltung.
- AutoPSEO in Slack nutzen: was eine Nachricht enthält und wie An Slack senden funktioniert.
- Microsoft Teams: Workflows-URLs und Adaptive Cards.
- Ausgehende Webhooks: der JSON-Body, die Ereignistypen und die Signaturprüfung.
Produktübersichten: AutoPSEO für Slack und AutoPSEO für Microsoft Teams.
In diesem Abschnitt
Slack mit einem Incoming Webhook verbinden
Erstellen Sie einen Slack-Incoming-Webhook für einen Kanal, fügen Sie ihn in AutoPSEO hinzu, senden Sie eine Testnachricht und beheben Sie die Fehler, die Slack bei fehlgeschlagenen Posts zurückgibt.
Geplante Berichte in Slack, Teams oder per Webhook
Senden Sie Klicks, Impressionen, CTR und Position einer Property samt Top-Suchanfragen, Top-Seiten oder Ranking-Veränderungen täglich, wöchentlich oder monatlich in einen Kanal.
Alerts: Detektoren, Schwellenwerte und Schweregrad
Neun Detektoren überwachen Klicks, CTR, Position, verlorene Suchanfragen, Indexierungswechsel, Rankings und Audits und senden nur dann eine Nachricht an einen Kanal, wenn ein Schwellenwert überschritten wird.
AutoPSEO in Slack verwenden
Was die Slack-Nachrichten von AutoPSEO enthalten, wie Sie mit „An Slack senden“ jede Berichtstabelle in einen Kanal posten und was Sie in Slack selbst tun können und was nicht.
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.
Ausgehende Webhooks: Payload und Signatur
Empfangen Sie AutoPSEO-Alerts und -Berichte als signiertes JSON an einem beliebigen HTTPS-Endpunkt: die Request-Header, Body-Felder, Ereignistypen und die Prüfung der Signatur.