> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack-Kanäle

> Team-Benachrichtigungen mit einem Incoming-Webhook an einen Slack-Kanal senden

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](https://docs.wirespeed.co/de/settings/notifications.md#benachrichtigungshäufigkeit) 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](https://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.

> [!NOTE]
>
> Slack kann diese Ansichten ändern. Wenn Ihre Ansicht davon abweicht, folgen Sie der Anleitung von Slack: [Sending messages using incoming webhooks](https://api.slack.com/messaging/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](https://docs.wirespeed.co/de/settings/notifications.md#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.

| Status | Was Sie sehen | Bedeutung |
| - | - | - |
| **Aktiv** | Der Schalter **Aktiviert** ist eingeschaltet | Benachrichtigungen werden zugestellt. |
| **Fehlerhaft** | Ein gelbes Warnsymbol neben dem Namen | Kürzliche Zustellungen sind aus einem Grund fehlgeschlagen, der zur Deaktivierung des Kanals zählt. Der Tooltip zeigt, wie viele, zum Beispiel „2 von 3 Zustellungen fehlgeschlagen“. |
| **Ausgeschaltet** | Der Schalter **Aktiviert** ist ausgeschaltet. Bei Kanälen mit Abonnements steht unter der Anzahl der Abonnements außerdem **Inaktiv, solange deaktiviert** | Sie haben den Kanal pausiert. Benachrichtigungen an ihn werden nicht gesendet. |
| **Nach fehlgeschlagenen Zustellungen deaktiviert** | Ein rotes Symbol neben dem Namen und eine Schaltfläche **Wieder aktivieren**. Bei Kanälen mit Abonnements steht außerdem **Inaktiv, bis der Kanal wieder aktiviert wird** | Wirespeed hat den Kanal deaktiviert und seine Abonnements pausiert. |

### 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](#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

| Meldung | Lösung |
| - | - |
| Verwenden Sie eine Slack-Incoming-Webhook-URL ([https://hooks.slack.com/services/…](https://hooks.slack.com/services/…)) | Die URL stammt nicht von den Incoming-Webhooks von Slack. Erstellen Sie den Webhook wie in [Schritt 1](#schritt-1-webhook-in-slack-erstellen) beschrieben. |
| Slack-Workflow-Webhooks werden hier nicht unterstützt. | Die URL gehört zu einem Workflow im Workflow Builder von Slack, der eine andere Payload erwartet. Erstellen Sie einen Incoming-Webhook in einer Slack-App, oder verwenden Sie den Benachrichtigungskanal „Webhooks“ für Workflows und benutzerdefinierte Payloads. |
| Dies ist keine Slack-Incoming-Webhook-URL. | Kopieren Sie die **Webhook-URL** von der Seite **Incoming Webhooks** der App, nicht aus der Adressleiste Ihres Browsers. |
| Geben Sie eine gültige URL ein | Fügen Sie die URL genau so ein, wie Slack sie bereitgestellt hat. |
| Die Webhook-URL muss mit https\:// beginnen | Kopieren Sie die URL erneut, ohne sie zu bearbeiten. |
| Die Webhook-URL muss den Standard-HTTPS-Port verwenden | Kopieren Sie die URL erneut, ohne sie zu bearbeiten. |
| Die Webhook-URL darf keinen Benutzernamen und kein Passwort enthalten | Kopieren Sie die URL erneut, ohne sie zu bearbeiten. |
| Diese Slack-Webhook-URL ist bereits als anderer Slack-Kanal gespeichert | Verwenden Sie den vorhandenen Kanal, oder erstellen Sie für einen zweiten Kanal einen zweiten Webhook. |
| Ein Slack-Kanal mit dem Namen „…“ existiert bereits | Kanalnamen müssen innerhalb eines Teams eindeutig sein, unabhängig von Groß- und Kleinschreibung. Wählen Sie einen anderen Namen. |

### Ergebnisse von „Test senden“

| Meldung | Lösung |
| - | - |
| Slack hat die Anfrage abgelehnt (401, 403, 404 oder ein Fehler wie `no_service`) | Der Webhook wurde widerrufen, die App wurde aus dem Workspace entfernt, oder der Kanal wurde gelöscht oder archiviert. Erstellen Sie einen neuen Webhook und fügen Sie dessen URL ein. |
| Keine Antwort von Slack innerhalb von 10 Sekunden, oder Slack ist nicht erreichbar | Slack ist langsam oder nicht verfügbar. Versuchen Sie es später erneut. |
| Zu viele Testbenachrichtigungen | Warten Sie die angezeigte Zeit ab und versuchen Sie es dann erneut. |

### Fehlerhafte oder deaktivierte Kanäle

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

| Hinweis | Ursache | Lösung |
| - | - | - |
| Der Slack-Kanal wurde gelöscht oder archiviert oder der Webhook wurde widerrufen. | Slack hat `channel_not_found`, `no_service` oder `channel_is_archived` zurückgegeben. | Erstellen Sie einen neuen Incoming-Webhook für den Kanal. Wählen Sie dann beim Kanal **Wieder aktivieren**, fügen Sie die URL ein, senden Sie einen erfolgreichen Test und speichern Sie mit **Änderungen speichern**. |
| Slack hat die Anfrage blockiert. | Slack hat `action_prohibited` zurückgegeben. Die App wurde aus dem Workspace entfernt, der Webhook wurde widerrufen, oder eine Workspace-Einstellung blockiert ihn. | Erstellen Sie einen neuen Incoming-Webhook und fügen Sie dessen URL ein. Hilft das nicht, fragen Sie die Administratorin oder den Administrator Ihres Slack-Workspace, ob eine Einstellung die App einschränkt. |
| Die gespeicherte URL kann nicht verwendet werden. | Wirespeed konnte die gespeicherte URL nicht verwenden. Dies zählt nie zur Deaktivierung eines Kanals. | Fügen Sie die URL erneut ein. Wenden Sie sich an den Support, wenn das Problem wiederholt auftritt. |
| Prüfen Sie den Webhook in den Einstellungen Ihrer Slack-App. | Ein anderer Fehler. | Öffnen Sie die Seite **Incoming Webhooks** der App, beheben Sie das Problem, wählen Sie dann beim Kanal **Wieder aktivieren**, senden Sie einen erfolgreichen Test und speichern Sie mit **Änderungen speichern**. |

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.