Zammad Push-Benachrichtigungen auf dem Handy

Zammad selbst schickt keine Push-Benachrichtigungen aufs Handy. Zamio ergänzt sie mit zwei Standardfunktionen von Zammad: einem Webhook und einem Trigger. Ein Zammad-Administrator richtet das einmal ein, es dauert etwa fünf Minuten. Es funktioniert mit Zammad 6 und 7, selbst gehostet oder in der Zammad Cloud.

So funktioniert es

Änderung an einem Ticket Zammad-Trigger Signierter Webhook Zamio-Benachrichtigungsdienst Apple / Google Handys der Agenten

Zwei Einstellungen bestimmen, was passiert:

  • Der Trigger bestimmt, wann. Eine Benachrichtigung wird nur verschickt, wenn die Bedingungen des Triggers zutreffen.
  • Die Gruppe des Tickets bestimmt, wer. Die Benachrichtigung geht an alle Agenten in der Gruppe des Tickets, die Zamio mit aktivierten Benachrichtigungen nutzen. Wer die Änderung selbst vorgenommen hat, bekommt keine.

Schritt 1: Zammad-Server registrieren

  1. Öffnen Sie notification.zamio.kaju.pl/setup.html.
  2. Geben Sie unter Zammad Server URL die Adresse Ihres Zammad ein, zum Beispiel https://support.firma.de. Verwenden Sie genau die Adresse, die Ihre Agenten bei der Anmeldung in der App eingeben (siehe Fehlerbehebung).
  3. Denken Sie sich unter HMAC Signature Token ein Geheimnis mit mindestens 8 Zeichen aus. Denselben Wert tragen Sie in Schritt 2 in Zammad ein.
  4. Klicken Sie auf Register Server und kopieren Sie die Webhook-URL. Sie sieht so aus:
    https://notification.zamio.kaju.pl/webhook/group?server=https://support.firma.de

Der Server wartet jetzt auf die Bestätigung. Sie erfolgt automatisch, sobald der erste korrekt signierte Webhook von Ihrem Zammad eintrifft.

Schritt 2: Webhook in Zammad anlegen

  1. Gehen Sie in Zammad zu Verwalten → Webhook → Neuer Webhook (Manage → Webhook → New Webhook).
  2. Name: zum Beispiel Zamio push.
  3. Endpunkt (Endpoint): die URL aus Schritt 1 einfügen.
  4. Signatur-Token (Signature Token): dasselbe Geheimnis wie in Schritt 1.
  5. Lassen Sie die SSL-Verifizierung (SSL Verification) eingeschaltet.
  6. Lassen Sie Benutzerdefinierte Nutzlast (Custom Payload) ausgeschaltet. Der Dienst liest die Standard-Nutzlast von Zammad (Ticket und Artikel).
  7. Speichern.

Schritt 3: Trigger anlegen

Ein Trigger, der bei jeder Ticketänderung auslöst, überschüttet die Agenten mit Benachrichtigungen. Ich richte ihn für drei Situationen ein, für die es sich lohnt, jemanden zu unterbrechen:

SituationBedingungen des Triggers
Ein Ticket landet in einer GruppeGroup has changed
Ein Ticket ändert seinen StatusState has changed
Der Kunde antwortetArticle › Action is created und Article › Sender is Customer

Bedingungen innerhalb eines Zammad-Triggers werden mit UND verknüpft. Am einfachsten legen Sie daher drei Trigger an, einen pro Zeile. Wenn Sie den Expertenmodus von Zammad kennen, können Sie sie auch in einem Trigger mit ODER kombinieren.

Für jeden Trigger:

  1. Gehen Sie zu Verwalten → Trigger → Neuer Trigger (Manage → Trigger → New Trigger).
  2. Aktiviert durch (Activated by): Aktion (Action).
  3. Fügen Sie die Bedingungen aus der Tabelle hinzu.
  4. Wählen Sie unter Änderungen an Objekten ausführen (Execute changes on objects) Benachrichtigung → Webhook und dann Zamio push.
  5. Speichern.

Schritt 4: Benachrichtigungen in der App einschalten

Jeder Agent öffnet in Zamio Einstellungen → Push-Benachrichtigungen und erlaubt Benachrichtigungen, wenn das Handy danach fragt. Das Handy wird dann für den Zammad-Server registriert, bei dem der Agent angemeldet ist.

Schritt 5: Testen

Bitten Sie eine Kollegin oder einen Kollegen, auf ein Ticket in Ihrer Gruppe zu antworten, oder melden Sie sich im Browser als anderer Benutzer bei Zammad an. Über Ihre eigenen Änderungen werden Sie nicht benachrichtigt. Selbst ein Ticket zu ändern und auf eine Benachrichtigung zu warten, ist daher der häufigste Fehlalarm.

Fehlerbehebung

Niemand erhält Benachrichtigungen
Prüfen Sie die Serveradresse. Benachrichtigungen werden über die exakte Adresse zugeordnet: https oder http, eine andere Subdomain oder ein Port gelten jeweils als anderer Server. Wenn Sie https://zammad.firma.de registriert haben, die Agenten sich aber unter https://support.firma.de anmelden, passt nichts zusammen. Registrieren Sie die Adresse, die die Agenten tatsächlich verwenden.
Zammad zeigt beim Senden des Webhooks einen Fehler
Wahrscheinlich unterscheidet sich der Signatur-Token in Zammad vom Geheimnis auf der Einrichtungsseite. Wurde der Server noch nie bestätigt, registrieren Sie ihn mit einem neuen Geheimnis erneut. Wurde er bereits bestätigt, lehnt die Einrichtungsseite eine neue Registrierung ab. Schreiben Sie dann an kontakt@kaju.pl, und ich setze ihn zurück.
Ein einzelner Agent bekommt keine Benachrichtigungen
Der Agent muss in Zammad Mitglied der Gruppe des Tickets sein. Prüfen Sie auf dem Handy, ob Benachrichtigungen für Zamio in den Systemeinstellungen erlaubt sind, und schalten Sie die Benachrichtigungen in der App aus und wieder ein.
Ich habe Custom Payload eingeschaltet
Schalten Sie es aus. Ohne die Standardobjekte ticket und article kann der Dienst keine Benachrichtigung erstellen und lehnt den Webhook ab.
Ich nutze zwei Zammad-Server
Sie erhalten Benachrichtigungen nur von dem Server, bei dem Sie gerade in der App angemeldet sind.