Liaison bot : laissez l'IA consulter votre propre système

Ce qu'elle fait

• Avant la conversation : si votre système propose lookup_caller, Twilper reconnaît l'appelant ou le visiteur.
• Pendant la conversation : l'IA appelle les outils de votre système (par exemple recherche de produits, statut de commande, options et prix). Dans le chat du site, le visiteur voit un court message indiquant que la recherche est en cours.
• L'IA ne donne les détails d'une commande qu'après un numéro de commande accompagné d'une adresse e-mail ou d'un code postal.

Ce qu'il vous faut

• Un endpoint https dans votre propre système, construit comme décrit sur twilper.com/integrations/api.
• Une clé de signature d'au moins 32 caractères (ou laissez Twilper en créer une).

Configurer

1. 1

   Étape 1: Ouvrez la liaison bot

   Allez dans "Intégrations" et faites défiler jusqu'à "Connecter votre propre système (liaison bot)".

   

2. 2

   Étape 2: Saisissez l'endpoint

   Saisissez l'adresse de votre système dans le champ "URL de l'endpoint", par exemple https://votresite.fr/api/twilper/channel.

3. 3

   Étape 3: Clé et activation

   Collez votre propre clé dans le champ "Clé de signature" ou laissez-le vide pour en faire créer une. Cochez la case d'activation et cliquez sur "Enregistrer".

Règles et réglages

• Chaque requête est signée avec HMAC-SHA256. Votre système doit vérifier la signature et refuser les requêtes sans signature valide.
• Chaque requête contient un contexte avec le canal, l'appelant ou le visiteur, et indique si l'identité est vérifiée. Ne renvoyez que les données qui appartiennent à cette personne.
• L'IA utilise les mêmes outils dans le chat du site, sur WhatsApp et au téléphone.

Tester

• Utilisez "Tester la liaison" sur la carte : choisissez un canal (chat du site, WhatsApp ou téléphone), tapez un message comme "Où en est ma commande ?" et cliquez sur "Envoyer un test". Vous voyez la réponse et les outils que l'IA peut appeler.
• Posez ensuite la même question dans le vrai chat du site et vérifiez les journaux de votre système.

Problèmes fréquents

• L'IA répond elle-même au lieu de votre système : votre endpoint n'a pas répondu dans les 6 secondes (outils : 4 secondes) ou a renvoyé une erreur. Twilper se rabat alors sur l'IA intégrée.
• Signature non concordante : veillez à utiliser le corps brut de la requête et la même clé que dans Twilper.