Votre chatbot Chatbotty répond déjà aux questions sur votre site web via son widget. Mais que faire si vous souhaitez que votre chatbot IA vive aussi ailleurs — dans votre propre application mobile, un portail client ou un outil interne utilisé quotidiennement par votre équipe ? C'est exactement à cela qu'une **API** sert. Ce guide explique ce qu'est une API en termes simples, comment fonctionne l'API Chatbotty, ce que vous pouvez construire avec, et comment créer votre première clé API. Aucun diplôme en informatique requis — juste une vision claire de la façon dont les éléments s'assemblent. Ceci est le premier article d'une série. Ici, nous couvrons la vue d'ensemble ; les articles suivants détailleront chaque partie de l'API. ## Qu'est-ce qu'une API, exactement ? API signifie *Interface de Programmation d'Applications*. Cela semble technique, mais l'idée est simple : une API est un moyen pour deux logiciels de communiquer directement, sans qu'un humain clique sur des boutons entre les deux. Pensez-y comme commander au restaurant. Vous n'entrez pas dans la cuisine pour cuisiner votre propre repas. Vous dites au serveur ce que vous voulez, le serveur transmet votre commande à la cuisine, et la nourriture revient à votre table. Le serveur est l'API — un messager qui prend votre demande, la transmet au système qui fait le travail, et rapporte la réponse. Avec Chatbotty, la « cuisine » est votre chatbot IA et sa base de connaissances. L'API est le messager avec lequel votre logiciel communique. Votre application envoie une question, le chatbot trouve la réponse, et l'API renvoie cette réponse directement à votre application — tout cela en une fraction de seconde. ## Pourquoi connecter votre chatbot à une API ? Le widget de chat est parfait pour votre site web. Mais une API ouvre toutes les autres possibilités : - **Intégrer un chatbot dans votre propre application.** Placez votre assistant IA dans une application mobile ou une application web personnalisée, avec votre propre design autour. - **Connecter votre chatbot à d'autres outils.** Envoyez des réponses dans un service d'assistance, un canal Slack ou un tableau de bord interne. - **Automatiser votre base de connaissances.** Téléchargez automatiquement de nouveaux documents dans votre chatbot chaque fois que les informations sur votre produit changent. - **Extraire vos propres rapports.** Lisez l'historique des conversations et les analyses dans vos systèmes au lieu de vérifier manuellement le tableau de bord. En résumé : le widget est la porte d'entrée prête à l'emploi, et l'API est l'ensemble des clés qui vous permet de construire vos propres portes où vous en avez besoin. ## Ce que vous pouvez faire avec l'API Chatbotty L'API Chatbotty est organisée en cinq domaines. Vous trouverez des exemples de code prêts à copier pour chacun directement dans votre tableau de bord, sous **Intégration API**. - **API Chat** — envoyez un message à votre chatbot et recevez la réponse IA, le même moteur qui alimente votre widget. - **API Documents** — téléchargez, listez et supprimez les documents qui composent la base de connaissances de votre chatbot. - **API Conversations** — lisez les conversations passées et leurs messages. - **API Analytics** — récupérez des statistiques agrégées comme le nombre total de questions et le taux de réussite. - **API Tickets** — listez les tickets de support, changez leur statut et ajoutez des notes internes. Ne vous inquiétez pas encore des détails. Chacun de ces domaines aura son propre article dédié. Pour l'instant, sachez simplement que presque tout ce que vous voyez dans le tableau de bord, vous pouvez aussi y accéder via l'API. ## Comment les clés API sécurisent votre chatbot Un logiciel ne peut pas se connecter avec un email et un mot de passe comme vous le faites. À la place, il prouve son identité avec une **clé API** — une longue chaîne secrète de caractères. Chaque requête envoyée par votre application inclut cette clé pour que Chatbotty sache que la requête vient bien de vous et à quel chatbot elle appartient. La clé est envoyée dans une partie de la requête appelée *en-tête Authorization*, sous la forme d'un **jeton Bearer**. Vous n'avez pas besoin de mémoriser ces termes — les exemples de code dans votre tableau de bord les incluent déjà. Il vous suffit de remplacer le placeholder `YOUR_API_KEY` par votre vraie clé et c'est tout. Une clé est liée à un chatbot spécifique. Vous n'avez jamais besoin d'envoyer un ID de chatbot — Chatbotty déduit quel chatbot vous désignez à partir de la clé elle-même. Une clé API est comme un mot de passe pour votre chatbot. Toute personne qui la possède peut communiquer avec votre chatbot et lire ses données. Ne la collez jamais dans un code public, le front-end d'un site web ou un document partagé — gardez-la sur votre propre serveur sécurisé. ## Comment créer votre première clé API Créer une clé prend environ dix secondes. Voici tout le processus. 1. Ouvrez votre tableau de bord et allez dans **Intégration API** dans le menu de gauche. 2. Trouvez le chatbot que vous voulez connecter. Chaque chatbot a sa propre section **Clés API**. 3. Cliquez sur **Créer une nouvelle clé API**. 4. Donnez un nom à la clé que vous reconnaîtrez plus tard, comme *Site web de production* ou *Application mobile*. Le nom est juste pour vous — il vous aide à vous souvenir où chaque clé est utilisée. 5. Cliquez sur **Créer**. Votre toute nouvelle clé apparaît immédiatement. Copiez votre clé maintenant et conservez-la en lieu sûr. Pour des raisons de sécurité, la clé complète n'est affichée qu'une seule fois. Après avoir fermé cette fenêtre, le tableau de bord n'affiche que les premiers caractères. Si vous la perdez, supprimez simplement l'ancienne clé et créez-en une nouvelle. Vous pouvez créer plusieurs clés par chatbot — un moyen pratique de donner à chaque application sa propre clé. Vous pouvez désactiver une clé à tout moment sans la supprimer, ou la supprimer définitivement quand elle n'est plus nécessaire. ## Votre première requête API Une fois que vous avez une clé, communiquer avec votre chatbot se résume à une simple requête. Voici l'exemple le plus simple utilisant cURL, un outil de ligne de commande basique : ```bash curl -X POST "https://www.chatbotty.ai/api/v1/chat" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"message": "Quels sont vos horaires d'ouverture ?"}' ``` Votre chatbot lit le message, cherche dans sa base de connaissances, et répond — exactement comme il le ferait dans le widget. La toute première requête de chat crée aussi une *conversation*, et vous pouvez renvoyer son ID dans la requête suivante pour poursuivre la conversation avec tout le contexte. Vous préférez JavaScript, Python ou Node.js ? Chaque exemple dans le tableau de bord est aussi disponible dans ces langages, prêt à être copié. ## Qui peut utiliser l'API ? L'API Chatbotty est disponible dans les plans **Évaluation**, **Elite** et **Entreprise**. Si votre plan actuel n'inclut pas encore l'accès à l'API, la page d'Intégration API vous montrera les options de mise à niveau. Les requêtes de chat envoyées via l'API comptent dans votre quota mensuel de messages, tout comme les chats depuis le widget — les autres domaines, comme les analyses et les conversations, n'utilisent pas de messages. ## Prêt à commencer à construire ? Voici le tableau complet : une API permet à votre propre logiciel de parler directement à votre chatbot, une clé API sécurise cette connexion, et le tableau de bord vous fournit du code fonctionnel pour chaque partie. Ouvrez la page d'Intégration API, créez votre première clé, et essayez une requête de chat unique — une fois que vous verrez votre chatbot répondre via l'API, tout le reste s'imbriquera naturellement. Restez à l'affût des prochains articles de cette série, où nous explorerons les API Chat, Documents, Conversations, Analytics et Tickets une par une.