# Recevoir les événements par webhook

Appel manqué, texto reçu, message vocal : votre serveur est prévenu.

- Rôle : Gestionnaire
- Durée : 3 min
- Sur : Web
- Centre d’apprentissage : https://callizy.ca/fr/apprendre/webhooks
- Parcours intégrations · Leçon 8
- Ouvrir cet écran dans Callizy : https://app.callizy.ca/fr/manager?view=integrations
- La page sur callizy.ca : https://callizy.ca/docs

## 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 s)

Dans **Développeurs**, onglet **Webhooks**, cliquez **Nouveau webhook**.

Menu : Administration › Réglages › Développeurs › Webhooks

### 2. Nom et adresse (30 s)

**Nom** : à quoi il sert, par exemple « Appels manqués ». **URL de destination** : l’adresse qui recevra les événements.

### 3. Choisissez les événements (30 s)

Sous **É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 s)

Sur 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 min)

Chaque 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 »

1. Entrez une adresse complète, qui commence par https://.

### Callizy affiche « Sélectionnez au moins un événement »

1. Cochez au moins un événement sous **Événements à écouter**.

### Callizy affiche « Votre adresse a répondu HTTP 401 : elle a refusé le test »

1. 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 »

1. 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 »

1. Utilisez une adresse joignable depuis Internet : ni localhost, ni une adresse du réseau interne.

### La carte affiche des échecs récents

1. Cliquez **Tester** pour voir la réponse de votre adresse.
2. 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 ?

Pas encore dans l’app : l’API donne les 30 derniers jours, GET /api/v1/webhooks/deliveries/.

### Pourquoi des webhooks « Zapier — … » ?

Chaque Zap qui écoute Callizy en crée un. Supprimez le Zap dans Zapier plutôt que le webhook.

### Est-ce inclus dans mon abonnement ?

Oui, dans tous les forfaits, dès Solo.

Mis à jour le 27 octobre 2026.