Recevoir les événements avec un webhook

Le webhook envoie une requête POST en JSON à votre serveur pour chaque événement de l’App, par exemple pour envoyer une notification push depuis votre serveur : voir Documentation > Notifications push.

1. Ouvrez Paramètres de l’App > Développeurs > Webhook.
2. Saisissez l’adresse de votre serveur, en https, puis enregistrez.
3. Copiez le secret de signature qui apparaît et gardez-le sur votre serveur.

Les événements

• message.member : un membre a répondu au Contact, avec la notification push prête à envoyer. Les notes internes et les réponses automatiques de l’IA n’envoient rien.
• message.contact : le Contact a écrit.
• case.opened : un Case s’ouvre, au premier message ou quand la conversation se rouvre.
• case.resolved : un Case est résolu, par un membre ou automatiquement.

La livraison

• L’adresse doit être publique et en https : localhost et les réseaux privés sont refusés.
• Répondez avec un code 2xx en moins de 10 secondes.
• Sinon, l’appel est retenté jusqu’à 5 fois : après 1 minute, 5 minutes, 30 minutes, 2 heures, puis 6 heures.
• Le champ id reste le même d’un essai à l’autre : servez-vous-en pour ignorer un doublon.

Les envois récents

Dans Paramètres de l’App > Développeurs > Webhook, « Envois récents » montre les 50 derniers appels de l’App, événements de test compris. Pour chacun : l’événement, sa destination (« Adresse du webhook » ou « CLI Zean »), le code de réponse de votre serveur ou l’erreur, comme « Délai dépassé » ou « Connexion refusée », le début de sa réponse, le temps de réponse, l’heure, le numéro de l’essai, et le badge « Test » pour un test.

1. Repérez l’appel en erreur et lisez la réponse de votre serveur.
2. Corrigez votre serveur ou l’adresse.
3. Choisissez « Renvoyer » : le même événement repart, avec le même id et le numéro d’essai suivant. S’il réussit, les nouveaux essais automatiques de cet événement s’arrêtent.

Pour essayer votre serveur sur votre ordinateur avant la mise en ligne : Tester votre webhook sur votre ordinateur. Le contenu de chaque événement et ses en-têtes : Documentation > Webhooks.

Tous les événements sont toujours envoyés : ignorez ceux dont vous n’avez pas besoin. Laissez l’adresse vide pour ne plus rien recevoir.