Dokumentation
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.
AutoPSEO postet über Incoming Webhooks in Slack. Slack stellt Ihnen eine URL bereit, die in genau einen Kanal schreibt. Diese URL fügen Sie in AutoPSEO ein, und Berichte und Benachrichtigungen landen von da an dort. AutoPSEO selbst installiert nichts in Ihrem Workspace: Es kann keine Nachrichten lesen, keine Kanäle auflisten und nirgendwo posten, wohin der Webhook nicht zeigt. Legen Sie für jeden Kanal, in dem Nachrichten erscheinen sollen, einen eigenen Eintrag an.
Webhook in Slack erstellen
Slack stellt Incoming Webhooks über eine Slack-App aus. Gemäß der Anleitung von Slack zu Incoming Webhooks:
- Erstellen Sie eine Slack-App für Ihren Workspace oder öffnen Sie eine App, die Sie bereits für Benachrichtigungen nutzen. Wählen Sie einen Namen, den Ihr Team wiedererkennt, etwa SEO-Berichte.
- Öffnen Sie in den Einstellungen der App den Bereich Incoming Webhooks und aktivieren Sie Activate Incoming Webhooks.
- Klicken Sie auf Add New Webhook to Workspace, wählen Sie den Kanal aus und bestätigen Sie. Für einen privaten Kanal müssen Sie zuvor Mitglied sein.
- Kopieren Sie die neue URL unter Webhook URLs for Your Workspace. Sie beginnt mit
https://hooks.slack.com/services/.
Wiederholen Sie die Schritte 3 und 4 für jeden weiteren Kanal; eine App kann mehrere Webhooks enthalten. Auch eine URL aus Slacks älteren benutzerdefinierten Integrations-Webhooks funktioniert weiterhin, Slack empfiehlt allerdings, diese auf eine App umzustellen.
Slack behandelt die URL als Geheimnis: Jeder, der sie kennt, kann in den Kanal posten. Fügen Sie sie in AutoPSEO ein und halten Sie sie aus Tickets, Wikis und Screenshots heraus.
In AutoPSEO hinzufügen
- Suchen Sie unter Slack, Teams & Webhooks den Bereich Slack - Connected workspaces und klicken Sie auf Add to Slack. Das Formular New channel öffnet sich, wobei Slack bereits als Ziel ausgewählt ist.
- Name: eine Bezeichnung für die Listen in AutoPSEO, den Zustellverlauf und die Testnachricht, zum Beispiel
#seo-alerts. - Webhook URL: Fügen Sie die Slack-URL ein. Für einen Slack-Eintrag akzeptiert AutoPSEO nur
https-Adressen auf slack.com und weist Sie sofort darauf hin, wenn die URL nicht passt. - Klicken Sie auf Add channel und dann in der neuen Zeile auf Send test. Innerhalb weniger Sekunden sollte in Slack eine kurze Nachricht mit dem Namen des Eintrags erscheinen; AutoPSEO zeigt außerdem an, wie lange Slack für die Antwort gebraucht hat.
Die URL wird verschlüsselt gespeichert (AES-GCM). Danach zeigt die Liste nur noch den Host und die letzten Zeichen an. Wählen Sie daher Namen, aus denen hervorgeht, welchen Slack-Kanal der jeweilige Eintrag bedient.
Als Nächstes geben Sie dem Eintrag etwas zum Posten: einen geplanten Bericht oder eine Benachrichtigung. Die Tabelle Slack - Subscriptions unterhalb der Liste zeigt dann pro Slack-Kanal jede Regel, die dort postet, ihren Zeitplan und ob sie aktiv oder pausiert ist.
Mehrere Kanäle und Workspaces
Eine Webhook-URL gehört zu genau einem Kanal in einem Workspace, und Slack erlaubt es nicht, den Kanal, für den sie erstellt wurde, in einer Nachricht zu überschreiben. Das hält alles gut vorhersehbar:
- Ein Slack-Kanal, ein Eintrag. Wenn Sie Kunden auf
#client-aund#client-baufteilen möchten, erstellen Sie für jeden einen Webhook und fügen Sie beide hinzu. - Mehrere Workspaces funktionieren genauso, da jeder Webhook in dem Workspace liegt, in dem Sie ihn erstellt haben.
- Ein Eintrag kann viele Regeln tragen. Senden Sie den Wochenbericht und die Benachrichtigung bei Traffic-Einbrüchen an denselben Eintrag, oder legen Sie Benachrichtigungen in einen eigenen, belebteren Kanal.
Warum eine Nachricht nicht ankam
Send test zeigt den Grund sofort an. Bei geplanten Nachrichten öffnen Sie Delivery history; dort wird Slacks Antwort für jeden fehlgeschlagenen Versuch festgehalten.
| Was AutoPSEO anzeigt | Bedeutung | Was zu tun ist |
|---|---|---|
| Slack rejected the URL (no_service) | Der Webhook wurde in Slack entfernt oder deaktiviert, oder die URL enthält einen Tippfehler | Neuen Webhook erstellen, hinzufügen und danach den alten Eintrag löschen |
| The Slack channel no longer exists, or is archived | Slack antwortete mit channel_not_found oder channel_is_archived | Einen Webhook für einen Kanal erstellen, der noch genutzt wird |
| Slack is rate limiting us | Slack antwortete mit HTTP 429 | Kurz warten und dann Send now oder Test rule verwenden |
| Timed out after 10 seconds | Slack hat nicht rechtzeitig geantwortet | Später erneut versuchen |
| Your trial has ended | Kein aktiver Tarif und keine aktive Testphase | Einen Tarif wählen; geplante Zustellungen werden damit fortgesetzt |
Ein fehlgeschlagener geplanter Bericht wird im selben Zeitraum nicht erneut gesendet. Verwenden Sie daher Send now, sobald die Ursache behoben ist. Eine Benachrichtigung, die nicht gepostet werden konnte, wird bei der nächsten Prüfung erneut ausgewertet (wann Benachrichtigungen ausgeführt werden).
Slack-Kanal entfernen
Delete in der Zeile des Eintrags entfernt die gespeicherte URL und, nach einer Bestätigungsabfrage, die Ihnen die Anzahl nennt, auch jede Regel, die dort postet. AutoPSEO ändert nichts in Slack: Der Webhook funktioniert weiter, bis jemand ihn in der Slack-App entfernt. Tun Sie das daher ebenfalls, wenn die URL möglicherweise von anderen gesehen wurde.