Benachrichtigungen für Rocket Chat¶
Führen Sie die folgenden Schritte aus, um einen Webhook für den Empfang von Zammad-Benachrichtigungen in einem Rocket Chat-Kanal zu konfigurieren.
Schritt 1 - Einrichten der Integration eingehender Webhooks für Ihren Rocket Chat-Kanal¶
Wählen Sie in Ihrem Rocket Chat Administrationsmenü Workspace.
Wählen Sie in der linken Seitenleiste Integrationen und klicken Sie dann auf die Schaltfläche Neu in der oberen rechten Ecke.
Schalten Sie zunächst die Funktion mit dem Schalter oben ein (Aktiviert).
Geben Sie einen geeigneten Name für die eingehende Integration an und geben Sie den Zielkanal im Feld Post to Channel im Format #channel-name
ein.
Geben Sie den Rocket Chat-Benutzernamen in das Feld Post as ein, ohne den Präfix @
. Beachten Sie, dass der Benutzername bereits existieren muss.
Scrollen Sie bis zum Ende des Formulars und klicken Sie auf die Schaltfläche Speichern.
Kopieren Sie nach erfolgreicher Speicherung 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.
Schließen Sie dann das Administrationsfenster, indem Sie auf der linken Seite auf X
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 Rocket Chat Notifications als vordefinierten Webhook aus.
Klicken Sie auf Weiter.
Fügen Sie im neuen Dialogfeld die Webhook-Endpunkt-URL von Rocket Chat in das Feld Endpunkt ein.
Optional können Sie einen Benutzernamen festlegen, der für die Veröffentlichung der Zammad-Benachrichtigungen verwendet werden soll.
Optional können Sie auch einen Messaging Channel einstellen, wenn Sie an einen anderen Zielkanal posten möchten als in der Rocket Chat Eingangsintegration konfiguriert.
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 Rocket Chat-Kanal zu senden.
Sobald der Trigger eingerichtet ist, ist Ihr Webhook einsatzbereit!
Beispiel einer Rocket Chat-Kanalbenachrichtigung¶
Von nun an wird jedes Mal, wenn ein Ticket in Ihrem Zammad-System erstellt oder aktualisiert wird, eine entsprechende Benachrichtigung in dem konfigurierten Rocket Chat-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 Rocket Chat-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.
Als nächstes identifizieren Sie die Zeile, die mit dem Block "text": "...
in der JSON-Struktur beginnt.
Scrollen Sie bis zum Ende der Zeile und markieren Sie \n\n#{notification.body}
. Achten Sie darauf, das abschließende doppelte Anführungszeichen mit Komma (",
) nicht in den Rest der Zeile zu übernehmen, da der neue Payload ein gültiger JSON-Wert bleiben 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.