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

# Microsoft-Teams-Kanäle

> Team-Benachrichtigungen mit einem Workflows-Webhook an einen Microsoft-Teams-Kanal senden

Wirespeed kann Benachrichtigungskarten in einem Microsoft-Teams-Kanal veröffentlichen. Sie erstellen mit der Microsoft-App **Workflows** einen Webhook für den Kanal und fügen dessen URL dann in Wirespeed als Teams-Kanal hinzu. Zum Verwalten von Teams-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 und den Zustellverlauf, ohne **Test senden**.

Teams-Kanäle sind für teamweite Benachrichtigungen gedacht. Um für ChatOps einzelnen Benutzern in Teams Nachrichten zu senden, verwenden Sie stattdessen die [Microsoft-Teams-Integration](https://docs.wirespeed.co/de/integrations/microsoft-teams.md). Unter [Teams-Kanäle und die Microsoft-Teams-Integration](https://docs.wirespeed.co/de/settings/notifications.md#teams-kanäle-und-die-microsoft-teams-integration) finden Sie einen Vergleich der beiden.

## Unterstützte Benachrichtigungstypen

Teams-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. Teams-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, dem Teams-Kanal Workflows hinzuzufügen.
* Der Workflow gehört der Person, die ihn erstellt. Wenn diese Person Ihre Organisation verlässt und niemand sonst Besitzer des Workflows ist, wird er nicht mehr ausgeführt. Fügen Sie nach dem Erstellen einen Mitbesitzer hinzu.

## Schritt 1: Webhook in Teams erstellen

1. Öffnen Sie in Microsoft Teams den Kanal, wählen Sie **⋯** (Weitere Optionen) und dann **Workflows**.
2. Suchen Sie die Vorlage **Send webhook alerts to a channel** und wählen Sie sie aus. In älteren Teams-Versionen heißt sie **Post to a channel when a webhook request is received**. Je nach Spracheinstellung von Teams können diese Namen übersetzt sein.
3. Bestätigen Sie Team und Kanal und wählen Sie dann **Speichern**.
4. Wählen Sie **Webhook-Link kopieren**. Kopieren Sie die vollständige URL einschließlich allem nach `?`.

> [!WARNING]
>
> Verwenden Sie die einfache Vorlage **Send webhook alerts to a channel**. Die Varianten **from specific people** und **from people in an org** erfordern bei jeder Anfrage eine Microsoft-Anmeldung, daher lehnt Teams die Benachrichtigungen von Wirespeed mit dem Fehler 401 ab.

> [!NOTE]
>
> Diese Schritte wurden zuletzt am 13. Oktober 2026 mit Microsoft Teams überprüft. Wenn Ihre Ansicht davon abweicht, folgen Sie der Anleitung von Microsoft: [Erstellen eingehender Webhooks mit Workflows für Microsoft Teams](https://support.microsoft.com/de-de/teams/apps-service/create-incoming-webhooks-with-workflows-for-microsoft-teams).

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. Falls sie offengelegt wurde, erstellen Sie einen neuen Workflow, fügen Sie dessen URL beim Kanal in Wirespeed ein und löschen Sie den alten Workflow.

## Schritt 2: Kanal in Wirespeed hinzufügen

1. Navigieren Sie zu **Einstellungen > Benachrichtigungen**.
2. Wählen Sie auf der Karte **Teams** die Option **Verbinden**. Wenn Ihr Team bereits Teams-Kanäle hat, wählen Sie stattdessen das Zahnradsymbol (⚙, **Teams-Kanäle verwalten**).
3. Wählen Sie **Teams-Kanal hinzufügen**.
4. Geben Sie einen **Namen** ein. Er wird im Teams-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 Testkarte 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 Teams-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 Beispiel-Benachrichtigungskarte an diesen Workflow. 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 Teams angenommen** bedeutet, dass Microsoft die Anfrage angenommen hat, und die Karte sollte in Kürze im Kanal erscheinen. Falls nicht, siehe [Fehlende Karten](#fehlende-karten). 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 **Teams-Kanal** ein und wählen Sie unter **Teams-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ü **Teams-Kanäle verwalten**.

Wenn Ihr Team noch keine Teams-Kanäle hat, heißt der Abschnitt **Teams** und zeigt stattdessen **Verbinden** an.

Service Provider konfigurieren Kundenteams genauso wie E-Mail-Postfächer. Teams-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 **Teams-Kanäle** listet jeden Kanal mit seinem Status auf.

| 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 Teams-Kanal nach **drei fehlgeschlagenen Zustellungen ohne erfolgreiche Zustellung dazwischen**. Dabei zählen nur diese Fehler:

* Teams lehnt die URL ab (HTTP 401 oder 403).
* Der Workflow existiert nicht mehr (HTTP 404 oder 410).
* Der Workflow ist in Power Automate ausgeschaltet.

Eine erfolgreiche Zustellung setzt den Zähler zurück. Ausfälle bei Microsoft, Drosselung 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 **Teams-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 Teams (siehe [Fehlerbehebung](#fehlerbehebung)). Wenn Sie einen neuen Workflow 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 Testkarte 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

Microsoft begrenzt einen Teams-Workflows-Webhook auf **4 Anfragen pro Sekunde pro Webhook**. Jeder Kanal hat seine eigene Webhook-URL, daher teilen sich Kanäle diesen Grenzwert nicht.

Überschreitet ein Webhook den Grenzwert, antwortet Teams mit dem Fehler „Zu viele Anfragen“ (HTTP 429). Wirespeed pausiert dann die Zustellung an diesen Kanal für die von Teams geforderte Wartezeit (30 Sekunden, wenn Teams keine angibt, und nie mehr als 5 Minuten) und sendet danach die ausstehenden Karten. 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.

Karten, die länger sind, als Teams zulässt, werden gekürzt und enden mit einem Link zu den vollständigen Details in Wirespeed.

## Fehlerbehebung

### Fehler beim Speichern der URL

| Meldung | Lösung |
| - | - |
| Dies ist keine Workflows-HTTP-Trigger-URL. | Kopieren Sie die URL im Workflow mit **Webhook-Link kopieren**, nicht aus der Adressleiste Ihres Browsers. |
| Verwenden Sie eine Microsoft Teams-Workflows-URL (logic.azure.com oder environment.api.powerplatform.com) | Die URL ist kein Workflows-Webhook. Wirespeed akzeptiert keine Webhooks von Office-365-Connectors (`webhook.office.com`), die Microsoft einstellt. Erstellen Sie einen Workflow wie in [Schritt 1](#schritt-1-webhook-in-teams-erstellen) beschrieben. |
| Der Webhook-URL fehlt die Signatur (sig). | Die URL wurde abgeschnitten. Kopieren Sie die vollständige URL einschließlich allem nach `?`. |
| Geben Sie eine gültige URL ein | Fügen Sie die URL genau so ein, wie Teams 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 Teams-Webhook-URL ist bereits als anderer Teams-Kanal gespeichert | Verwenden Sie den vorhandenen Kanal, oder erstellen Sie für einen zweiten Kanal einen zweiten Workflow. |
| Ein Teams-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 |
| - | - |
| Teams hat die Anfrage abgelehnt (401) | Der Workflow verwendet eine Vorlage, die eine Anmeldung erfordert, oder die URL hat sich geändert. Erstellen Sie den Workflow mit **Send webhook alerts to a channel** und kopieren Sie die URL erneut. |
| Teams hat die Anfrage abgelehnt (404) | Der Workflow wurde gelöscht. Erstellen Sie einen neuen und fügen Sie dessen URL ein. |
| Keine Antwort von Teams innerhalb von 10 Sekunden, oder Teams ist nicht erreichbar | Microsoft 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. |
| Von Teams angenommen, aber es erscheint keine Karte | Öffnen Sie den Ausführungsverlauf des Workflows in Teams. Siehe [Fehlende Karten](#fehlende-karten). |

### 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 Workflow wurde gelöscht oder seine URL ist nicht mehr gültig. | Der Workflow wurde gelöscht oder neu erstellt, oder Microsoft hat seine URL geändert. | Öffnen Sie den Workflow in Teams und kopieren Sie seine aktuelle URL. 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**. |
| Teams hat die Signatur der URL abgelehnt oder den Zugriff blockiert. | Die Signatur der URL hat sich geändert, der Workflow erfordert eine Anmeldung, oder eine Richtlinie in Ihrem Microsoft-Mandanten blockiert ihn. | Kopieren Sie die vollständige URL erneut aus dem Workflow. Hilft das nicht, fragen Sie Ihren Microsoft 365- oder Power Platform-Administrator, ob eine Richtlinie den Workflow blockiert. |
| Der Workflow ist in Power Automate ausgeschaltet. | Der Besitzer hat ihn ausgeschaltet, oder Microsoft hat ihn ausgeschaltet (zum Beispiel nach einer Lizenzänderung). | Schalten Sie den Workflow in der Workflows-App ein, fügen Sie einen Mitbesitzer hinzu, wählen Sie dann beim Kanal **Wieder aktivieren**, senden Sie einen erfolgreichen Test und speichern Sie mit **Änderungen speichern**. |
| 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 Workflow in Power Automate. | Ein anderer Fehler. | Öffnen Sie den Ausführungsverlauf des Workflows, beheben Sie das Problem, wählen Sie dann beim Kanal **Wieder aktivieren**, senden Sie einen erfolgreichen Test und speichern Sie mit **Änderungen speichern**. |

### Fehlende Karten

Wenn Wirespeed eine Zustellung als angenommen anzeigt, aber keine Karte im Kanal erscheint, hat der Workflow die Benachrichtigung erhalten, aber sein Schritt zum Veröffentlichen der Karte ist fehlgeschlagen. Wirespeed kann diese Fehler nicht sehen. Öffnen Sie den Ausführungsverlauf des Workflows in Teams und prüfen Sie:

* ob der Workflow-Besitzer noch Mitglied des Teams oder Kanals ist,
* ob eine Verbindung im Workflow abgelaufen ist.

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