Centre d’aide
Support
Ouvrir l’app

Incoming Webhook

À la sonnerie, charger des données de ton CRM ou système comme variables pour la salutation et le prompt. Requête, réponse, valeurs de secours, statistiques.

Disponible avec: ProIndividualDernière vérification le 25 octobre 2026

Avec l'Incoming Webhook, ton agent sait qui appelle dès que le téléphone sonne. bhomy envoie le numéro de l'appelant à ton URL, ton système répond avec des données comme le nom, le numéro client ou la dernière commande, et l'agent les utilise comme variables. Il salue ainsi les clients réguliers par leur nom ou connaît l'état d'une commande.

Comment ça marche

  1. Un appel arrive.
  2. bhomy envoie une requête avec les données de l'appel à ton URL.
  3. Ton système recherche l'appelant et répond avec un objet JSON.
  4. Chaque champ de la réponse est disponible comme variable, par exemple {{name}}.
  5. L'agent salue l'appelant avec les valeurs de ta réponse.

Le webhook s'exécute pour les appels entrants. Pour les appels sortants, tu transmets les données directement dans le context de l'API Outbound.

Configuration

  1. Ouvre ton agent et reste dans l'onglet Personnalité.
  2. Ouvre la section Webhook entrant et active Webhook activé.
  3. Choisis la Méthode : POST ou GET.
  4. Saisis l'URL du webhook, par exemple l'URL de production d'un webhook n8n.
  5. Règle le Timeout (ms). Nous recommandons de 3 000 à 5 000 millisecondes.
  6. Facultatif : saisis des Headers HTTP, par exemple Authorization avec un token secret.
  7. Facultatif : définis un Template du corps de requête. S'il reste vide, bhomy envoie toutes les variables disponibles.
  8. Définis des Valeurs de secours pour le cas où ton système ne répond pas.
  9. Vérifie tout avec Tester le webhook › Envoyer le test et enregistre.

La requête

Sans template personnalisé, bhomy envoie ces champs. Avec POST en JSON dans le corps, avec GET comme paramètres de requête :

ChampContenu
callIdID unique de l'appel
fromNumbernuméro de l'appelant au format E.164
toNumbernuméro appelé au format E.164
roomNameidentifiant interne de la session de conversation
participantIdentityidentifiant interne de l'appelant dans la session
assistantIdID de ton agent
assistantNamenom de ton agent
{
  "callId": "call_8f2a1c",
  "fromNumber": "+491701234567",
  "toNumber": "+494012345678",
  "roomName": "call-8f2a1c",
  "participantIdentity": "sip_+491701234567",
  "assistantId": "6a90…",
  "assistantName": "Accueil Cabinet Sommer"
}

Avec ton propre Template du corps de requête, tu définis toi-même la structure et insères les champs comme espaces réservés, par exemple :

{ "phone": "{{fromNumber}}", "line": "{{toNumber}}", "source": "bhomy" }

La réponse

Réponds avec le statut 200 et un objet JSON plat. Chaque champ devient une variable :

{
  "name": "Anna Berger",
  "customer_number": "K-10442",
  "last_appointment": "12 octobre",
  "open_invoice": "non"
}

Dans le prompt et la salutation, tu utilises les valeurs avec des doubles accolades :

Salutation : Bonjour {{name}}, merci de votre appel. Comment puis-je vous aider ?

Délais et valeurs de secours

La salutation attend la réponse de ton webhook. Si ton système ne répond pas avec 200 ou pas dans le délai du timeout, bhomy réessaie encore 2 fois après une courte pause. Si cela échoue toujours, la conversation commence avec les Valeurs de secours. Chaque valeur de secours s'applique aussi si ta réponse ne contient pas un champ.

VariableValeur de secoursSalutation sans réponse
namechère cliente, cher client« Bonjour chère cliente, cher client … »

Sous Valeurs de secours manquantes, le tableau de bord liste chaque variable qui apparaît dans le prompt ou la salutation sans valeur de secours. Sans valeur de secours et sans réponse, bhomy supprime l'espace réservé.

Sécurité

PointRecommandation
AuthentificationVérifie dans ton système un header secret, par exemple Authorization: Bearer …. Il n'y a pas d'adresses IP fixes, l'agent appelle depuis le cloud
ChiffrementUtilise une adresse HTTPS
Minimisation des donnéesNe réponds qu'avec les champs dont l'agent a besoin dans la conversation. Tout ce qui figure dans la réponse peut être communiqué à l'appelant

Statistiques et derniers appels

Sous Statistiques Webhook, tu vois pour les dernières 24 heures le nombre d'appels, le taux de réussite, le temps de réponse moyen et les erreurs. Derniers appels webhook affiche chaque appel individuellement. Les statistiques se remplissent dès le premier vrai appel. En cas de nombreuses erreurs, consulte Problèmes de webhooks.