Benachrichtigungen für Slack¶
Führen Sie die folgenden Schritte aus, um einen Webhook für den Empfang von Zammad-Benachrichtigungen in einem Slack-Kanal zu konfigurieren.
Schritt 1 - Einrichten der „Incoming WebHooks App“ in Ihrem Slack-Kanal¶
Klicken Sie im gewünschten Slack-Kanal auf den Kanalnamen im oberen linken Teil des Bildschirms, um zu den Kanaldetails zu gelangen.
Wechseln Sie zum Tab Integrations und klicken Sie auf die Schaltfläche Add an App.
Suchen Sie auf dem nächsten Bildschirm nach einer Anwendung namens Incoming WebHooks und klicken Sie auf die Schaltfläche Installieren daneben.
Sie werden auf die Website des „Slack App Directory“ weitergeleitet, wo Sie die App hinzufügen können.
Klicken Sie auf die Schaltfläche Zu Slack hinzufügen.
Wählen Sie auf dem nächsten Bildschirm unter Post to Channel Ihren Channel aus der Liste aus und klicken Sie auf die Schaltfläche Add Incoming WebHooks integration.
Scrollen Sie in der letzten Ansicht nach unten zu Integrationseinstellungen.
Achten Sie darauf, die Webhook-URL in die Zwischenablage zu kopieren und sie für später zu speichern. Sie können dies mit einem Klick über den Link URL kopieren tun, der direkt unter dem Feld angezeigt wird.
Sie können im Feld Customize Name einen geeigneten Benutzernamen für die eingehende Webhook-Integration hinterlegen, da dieser für alle Benachrichtigungen im Kanal verwendet wird.
Optional können Sie das Customize Icon anpassen, das als Avatar verwendet wird.
Speichern Sie abschließend Ihre App-Konfiguration, indem Sie auf Einstellungen speichern 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 Slack Notifications als vordefinierten Webhook aus.
Klicken Sie auf Weiter.
Fügen Sie im neuen Dialogfeld die Webhook-URL der Slack-App 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 Slack-Kanal zu senden.
Sobald der Trigger eingerichtet ist, ist Ihr Webhook einsatzbereit!
Beispiel einer Slack-Kanalbenachrichtigung¶
Von nun an wird jedes Mal, wenn ein Ticket in Ihrem Zammad-System eskaliert ist oder eine Eskalationswarnung erreicht hat, eine entsprechende Benachrichtigung im konfigurierten Slack-Kanal gepostet. Die Benachrichtigung enthält den Link zum Ticket, Eskalationsinformationen und den Inhalt des letzten Artikels. Sie wird auch entsprechend dem letzten Status farblich gekennzeichnet.
Entfernen des Artikelinhalts aus der Slack-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.