Zammad-pushmeldingen op uw telefoon
Zammad stuurt zelf geen pushmeldingen naar telefoons. Zamio voegt ze toe met twee standaardfuncties van Zammad: een webhook en een trigger. Een Zammad-beheerder stelt dit één keer in, en dat kost ongeveer vijf minuten. Het werkt met Zammad 6 en 7, op een eigen server of in Zammad Cloud.
Hoe het werkt
Twee instellingen bepalen wat er gebeurt:
- De trigger bepaalt wanneer. Er wordt alleen een melding verstuurd als aan de voorwaarden van de trigger is voldaan.
- De groep van het ticket bepaalt wie. De melding gaat naar elke agent in de groep van het ticket die Zamio gebruikt met meldingen ingeschakeld. Wie de wijziging heeft gedaan, krijgt er geen.
Stap 1: Registreer uw Zammad-server
- Open notification.zamio.kaju.pl/setup.html.
- Vul bij Zammad Server URL het adres van uw Zammad in, bijvoorbeeld
https://support.bedrijf.nl. Gebruik precies het adres dat uw agents invullen als ze inloggen in de app (zie problemen oplossen). - Bedenk bij HMAC Signature Token een geheim van minstens 8 tekens. Dezelfde waarde plakt u in stap 2 in Zammad.
- Klik op Register Server en kopieer de webhook-URL. Die ziet er zo uit:
https://notification.zamio.kaju.pl/webhook/group?server=https://support.bedrijf.nl
De server wacht nu op verificatie. Hij wordt automatisch bevestigd zodra de eerste correct ondertekende webhook van uw Zammad binnenkomt.
Stap 2: Maak de webhook aan in Zammad
- Ga in Zammad naar Beheren → Webhooks → Nieuwe webhook (Manage → Webhook → New Webhook).
- Naam: bijvoorbeeld
Zamio push. - Endpoint: plak de URL uit stap 1.
- Handtekeningtoken (Signature Token): hetzelfde geheim als in stap 1.
- Laat SSL-verificatie aan staan.
- Laat Aangepaste payload (Custom Payload) uit staan. De dienst leest de standaard Zammad-payload (ticket en artikel).
- Opslaan.
Stap 3: Maak triggers aan
Een trigger die bij elke ticketwijziging afgaat, bedelft agents onder de meldingen. Ik stel hem in voor drie situaties waarvoor het de moeite waard is iemand te storen:
| Situatie | Voorwaarden van de trigger |
|---|---|
| Een ticket komt in een groep terecht | Groep is gewijzigd |
| Een ticket verandert van status | Status is gewijzigd |
| De klant antwoordt | Artikel › Actie is aangemaakt, en Artikel › Afzender is Klant |
Voorwaarden binnen één Zammad-trigger worden met EN gecombineerd, dus het eenvoudigst is drie triggers aan te maken, één per rij. Kent u de expertmodus van Zammad, dan kunt u ze ook in één trigger met OF combineren.
Voor elke trigger:
- Ga naar Beheren → Triggers → Nieuwe trigger (Manage → Trigger → New Trigger).
- Geactiveerd door (Activated by): Actie.
- Voeg de voorwaarden uit de tabel toe.
- Kies onder Wijzigingen uitvoeren op objecten (Execute changes on objects) Melding → Webhook en selecteer
Zamio push. - Opslaan.
Stap 4: Schakel meldingen in de app in
Elke agent opent in Zamio Instellingen → Pushmeldingen en staat meldingen toe als de telefoon daarom vraagt. De telefoon wordt dan geregistreerd voor de Zammad-server waarop de agent is ingelogd.
Stap 5: Test het
Vraag een collega een ticket in uw groep te beantwoorden, of log in de browser in bij Zammad als een andere gebruiker. U krijgt geen meldingen over uw eigen wijzigingen, dus zelf een ticket wijzigen en op een melding wachten is het meest voorkomende valse alarm.
Problemen oplossen
- Niemand ontvangt meldingen
- Controleer het serveradres. Meldingen worden gekoppeld op het exacte adres:
httpsofhttp, een ander subdomein of een poort tellen allemaal als verschillende servers. Hebt uhttps://zammad.bedrijf.nlgeregistreerd, maar loggen agents in ophttps://support.bedrijf.nl, dan komt er niets overeen. Registreer het adres dat de agents echt gebruiken. - Zammad geeft een fout bij het versturen van de webhook
- Waarschijnlijk verschilt het handtekeningtoken in Zammad van het geheim dat op de registratiepagina is ingevuld. Is de server nog nooit bevestigd, registreer hem dan opnieuw met een nieuw geheim. Was hij al bevestigd, dan weigert de registratiepagina een nieuwe registratie. Mail dan naar kontakt@kaju.pl, dan zet ik hem terug.
- Eén agent krijgt geen meldingen
- De agent moet in Zammad lid zijn van de groep van het ticket. Controleer op de telefoon of meldingen voor Zamio zijn toegestaan in de systeeminstellingen, en schakel meldingen in de app daarna uit en weer in.
- Ik heb Aangepaste payload (Custom Payload) ingeschakeld
- Schakel het uit. Zonder de standaardobjecten
ticketenarticlekan de dienst de melding niet opbouwen en weigert hij de webhook. - Ik gebruik twee Zammad-servers
- U krijgt alleen meldingen van de server waarop u op dat moment in de app bent ingelogd.