Microsoft Teams verbinden

Mirox kann Ihre Benachrichtigungen direkt in einen Microsoft-Teams-Kanal posten — Alarme, Ticket-Aktivität, Berichte — sodass Ihr ganzes Team sie dort sieht, wo es ohnehin arbeitet. Die Verbindung ist ein Standard-Workflow für eingehende Webhooks in Teams: Teams gibt Ihnen eine URL, und Sie registrieren diese URL als Webhook in Ihren Mirox-Benachrichtigungseinstellungen. Es ist kein Plugin und keine App-Installation erforderlich.

Wo Sie es finden

Die Mirox-Seite dieser Anleitung findet auf Ihrer Profil-Seite statt, im Tab Benachrichtigungen, unter Kanäle ▸ Webhooks. In Mirox öffnen

Bevor Sie beginnen

Sie benötigen in Microsoft Teams die Berechtigung, dem Zielkanal Workflows hinzuzufügen (die meisten Kanalmitglieder haben sie; Ihr Teams-Administrator kann sie einschränken).
Entscheiden Sie, welcher Kanal Mirox-Benachrichtigungen erhalten soll — ein eigener Kanal wie Mirox Alerts hält sie übersichtlich.

Schritt 1 — Webhook-Workflow in Teams erstellen

Gehen Sie in Microsoft Teams zu dem Kanal, der Benachrichtigungen erhalten soll.
Klicken Sie auf die drei Punkte (⋯) neben dem Kanalnamen und wählen Sie Workflows.
Wählen Sie die Vorlage „In einem Kanal posten, wenn eine Webhookanforderung empfangen wird" (englisch: "Post to a channel when a webhook request is received").
Melden Sie sich an bzw. bestätigen Sie die Verbindung, behalten oder ändern Sie den Workflow-Namen und klicken Sie auf Weiter.
Bestätigen Sie Team und Kanal und klicken Sie dann auf Workflow hinzufügen.
Teams zeigt jetzt die Webhook-URL an. Kopieren Sie sie und klicken Sie auf Fertig.

Workflows verwenden, nicht den alten Connector

Microsoft hat den älteren Office-365-Connector „Incoming Webhook" eingestellt. Die obige Workflows-Vorlage ist der aktuelle, unterstützte Weg, Webhook-Nachrichten in einem Teams-Kanal zu empfangen. Finden Sie sie nicht über das Kanalmenü, öffnen Sie die Workflows-App in Teams und suchen Sie nach derselben Vorlage.

Die Workflow-URL ist ein Geheimnis

Jeder, der diese URL besitzt, kann Nachrichten in Ihren Teams-Kanal posten. Behandeln Sie sie wie ein Passwort — fügen Sie sie in Mirox ein und geben Sie sie sonst nirgends weiter.

Schritt 2 — Webhook in Mirox hinzufügen

Öffnen Sie Ihr Profil und wählen Sie den Tab Benachrichtigungen.
Klicken Sie in der Karte Kanäle unter Webhooks auf Webhook hinzufügen.
Vergeben Sie einen wiedererkennbaren Namen, zum Beispiel Teams — Betrieb.
Fügen Sie die Workflow-URL aus Teams ein.
Stellen Sie das Format auf Microsoft Teams — damit sendet Mirox Nachrichten, die Teams als Karten darstellen kann.
Speichern Sie. Mirox zeigt das Signatur-Secret des Webhooks einmalig an — für eine Teams-Verbindung können Sie das einfach schließen, siehe Zu den Signatur-Headern unten.

Schritt 3 — Testnachricht senden

Klicken Sie in der neuen Webhook-Zeile auf Testen.
Innerhalb weniger Augenblicke erscheint eine Mirox-Testnachricht in Ihrem Teams-Kanal.

Kommt nichts an, prüfen Sie, ob die URL vollständig kopiert wurde und der Workflow in Teams aktiviert ist, und testen Sie erneut.

Benachrichtigungen nach Teams leiten

Mit dem Hinzufügen des Webhooks steht der Kanal bereit — stellen Sie nun sicher, dass Benachrichtigungen ihn auch nutzen:

Schalten Sie im Tab Benachrichtigungen den Hauptschalter Benachrichtigungen außerhalb der App senden ein.
Stellen Sie sicher, dass der Webhook-Kanal aktiviert und in der Karte Was mich benachrichtigt für die gewünschten Benachrichtigungsgruppen ausgewählt ist (standardmäßig folgen Gruppen Ihrer globalen Kanalauswahl).

Von da an werden passende Benachrichtigungen in Ihren Teams-Kanal gepostet, sobald sie entstehen.

Zu den Signatur-Headern

Jede Webhook-Anfrage, die Mirox sendet, ist signiert: Sie trägt Signatur- und Zeitstempel-Header, die aus dem Signatur-Secret des Webhooks berechnet werden, sodass ein empfangendes System prüfen kann, dass die Anfrage wirklich von Mirox stammt und keine Wiederholung ist. Microsoft Teams ignoriert diese Header — der Workflow akzeptiert jede wohlgeformte Anfrage, die die URL kennt —, für eine Teams-Verbindung benötigen Sie das Secret also nie. Relevant wird es, wenn Sie einen Generic-JSON-Webhook auf Ihr eigenes System richten und eingehende Anfragen authentifizieren möchten; mit Secret rotieren können Sie es jederzeit neu ausstellen.

Fehlerbehebung

Problem	Mögliche Ursache	Lösung
Test funktioniert, aber keine echten Benachrichtigungen kommen an	Hauptschalter aus, oder Webhook für keine Benachrichtigungsgruppe ausgewählt	Benachrichtigungen außerhalb der App senden aktivieren und die Kanalauswahl unter Was mich benachrichtigt prüfen
Webhook-Zeile zeigt eine Deaktivierungs-Warnung	Wiederholte Zustellfehler haben den Webhook automatisch deaktiviert	Ursache beheben (meist ein gelöschter oder geänderter Workflow in Teams), URL aktualisieren, dann auf Testen klicken — ein erfolgreicher Test reaktiviert ihn
Nachrichten stoppten nach Änderungen in Teams	Workflow gelöscht, deaktiviert oder URL neu erzeugt	Workflow in Teams neu erstellen/reparieren und die URL in Mirox aktualisieren
Nachricht zeigt rohes JSON statt einer Karte	Format steht auf Generic JSON	Webhook bearbeiten und das Format auf Microsoft Teams stellen