Recevoir les événements par webhook
Appel manqué, texto reçu, message vocal : votre serveur est prévenu.
Rôle : GestionnaireDurée : 3 minSur : Web
Avant de commencer
- Être gestionnaire du compte Callizy.
- Une adresse publique en https qui reçoit des requêtes POST : votre serveur, ou un outil comme Make.
Pas à pas
5 étapes, environ 3 min- 1
Ouvrez l’onglet Webhooks
10 sDans Développeurs, onglet Webhooks, cliquez Nouveau webhook.
Administration/Réglages/Développeurs/Webhooks
Ouvrir cet écran dans Callizy - 2
Nom et adresse
30 sNom : à quoi il sert, par exemple « Appels manqués ». URL de destination : l’adresse qui recevra les événements.
- 3
Choisissez les événements
30 sSous Événements à écouter, cochez ce qui vous intéresse parmi 17 : Appel manqué, Message vocal reçu, SMS reçu, Résumé prêt, Rendez-vous pris… Puis Créer : « Webhook créé. »
- 4
Testez
20 sSur la carte du webhook, cliquez Tester. Le résultat s’affiche dessous, par exemple « Votre adresse a répondu HTTP 200 : test reçu. »
- 5
Vérifiez la signature
1 minChaque envoi porte l’en-tête X-Callizy-Signature : un HMAC-SHA256 du corps brut, calculé avec le Secret de signature de la carte. Cliquez Afficher pour le voir et le copier, à tout moment.
À retenir
- 17 événements : appels, messages vocaux, textos, contacts, rendez-vous et tâches.
- Un envoi raté est réessayé pendant près de trois jours ; après 5 jours d’échecs, le webhook se met en pause.
- Les Zaps qui écoutent Callizy apparaissent aussi dans cet onglet.
Ça ne marche pas ?
Callizy affiche « URL invalide »
- Entrez une adresse complète, qui commence par https://.
Callizy affiche « Sélectionnez au moins un événement »
- Cochez au moins un événement sous Événements à écouter.
Callizy affiche « Votre adresse a répondu HTTP 401 : elle a refusé le test »
- Votre adresse exige un en-tête Authorization : acceptez les requêtes sans, Callizy signe chacune avec X-Callizy-Signature.
Callizy affiche « Votre adresse n’a pas répondu en 10 secondes »
- Répondez tout de suite par un 200, puis traitez l’événement ensuite.
Callizy affiche « Cette adresse ne peut pas recevoir de webhooks : elle n’est pas publique »
- Utilisez une adresse joignable depuis Internet : ni localhost, ni une adresse du réseau interne.
La carte affiche des échecs récents
- Cliquez Tester pour voir la réponse de votre adresse.
- Après 24 h d’échecs, les gestionnaires reçoivent un courriel ; après 5 jours, le webhook se met en pause : corrigez l’adresse, puis cliquez Activer.
Questions fréquentes
Où voir l’historique des envois ?
Pourquoi des webhooks « Zapier — … » ?
Est-ce inclus dans mon abonnement ?
Mis à jour le 27 octobre 2026