Intégrations

Webhooks

Donnez à votre réceptionniste des outils personnalisés qui appellent vos points de terminaison HTTP.

L’intégration Webhook Tool expose vos points de terminaison HTTP en tant qu’outils que votre réceptionniste ou assistant professionnel peut appeler pendant les conversations. L’IA décide d’appeler le point de terminaison en fonction de la conversation.

Fonctionnement des outils webhook

Lorsque vous créez un outil webhook, vous définissez :

  1. Un point de terminaison HTTP à appeler.
  2. Une description de sa fonction, afin que l’IA sache quand l’utiliser.
  3. Les paramètres que l’IA doit collecter à partir de la conversation.

Lors d’un appel, lorsque la conversation correspond à la finalité de l’outil, votre réceptionniste collecte les paramètres, appelle le point de terminaison et utilise la réponse pour poursuivre la conversation.

Créer un outil webhook

Accédez à Integrations, sélectionnez Add integration, puis choisissez Webhook Tool. Configurez les champs ci-dessous et sélectionnez Enable. Vous pouvez ajouter plusieurs outils webhook.

ChampDescription
NameNom de l’outil visible par l’IA, par exemple check_order_status
DescriptionQuand et pourquoi utiliser cet outil
MethodGET, POST, PUT, PATCH ou DELETE
URLVotre point de terminaison HTTP
Response timeout (seconds)Temps d’attente pour votre serveur : 5 à 120 secondes, 20 par défaut
Assign to agentsReceptionist, Assistant agent ou les deux
Disable interruptionsEmpêche l’appelant d’interrompre pendant l’exécution de l’outil
Request HeadersEn-têtes facultatifs envoyés avec chaque requête, comme une clé API
Body ParametersParamètres envoyés dans le corps de la requête
Query ParametersParamètres envoyés comme chaînes de requête URL

Paramètres

Chaque paramètre comporte :

  • Key : le nom du champ.
  • Type : string, number ou boolean.
  • Description : la valeur que l’IA doit extraire de la conversation.
  • Required : indique si l’IA doit le collecter avant l’appel.

Cas d’usage

ScénarioDescriptionMéthode
Consultation CRMRecherche les informations client dans votre systèmeGET
Vérification des stocksVérifie la disponibilité des produits en temps réelGET
Collecte de prospectsEnvoie les informations de l’appelant à votre système marketingPOST
Création de ticketCrée un ticket d’assistance pendant l’appelPOST
DevisCalcule un devis personnalisé selon les besoins de l’appelantPOST

Exemple

Une entreprise de plomberie crée un outil webhook :

  • Name: check_service_area
  • Description: “Vérifie si nous intervenons dans le code postal de l’appelant et quel est le prochain créneau disponible.”
  • URL: https://api.mybusiness.com/check-area
  • Method: POST
  • Request Headers: Authorization défini sur la clé API de l’entreprise
  • Body Parameters: zip_code (chaîne, requis), service_type (chaîne, requis)

Lorsqu’un appelant demande si vous intervenez dans sa zone, le réceptionniste collecte son code postal, appelle le webhook et lui communique le résultat.

Les outils webhook sont disponibles avec tous les forfaits.