Connecter WaBot à votre API — guide complet d'intégration
Connectez votre bot à n'importe quelle API externe pour qu'il réponde avec des données en temps réel : commandes, stocks, réservations, etc.
Comment fonctionne l'intégration API
WaBot supporte deux modes d'intégration : la documentation API (le bot connaît votre API mais ne l'appelle pas directement) et les endpoints appelables (le bot fait des requêtes HTTP réelles en temps réel).
Dans les deux cas, le système utilise le tool use d'OpenAI : quand le bot reçoit une question qui nécessite des données dynamiques, il décide automatiquement d'appeler l'API appropriée, récupère le résultat et formule une réponse naturelle.
Exemple : un client envoie 'Où en est ma commande 4821 ?' → le bot appelle GET /orders/4821 → récupère le statut → répond 'Votre commande est en cours de livraison, arrivée prévue aujourd'hui.'
Mode documentation — injecter le contexte API
Le mode le plus simple : dans les paramètres du bot, activez 'Ce bot a accès à une API' et collez votre documentation (OpenAPI, Markdown, JSON).
L'IA lira cette documentation et pourra répondre à des questions sur votre API, expliquer les endpoints disponibles, et guider les développeurs. Elle ne fera pas d'appels réels mais utilisera la doc comme base de connaissance.
Ce mode est idéal pour un bot de support technique destiné aux développeurs qui intègrent votre API.
Mode endpoints — appels API en temps réel
Pour les appels réels, configurez vos endpoints dans la base de données (ou via l'API WaBot). Chaque endpoint a : un nom, une URL, une méthode HTTP, un type d'authentification et une description.
Types d'authentification supportés : aucun (API publique), Bearer Token (Authorization: Bearer {token}), et API Key (X-API-Key: {key}). Les tokens sont stockés dans les variables d'environnement du bot.
La description de chaque endpoint est cruciale : c'est elle qui permet à l'IA de savoir quand utiliser quel endpoint. Soyez précis : 'Récupère les détails d'une commande par son ID. Paramètre : order_id (string, requis).'
Alternative : scraping de site web
Si votre entreprise n'a pas d'API mais possède un site web, WaBot peut scraper les pages pour répondre aux questions. Activez 'Ce bot peut consulter un site web' et entrez l'URL de base.
Utilisez le bouton 'Vérifier' pour confirmer que le site est accessible et que le robots.txt autorise le scraping.
Le scraping est moins précis qu'une API structurée mais permet de démarrer rapidement. Le bot récupère le contenu HTML, extrait le texte et répond aux questions en se basant sur ce contenu.
Exemple complet : bot de suivi de commandes
Prérequis : une API REST avec au minimum GET /orders/{id} retournant le statut de la commande.
Configuration : 1) Ajoutez ORDERS_API_KEY dans les variables d'environnement. 2) Configurez l'endpoint 'get_order' : GET https://api.votresite.com/orders/{id}, auth bearer, authEnvKey: ORDERS_API_KEY. 3) Description : 'Récupère le statut d'une commande. Paramètre : order_id (numéro de commande).'
Instructions du bot : 'Quand un client mentionne un numéro de commande (format #XXXX ou juste des chiffres), appelle immédiatement l'outil get_order avec ce numéro. Présente le résultat de façon claire et amicale.'