Les notifications push de Zammad sur votre téléphone

Rédigé par Michał, le développeur de Zamio · Mis à jour:

Zammad n'envoie pas de lui-même de notifications push sur les téléphones. Zamio les ajoute à l'aide de deux fonctions standard de Zammad : un webhook et un déclencheur (Trigger). Un administrateur Zammad le configure une seule fois, en cinq minutes environ. Cela fonctionne avec Zammad 6 et 7, auto-hébergé ou sur Zammad Cloud.

Comment ça marche

Modification d'un ticket Déclencheur Zammad Webhook signé Service de notifications Zamio Apple / Google Téléphones des agents

Deux réglages décident de tout :

  • Le déclencheur décide quand. Une notification part uniquement si les conditions du déclencheur sont remplies.
  • Le groupe du ticket décide qui. La notification va à chaque agent du groupe du ticket qui utilise Zamio avec les notifications activées. La personne qui a fait la modification n'en reçoit pas.

Étape 1 : enregistrer votre serveur Zammad

  1. Ouvrez notification.zamio.kaju.pl/setup.html.
  2. Dans Zammad Server URL, saisissez l'adresse de votre Zammad, par exemple https://support.entreprise.fr. Utilisez exactement l'adresse que vos agents saisissent pour se connecter à l'application (voir dépannage).
  3. Dans HMAC Signature Token, inventez un secret d'au moins 8 caractères. Vous collerez la même valeur dans Zammad à l'étape 2.
  4. Cliquez sur Register Server et copiez l'URL du webhook. Elle ressemble à ceci :
    https://notification.zamio.kaju.pl/webhook/group?server=https://support.entreprise.fr

Le serveur attend maintenant sa vérification. Il est confirmé automatiquement à l'arrivée du premier webhook correctement signé envoyé par votre Zammad.

Étape 2 : créer le webhook dans Zammad

  1. Dans Zammad, allez dans Gérer → Webhooks → Nouveau webhook (Manage → Webhook → New Webhook).
  2. Nom : par exemple Zamio push.
  3. Endpoint : collez l'URL de l'étape 1.
  4. Token de signature (Signature Token) : le même secret qu'à l'étape 1.
  5. Laissez la vérification SSL (SSL Verification) activée.
  6. Laissez le payload personnalisé (Custom Payload) désactivé. Le service lit le payload standard de Zammad (ticket et article).
  7. Enregistrez.

Étape 3 : créer les déclencheurs

Un déclencheur qui réagit à chaque modification de ticket noie les agents sous les notifications. Je le configure pour trois situations qui valent la peine d'interrompre quelqu'un :

SituationConditions du déclencheur
Un ticket arrive dans un groupeGroupe a changé
Un ticket change d'étatÉtat a changé
Le client répondArticle › Action est créé, et Article › Expéditeur est Client

Dans un même déclencheur, Zammad combine les conditions avec ET. Le plus simple est donc de créer trois déclencheurs, un par ligne. Si vous connaissez le mode expert de Zammad, vous pouvez les réunir en un seul déclencheur avec OU.

Pour chaque déclencheur :

  1. Allez dans Gérer → Déclencheurs → Nouveau déclencheur (Manage → Trigger → New Trigger).
  2. Activé par : Action.
  3. Ajoutez les conditions du tableau.
  4. Dans Exécuter des modifications sur les objets (Execute changes on objects), choisissez Notification → Webhook et sélectionnez Zamio push.
  5. Enregistrez.

Étape 4 : activer les notifications dans l'application

Chaque agent ouvre Réglages → Notifications push dans Zamio et autorise les notifications quand le téléphone le demande. Le téléphone est alors enregistré pour le serveur Zammad auquel l'agent est connecté.

Étape 5 : tester

Demandez à un collègue de répondre à un ticket de votre groupe, ou connectez-vous à Zammad dans le navigateur avec un autre utilisateur. Vous n'êtes pas notifié de vos propres modifications : modifier un ticket vous-même puis attendre une notification est la fausse alerte la plus fréquente.

Dépannage

Personne ne reçoit de notifications
Vérifiez l'adresse du serveur. Les notifications sont associées à l'adresse exacte : https au lieu de http, un autre sous-domaine ou un port comptent comme des serveurs différents. Si vous avez enregistré https://zammad.entreprise.fr alors que les agents se connectent à https://support.entreprise.fr, rien ne correspond. Enregistrez l'adresse que les agents utilisent réellement.
Zammad affiche une erreur à l'envoi du webhook
Le token de signature dans Zammad est probablement différent du secret saisi sur la page d'enregistrement. Si le serveur n'a jamais été confirmé, enregistrez-le à nouveau avec un nouveau secret. S'il a déjà été confirmé, la page d'enregistrement refusera un nouvel enregistrement. Écrivez-moi à kontakt@kaju.pl et je le réinitialiserai.
Un agent ne reçoit pas de notifications
L'agent doit être membre du groupe du ticket dans Zammad. Sur le téléphone, vérifiez que les notifications de Zamio sont autorisées dans les réglages du système, puis désactivez et réactivez les notifications dans l'application.
J'ai activé le payload personnalisé (Custom Payload)
Désactivez-le. Sans les objets standard ticket et article, le service ne peut pas construire la notification et rejette le webhook.
J'utilise deux serveurs Zammad
Vous recevez uniquement les notifications du serveur auquel vous êtes connecté dans l'application.