Zum Hauptinhalt springen
Wirespeed kann Benachrichtigungen in einem Slack-Kanal veröffentlichen. Sie erstellen in einer Slack-App einen Incoming-Webhook für den Kanal und fügen dessen URL dann in Wirespeed als Slack-Kanal hinzu. Zum Verwalten von Slack-Kanälen, für Testsendungen und zum Auswählen der Benachrichtigungen für jeden Kanal benötigen Sie die Rolle Administrator. Andere Benutzer können einen Kanal öffnen und sehen ein schreibgeschütztes Formular, den Status und den Zustellverlauf, ohne Test senden. Slack-Kanäle sind für teamweite Benachrichtigungen gedacht. Wirespeed benötigt über den Webhook hinaus keinen Zugriff auf Ihren Slack-Workspace, daher gibt es weder eine OAuth-Installation noch einen Bot, der in den Kanal eingeladen werden muss. Für Workflows, die im Workflow Builder von Slack erstellt wurden, oder für eine benutzerdefinierte Payload verwenden Sie stattdessen den Benachrichtigungskanal „Webhooks“. Webhook-URLs von Slack-Workflows werden hier nicht akzeptiert.

​
Unterstützte Benachrichtigungstypen

Slack-Kanäle können die folgenden Benachrichtigungstypen empfangen:
  • Neuer eskalierter Fall
  • Neuer automatisch eingedämmter Fall
  • Neues System-Sicherheitsereignis
  • Neuer kritischer Mangel
  • Integrationsstatus
  • Konto & Abrechnung
Die Aktivitätsübersicht wird nur per E-Mail gesendet. Slack-Kanäle erhalten jede Benachrichtigung in Echtzeit; die Häufigkeitseinstellungen gelten nur für E-Mails.

​
Bevor Sie beginnen

Sie benötigen die Berechtigung, in Ihrem Slack-Workspace Apps zu erstellen, oder eine Administratorin bzw. einen Administrator, der den Webhook für Sie erstellen kann.

​
Schritt 1: Webhook in Slack erstellen

  1. Öffnen Sie api.slack.com/apps und wählen Sie Create New App und dann From scratch. Benennen Sie die App (zum Beispiel „Wirespeed“) und wählen Sie Ihren Workspace. Wenn Sie bereits eine App für Wirespeed haben, öffnen Sie diese stattdessen.
  2. Öffnen Sie in den Einstellungen der App Incoming Webhooks und schalten Sie Activate Incoming Webhooks ein.
  3. Wählen Sie Add New Webhook to Workspace, wählen Sie den Kanal, in dem Wirespeed veröffentlichen soll, und wählen Sie Allow.
  4. Kopieren Sie die Webhook-URL. Sie beginnt mit https://hooks.slack.com/services/.
Jeder Webhook veröffentlicht in dem einen Kanal, den Sie beim Erstellen gewählt haben. Um in mehreren Kanälen zu veröffentlichen, fügen Sie für jeden einen Webhook hinzu und speichern Sie jeden als eigenen Slack-Kanal in Wirespeed.
Slack kann diese Ansichten ändern. Wenn Ihre Ansicht davon abweicht, folgen Sie der Anleitung von Slack: Sending messages using incoming webhooks.
Die Webhook-URL ist die einzige Zugangsinformation, die zum Veröffentlichen im Kanal benötigt wird: Wer sie hat, kann dort Nachrichten veröffentlichen. Behandeln Sie sie wie ein Passwort und fügen Sie sie nicht in Tickets, Chats oder Screenshots ein. Slack kann eine Webhook-URL außerdem widerrufen, wenn sie öffentlich im Internet auftaucht. Falls sie offengelegt wurde, entfernen Sie den Webhook in den Einstellungen Ihrer Slack-App, erstellen Sie einen neuen und fügen Sie dessen URL beim Kanal in Wirespeed ein.

​
Schritt 2: Kanal in Wirespeed hinzufügen

  1. Navigieren Sie zu Einstellungen > Benachrichtigungen.
  2. Wählen Sie auf der Karte Slack die Option Verbinden. Wenn Ihr Team bereits Slack-Kanäle hat, wählen Sie stattdessen das Zahnradsymbol (⚙, Slack-Kanäle verwalten).
  3. Wählen Sie Slack-Kanal hinzufügen.
  4. Geben Sie einen Namen ein. Benennen Sie jeden Webhook nach seinem Slack-Kanal, zum Beispiel #security-alerts, damit Sie sie unterscheiden können. Der Name wird im Slack-Dropdown angezeigt, wenn Sie eine Benachrichtigung einrichten.
  5. Fügen Sie die in Schritt 1 kopierte Webhook-URL ein.
  6. Wählen Sie optional Test senden, um eine Testnachricht zu veröffentlichen.
  7. Wählen Sie Speichern.
Wirespeed speichert die Webhook-URL verschlüsselt. Nach dem Speichern können Sie sie ersetzen, aber nicht anzeigen. Jede Webhook-URL kann pro Team nur als ein Slack-Kanal gespeichert werden. Wenn Sie einen Kanal bearbeiten, zeigt das Feld Webhook-URL anstelle der gespeicherten URL •••••••• an. Lassen Sie es unverändert, um die gespeicherte URL beizubehalten, oder fügen Sie eine neue URL ein, um sie zu ersetzen.

​
Test senden

Test senden sendet eine Beispielbenachrichtigung an diesen Webhook. Wenn Sie eine neue URL eingegeben haben, verwendet der Test diese URL, andernfalls die gespeicherte. Wenn Sie die URL ändern, wird das vorherige Ergebnis zurückgesetzt. Von Slack angenommen bedeutet, dass Slack die Anfrage angenommen hat, und die Nachricht sollte in Kürze im Kanal erscheinen. Wirespeed erlaubt bis zu 5 Testsendungen pro Team und Minute.

​
Schritt 3: Zu sendende Benachrichtigungen auswählen

  1. Suchen Sie unter Einstellungen > Benachrichtigungen den Benachrichtigungstyp in der Karte Benachrichtigungen für das Teamkonto.
  2. Wählen Sie das Zahnradsymbol (⚙, Konfigurieren), um den Konfigurationsdialog zu öffnen.
  3. Schalten Sie den Schalter Slack-Kanal ein und wählen Sie unter Slack-Kanal auswählen einen Ihrer Kanäle. Weitere Kanäle, bis zu 10, fügen Sie mit Weiteren Kanal hinzufügen hinzu.
  4. Speichern Sie Ihre Änderungen.
Ein Kanal, der für diesen Benachrichtigungstyp bereits ausgewählt ist, den Sie ausgeschaltet haben oder den Wirespeed nach fehlgeschlagenen Zustellungen deaktiviert hat, kann nicht ausgewählt werden. Das Menü kennzeichnet ihn mit Bereits ausgewählt, Ausgeschaltet oder Nach Fehlern deaktiviert. Um einen Kanal wieder einzuschalten oder das Problem zu beheben, wählen Sie unten im Menü Slack-Kanäle verwalten. Wenn Ihr Team noch keine Slack-Kanäle hat, heißt der Abschnitt Slack und zeigt stattdessen Verbinden an. Service Provider konfigurieren Kundenteams genauso wie E-Mail-Postfächer. Slack-Kanal-Abonnements Ihres Service-Provider-Teams verhalten sich wie Ihre anderen Service-Provider-Abonnements: Sie gelten automatisch für alle Ihre Kundenkonten, sodass der Kanal Benachrichtigungen für jedes Kundenteam erhält und alle Mitglieder des Kanals sie sehen. Um die Benachrichtigungen eines einzelnen Kundenteams an einen eigenen Kanal zu senden, richten Sie diesen ein, während Sie das Kundenteam aufrufen. Siehe Verhalten bei Service Providern.

​
Kanalstatus

Die Seite Slack-Kanäle listet jeden Kanal mit seinem Status auf. Alle Personen in Ihrem Team mit Zugriff auf die Benachrichtigungseinstellungen können Status, Anzahl der Fehler, letzten Fehler und Zustellverlauf sehen. Nur Administratoren können einen Kanal ändern.

​
Automatische Deaktivierung

Wirespeed deaktiviert einen Slack-Kanal nach drei fehlgeschlagenen Zustellungen ohne erfolgreiche Zustellung dazwischen. Dabei zählen nur diese Fehler:
  • Slack lehnt die URL oder die Berechtigungen des Webhooks ab (HTTP 401 oder 403, zum Beispiel invalid_token oder action_prohibited).
  • Der Webhook existiert nicht mehr oder sein Kanal wurde gelöscht (HTTP 404 oder 410, zum Beispiel no_service oder channel_not_found).
  • Slack meldet, dass der Webhook nicht mehr posten kann, bei anderen 4xx-Fehlern: Der Kanal wurde archiviert (channel_is_archived), die App oder der Workspace wurde entfernt oder deaktiviert (no_active_hooks, no_team, team_disabled) oder das Posten dort ist untersagt (posting_to_general_channel_denied, user_not_found).
Eine erfolgreiche Zustellung setzt den Zähler zurück. Ausfälle bei Slack, Ratenbegrenzungen und Zeitüberschreitungen zählen nie zur Deaktivierung eines Kanals und setzen den Zähler auch nicht zurück; Wirespeed wiederholt diese Zustellungen stattdessen. Testsendungen zählen nicht. Wenn ein Kanal deaktiviert ist, sind seine Abonnements pausiert. Sie werden fortgesetzt, sobald Sie den Kanal wieder aktivieren.

​
Kanal wieder aktivieren

  1. Wählen Sie auf der Seite Slack-Kanäle beim deaktivierten Kanal Wieder aktivieren. Der Dialog zeigt in einem roten Banner den letzten Fehler und wie er behoben wird.
  2. Beheben Sie die Ursache in Slack (siehe Fehlerbehebung). Wenn Sie einen neuen Webhook erstellt haben, fügen Sie dessen URL unter Webhook-URL ein.
  3. Wählen Sie im roten Banner Wieder aktivieren oder über der Fußzeile Test senden (nach einem fehlgeschlagenen Test heißen beide Erneut versuchen), um eine Testnachricht an die URL zu senden, die gespeichert wird. Wenn Sie die URL geändert haben, verwendet der Test die neue URL.
  4. Sobald der Test erfolgreich ist, wird das rote Fehlerbanner grau und ein grünes Banner Der Kanal ist in einem fehlerfreien Zustand. erscheint. Wählen Sie im grünen Banner Wieder aktivieren oder in der Fußzeile Änderungen speichern, um zu speichern.
Ein erfolgreicher Test ist erforderlich. Änderungen speichern bleibt deaktiviert, bis der Test der URL, die gespeichert wird, erfolgreich war. Wenn Sie die URL ändern, wird das Ergebnis zurückgesetzt und Sie müssen erneut testen. Tritt das Problem nach dem Wiederaktivieren erneut auf, wird der Kanal nach drei weiteren fehlgeschlagenen Zustellungen erneut deaktiviert. Um einen Kanal selbst zu pausieren oder fortzusetzen, verwenden Sie seinen Schalter Aktiviert.

​
Zustellverlauf

Öffnen Sie einen Kanal, indem Sie seine Zeile oder in der Zeile das Menü … (Aktionen) und dann Bearbeiten (ohne Administratorrolle Anzeigen) wählen, und wählen Sie Zustellverlauf anzeigen. Der Dialog zeigt die 100 neuesten Zustellungen, Testsendungen und Statusänderungen mit Zeit, Ereignis, Typ, Ergebnis und Versuch der jeweiligen Zeile. Nur Tests der gespeicherten URL des Kanals erscheinen. Ein Test einer eingegebenen, aber nicht gespeicherten URL wird nicht erfasst.

​
Grenzwerte

Antwortet Slack, dass ein Webhook den Grenzwert überschreitet (HTTP 429), pausiert Wirespeed die Zustellung an diesen Kanal für die von Slack geforderte Wartezeit (höchstens 5 Minuten, und 30 Sekunden, wenn Slack keine angibt) und sendet danach die ausstehenden Nachrichten. Die Drosselung zählt nicht für das Deaktivieren des Kanals. Eine Benachrichtigung, die nicht innerhalb von etwa 6 Stunden zugestellt werden kann, wird verworfen, statt verspätet einzutreffen. Text, der länger ist, als Slack zulässt, wird mit einer Ellipse gekürzt. Eine Nachricht mit mehr Inhalt, als das Blocklimit von Slack zulässt, wird abgeschnitten und endet mit einem Hinweis auf die vollständigen Details in Wirespeed.

​
Fehlerbehebung

​
Fehler beim Speichern der URL

​
Ergebnisse von „Test senden“

​
Fehlerhafte oder deaktivierte Kanäle

Der Status-Tooltip und der Dialog, den Wieder aktivieren öffnet, zeigen den letzten Fehler und einen Hinweis.

​
Kanal bearbeiten, ersetzen oder löschen

  • Umbenennen oder URL ersetzen: Wählen Sie die Zeile des Kanals oder in der Zeile das Menü … (Aktionen) und dann Bearbeiten. Ändern Sie den Namen oder fügen Sie eine neue URL ein, und wählen Sie dann Aktualisieren. Lassen Sie das URL-Feld unverändert, um die aktuelle URL zu behalten. Wenn Sie die URL eines fehlerhaften Kanals ersetzen, wird sein Fehlerstatus zurückgesetzt. Ein Kanal, den Sie ausgeschaltet haben, bleibt ausgeschaltet.
  • Nach fehlgeschlagenen Zustellungen deaktivierte Kanäle öffnen sich mit einer Schaltfläche Wieder aktivieren im roten Banner, die einen Test sendet, und die Speichern-Schaltfläche heißt Änderungen speichern. Sie bleibt deaktiviert, bis ein Test der URL, die gespeichert wird, erfolgreich war. Beim Speichern wird der Kanal dann wieder aktiviert, mit oder ohne neue URL.
  • Löschen: Wählen Sie in der Zeile das Menü … (Aktionen) und dann Löschen. Beim Löschen eines Kanals werden auch die Abonnements gelöscht, die Benachrichtigungen an ihn senden. Dies kann nicht rückgängig gemacht werden.