Benachrichtigungen für Microsoft Teams¶
Führen Sie die folgenden Schritte aus, um einen Webhook für den Empfang von Zammad-Benachrichtigungen in einem Microsoft Teams-Kanal zu konfigurieren.
Schritt 1 - Einrichten des eingehenden Webhook-Connectors in Ihrem Teams-Kanal¶
Klicken Sie in Ihrem Ziel-Teams-Channel auf das Menü in der oberen rechten Ecke und wählen Sie Connectors.
Suchen Sie in der Liste einen Connector mit dem Namen Eingehender Webhook und klicken Sie auf die Schaltfläche Konfigurieren daneben.
Geben Sie einen geeigneten Namen für den Webhook-Connector an. Dieser wird als Name für alle Benachrichtigungen im Kanal verwendet.
Optional können Sie ein benutzerdefiniertes Bild angeben, das als Avatar verwendet werden soll.
Klicken Sie auf Erstellen und haben Sie etwas Geduld.
Kopieren Sie nach der Erstellung die Webhook-Endpunkt-URL in die Zwischenablage und speichern Sie sie für später. Sie können dies mit einem Klick über den Button im Feld tun.
Beenden Sie die Konfiguration des Connectors, indem Sie auf Fertig klicken.
Schritt 2 - Einen vordefinierten Webhook in Zammad hinzufügen¶
Gehen Sie in Ihrer Zammad-Instanz in den Einstellungen zu Webhook und klicken Sie auf den Pfeil neben der grünen Schaltfläche in der oberen rechten Ecke. Wählen Sie Vordefinierter Webhook aus dem Dropdown-Menü.
Wählen Sie im folgenden Dialogfeld Microsoft Teams Notifications als vordefinierten Webhook aus.
Klicken Sie auf Weiter.
Fügen Sie im neuen Dialog die webhook endpoint URL von Microsoft Teams in das Feld Endpunkt ein.
Klicken Sie abschließend auf Übermitteln.
Schritt 3 - Konfigurieren eines Triggers für das Auslösen des Webhooks¶
Als letzten Schritt müssen Sie einen Trigger erstellen, um unter bestimmten Bedingungen eine Benachrichtigung an den Microsoft Teams-Kanal zu senden.
Sobald der Trigger eingerichtet ist, ist Ihr Webhook einsatzbereit!
Beispiel Teams Kanalbenachrichtigung¶
Von nun an wird jedes Mal, wenn ein Ticket in Ihrem Zammad-System erstellt oder aktualisiert wird, eine entsprechende Benachrichtigung in dem konfigurierten Teams-Kanal gepostet. Die Benachrichtigung enthält den Link zum Ticket, die aktualisierten Daten und den Inhalt des letzten Artikels. Außerdem wird sie entsprechend ihrem letzten Status farblich gekennzeichnet.
Entfernen des Artikelinhalts aus der Teams-Benachrichtigung¶
Wenn Sie vermeiden wollen, dass sensible Artikelinhalte über Benachrichtigungen verschickt werden, gibt es eine Möglichkeit, diese zu entfernen. Passen Sie dazu den Webhook-Payload an.
Suchen Sie Ihren Webhook in der Liste in den Einstellungen und klicken Sie ihn an, um ihn zu bearbeiten.
Schalten Sie Eigene Nutzlast ein, und der nachstehende Code-Editor wird angezeigt, der mit der Standard-Payload-Konfiguration vorausgefüllt ist.
Identifizieren Sie dann den Block {"text": "#{notification.body}" }
in der JSON-Struktur und wählen Sie ihn aus. Achten Sie darauf, dass das Komma (,
) in der vorangehenden Zeile enthalten ist, da der Payload weiterhin gültig sein muss.
Löschen Sie dann einfach den ausgewählten Codeblock.
Klicken Sie abschließend auf Übermitteln, um Ihre Webhook-Änderungen zu speichern.
Bei der nächsten Ausführung des Webhooks wird die Benachrichtigung nicht den Inhalt des letzten Artikels enthalten.