Les webhooks permettent des intégrations en temps réel avec des systèmes externes. De plus, ils envoient automatiquement des données lorsque des événements surviennent. Dans ce guide, nous vous montrerons comment configurer et utiliser les webhooks efficacement.
Qu’est-ce qu’un webhook? #
Un webhook est un moyen pour VoxPria d’envoyer automatiquement des données à votre système externe. De plus, les webhooks se déclenchent en temps réel lorsque des événements se produisent.
Comment fonctionnent les webhooks : #
- Un événement survient dans VoxPria (p. ex., un appel se termine)
- VoxPria envoie une requête HTTP POST à votre URL
- Votre système reçoit les données
- Votre système les traite et répond
Cas d’usage courants #
Les webhooks sont puissants pour les intégrations. De plus, ils permettent d’innombrables scénarios d’automatisation :
- Mises à jour du CRM – Synchroniser les données d’appel vers Salesforce/HubSpot
- Enregistrement en base de données – Stocker les dossiers d’appel dans votre base de données
- Notifications – Alerter votre équipe via Slack/Discord
- Analytique – Envoyer des données vers Google Analytics/Mixpanel
- Billetterie – Créer des tickets de soutien à partir des appels
- Logique personnalisée – Déclencher vos propres flux de travail d’affaires
Prérequis #
Avant de configurer des webhooks, vous aurez besoin de :
- URL de point de terminaison – URL HTTPS où les données seront envoyées
- Accès serveur – Capacité à recevoir des requêtes HTTP POST
- Connaissances de base en développement – Compréhension de JSON et des API
Créer un webhook #
La configuration des webhooks est simple. De plus, VoxPria gère toute la complexité :
- Allez à AUTOMATISATION DE FLUX → Webhooks
- Cliquez sur « Créer un webhook »
- Configurez les paramètres du webhook
Champs obligatoires : #
- Nom – Nom descriptif (p. ex., « Synchronisation Salesforce »)
- URL – Votre point de terminaison (doit être en HTTPS)
- Événements – Quels événements déclenchent le webhook
- Authentification – En-têtes de sécurité facultatifs
Événements disponibles #
Choisissez quels événements doivent déclencher votre webhook. De plus, vous pouvez sélectionner plusieurs événements :
- call.started – Lorsqu’un appel commence
- call.answered – Lorsqu’un appel est répondu
- call.ended – Lorsqu’un appel se termine
- call.failed – Lorsqu’un appel échoue
- campaign.started – Une campagne commence
- campaign.completed – Une campagne se termine
- contact.created – Nouveau contact ajouté
- contact.updated – Contact modifié
Charge utile du webhook #
VoxPria envoie des données JSON dans chaque webhook. De plus, la structure est cohérente et bien documentée :
Exemple de charge utile (call.ended) : #
{
"event": "call.ended",
"timestamp": "2025-02-02T14:30:00Z",
"data": {
"call_id": "call_abc123",
"campaign_id": "camp_xyz789",
"contact_id": "cont_def456",
"phone_number": "+15551234567",
"status": "answered",
"duration": 127,
"recording_url": "https://...",
"transcript": "...",
"variables": {
"appointment_confirmed": true,
"appointment_date": "2025-02-10"
}
}
}Authentification #
Sécurisez vos webhooks avec l’authentification. De plus, cela empêche les accès non autorisés :
Méthodes d’authentification : #
- En-tête de clé API – En-tête personnalisé avec clé secrète
- Authentification de base – Nom d’utilisateur et mot de passe
- Jeton OAuth – Jeton porteur (Bearer)
- Signature HMAC – Signature cryptographique
Exemple : Ajoutez l’en-tête Authorization: Bearer your_secret_key
Tester les webhooks #
Testez toujours avant d’activer. De plus, VoxPria fournit des outils de test :
- Après avoir créé le webhook, cliquez sur « Tester le webhook »
- VoxPria envoie une charge utile de test à votre URL
- Vérifiez que votre point de terminaison a bien reçu les données
- Vérifiez que votre système les a traitées correctement
- Corrigez les erreurs et retestez
Surveiller la livraison des webhooks #
Suivez les réussites et les échecs des webhooks. De plus, les journaux aident au débogage :
- Allez à AUTOMATISATION DE FLUX → Webhooks
- Cliquez sur votre webhook
- Consultez les « Livraisons récentes »
- Consultez les codes de statut et les temps de réponse
- Relancez les livraisons échouées au besoin
Codes de statut : #
- 🟢 200-299 : Succès
- 🔴 400-499 : Erreur du client (vérifiez votre point de terminaison)
- 🔴 500-599 : Erreur du serveur (problème de votre côté)
- 🔴 Délai dépassé : La réponse a pris plus de 30 secondes
Gestion des erreurs #
VoxPria relance automatiquement les webhooks échoués. De plus, la logique de relance est intelligente :
- Calendrier de relance : Immédiat, 1 min, 5 min, 30 min, 2 h, 12 h
- Tentatives maximales : 6 tentatives au total
- Délai exponentiel : Délais croissants entre les relances
- Relance manuelle : Vous pouvez relancer manuellement en tout temps
Meilleures pratiques #
- ✅ Utilisez HTTPS – N’utilisez jamais de points de terminaison en HTTP
- ✅ Répondez rapidement – Traitez de façon asynchrone, répondez en moins de 5 secondes
- ✅ Retournez 200 – Retournez toujours un statut de succès
- ✅ Validez les requêtes – Vérifiez les en-têtes d’authentification
- ✅ Gérez les doublons – Utilisez call_id pour éviter le traitement en double
- ✅ Consignez tout – Conservez des journaux des webhooks reçus
- ✅ Surveillez les échecs – Configurez des alertes pour les erreurs de webhook
En savoir plus sur les webhooks et leur mise en œuvre technique.
Articles connexes :
