Problèmes de webhooks
L'Incoming Webhook ne répond pas, des valeurs manquent dans la conversation, la salutation tarde ou les statistiques affichent des erreurs.
Quand le téléphone sonne, l'Incoming Webhook charge des données depuis ton système, par exemple le nom de l'appelant dans ton CRM. La réponse est ensuite disponible sous forme de variables dans la salutation et le prompt. Les Statistiques Webhook des dernières 24 heures et les Derniers appels webhook dans l'onglet Personnalité montrent s'il fonctionne bien.
Le webhook échoue
| Cause possible | Solution |
|---|---|
| Ton endpoint ne répond pas avec le statut 200 | Seule une réponse 200 compte comme un succès. Vérifie le journal de ton système |
| La réponse n'est pas un objet JSON | Réponds avec un objet, par exemple {"name": "Camille Martin"}. Une liste ou du texte brut n'est pas repris comme variables |
| Des headers manquent ou sont faux | Vérifie le nom et la valeur sous Headers HTTP, par exemple Authorization: Bearer … |
| Le Template du corps de requête n'est pas un JSON valide | Le tableau de bord affiche Format JSON invalide. Laisse le champ vide : bhomy envoie alors toutes les variables disponibles |
| Ton endpoint n'accepte que certaines adresses IP | L'agent appelle depuis le cloud, sans adresse IP fixe. Sécurise l'endpoint avec un header plutôt qu'avec une liste d'adresses IP autorisées |
Pour tester : clique sur Tester le webhook › Envoyer le test. bhomy envoie une requête avec des données d'exemple et affiche la réponse.
La salutation arrive en retard
La salutation attend la réponse de ton webhook, car elle peut en contenir des valeurs. Si ton système ne répond pas à temps, bhomy réessaie encore 2 fois. C'est seulement ensuite que la conversation commence avec les Valeurs de secours.
| Solution | Effet |
|---|---|
| Réduire le timeout, recommandé de 3 000 à 5 000 millisecondes | Un système lent retarde moins la salutation |
| Répondre vite | Ne lis que les champs dont tu as besoin et utilise un index pour la recherche par numéro de téléphone |
| Définir des valeurs de secours | La conversation reste naturelle même sans réponse |
Des valeurs manquent dans la conversation
| Cause possible | Solution |
|---|---|
| L'espace réservé ne porte pas le même nom que le champ de la réponse | {{first_name}} a besoin exactement de "first_name" dans la réponse |
| La valeur se trouve dans un objet imbriqué | Réponds à plat, par exemple {"customer_name": "…"} au lieu de {"customer": {"name": "…"}} |
| Le webhook a échoué et il n'y a pas de valeur de secours | Définis un remplacement sous Valeurs de secours. Le tableau de bord liste les variables sans valeur de secours sous Valeurs de secours manquantes |
Les statistiques affichent un taux d'erreur élevé
Le message Taux d'erreur élevé ! apparaît quand beaucoup d'appels du webhook des dernières 24 heures ont échoué. Ouvre Derniers appels webhook : pour chaque appel, tu vois s'il a réussi et combien de temps il a duré. Si les dépassements de délai s'accumulent, ton système est trop lent. Si les codes d'erreur s'accumulent, vérifie l'adresse et les headers.
Le webhook après l'appel n'arrive pas
C'est l'outil Ticket CRM sous Automation. Voir Intégrations.
Aide supplémentaire
Envoie-nous l'heure de l'appel, le temps de réponse indiqué dans Derniers appels webhook et le code de statut de ton système, voir Signaler un problème.
Cette page vous a-t-elle aidé ?