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
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
- Öffnen Sie notification.zamio.kaju.pl/setup.html.
- 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). - Denken Sie sich unter HMAC Signature Token ein Geheimnis mit mindestens 8 Zeichen aus. Denselben Wert tragen Sie in Schritt 2 in Zammad ein.
- 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
- Gehen Sie in Zammad zu Verwalten → Webhook → Neuer Webhook (Manage → Webhook → New Webhook).
- Name: zum Beispiel
Zamio push. - Endpunkt (Endpoint): die URL aus Schritt 1 einfügen.
- Signatur-Token (Signature Token): dasselbe Geheimnis wie in Schritt 1.
- Lassen Sie die SSL-Verifizierung (SSL Verification) eingeschaltet.
- Lassen Sie Benutzerdefinierte Nutzlast (Custom Payload) ausgeschaltet. Der Dienst liest die Standard-Nutzlast von Zammad (Ticket und Artikel).
- 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:
| Situation | Bedingungen des Triggers |
|---|---|
| Ein Ticket landet in einer Gruppe | Group has changed |
| Ein Ticket ändert seinen Status | State has changed |
| Der Kunde antwortet | Article › 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:
- Gehen Sie zu Verwalten → Trigger → Neuer Trigger (Manage → Trigger → New Trigger).
- Aktiviert durch (Activated by): Aktion (Action).
- Fügen Sie die Bedingungen aus der Tabelle hinzu.
- Wählen Sie unter Änderungen an Objekten ausführen (Execute changes on objects) Benachrichtigung → Webhook und dann
Zamio push. - 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:
httpsoderhttp, eine andere Subdomain oder ein Port gelten jeweils als anderer Server. Wenn Siehttps://zammad.firma.deregistriert haben, die Agenten sich aber unterhttps://support.firma.deanmelden, 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
ticketundarticlekann 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.