Créer un chatbot pour son site avec Claude API : guide pratique 2026

Un chatbot Claude API qui tient la route pour une PME n’a besoin ni de base vectorielle, ni d’agent autonome, ni d’abonnement à trois chiffres par mois. Il tient sur quatre briques : un widget frontend, une fonction backend qui protège la clé API, un contexte métier injecté dans le prompt système, et un garde-fou qui refuse d’inventer un prix. Voici l’architecture que j’installe chez mes clients, les coûts réels d’août 2026, et ce qu’il faut afficher pour rester conforme RGPD.

Le piège du widget IA générique collé sur un site

J’ai vu plusieurs dirigeants brancher un assistant IA générique sur leur site en pensant avoir réglé le sujet en une après-midi. Le problème arrive vite : un visiteur demande le tarif d’une intervention urgente ou la disponibilité d’un produit, et le modèle répond avec un chiffre plausible, cohérent dans le ton, complètement inventé. Un LLM sans contexte fermé complète le texte le plus probable, pas le texte vrai.

Un chatbot Claude API bien construit ne s’appuie jamais sur la connaissance générale du modèle pour les faits qui concernent votre entreprise. Il s’appuie sur un contexte que vous contrôlez : votre FAQ, votre catalogue, vos zones d’intervention, injectés directement dans le prompt système à chaque appel. Si l’information n’y figure pas, la consigne est simple : le chatbot dit qu’il ne sait pas et renvoie vers le formulaire de contact ou un numéro de téléphone. Jamais d’improvisation sur un prix ou un délai.

L’architecture qui suffit pour la grande majorité des PME

Quatre briques, dans cet ordre.

1. Le widget. Un composant React léger (une île Astro, comme le reste de mon stack, animée avec Motion) qui affiche la conversation et envoie chaque message à votre backend. Rien à faire tourner côté client qui touche à la clé API.

2. Une fonction backend qui protège la clé API. Exactement le même principe que le formulaire de contact de ce site, qui passe par netlify/functions/form-handler.mts plutôt que d’exposer une clé côté navigateur. Pour un chatbot, la fonction reçoit le message utilisateur, ajoute le contexte métier et l’historique de conversation, appelle l’API Claude, et retourne la réponse. La clé API ne quitte jamais le serveur.

3. Le contexte métier, injecté en dur dans le prompt système. C’est le point où je vois le plus d’ingénierie inutile chez les projets que j’audite. Pour un catalogue de moins de 50 questions-réponses ou de produits, pas besoin de base vectorielle type Pinecone, pas besoin de pipeline RAG. Le contexte tient dans quelques milliers de tokens, largement sous la fenêtre de contexte de Claude. Je mets la FAQ complète en Markdown dans le prompt système, mise en cache avec le prompt caching de l’API Claude, et c’est terminé. La complexité d’une base vectorielle se justifie à partir de plusieurs centaines de documents à interroger, pas pour la FAQ d’un artisan ou d’une PME de services.

4. Le streaming. L’API Claude retourne la réponse en flux via des server-sent events (stream: true dans l’appel Messages) plutôt que d’attendre la réponse complète. Le visiteur voit le texte apparaître au fur et à mesure, comme sur claude.ai. Sans ça, un chatbot qui met plusieurs secondes à répondre paraît figé, et une partie des visiteurs referme la fenêtre avant la fin.

Quel modèle choisir, et combien ça coûte réellement en août 2026

Pour une FAQ standard (horaires, zone d’intervention, process de devis), Claude Haiku 4.5 suffit largement. C’est le modèle le moins cher de la gamme actuelle : 1 dollar par million de tokens en entrée, 5 dollars en sortie, selon la grille tarifaire d’Anthropic. Anthropic publie d’ailleurs un exemple de calcul officiel pour un cas d’usage support client : environ 3 700 tokens par conversation en moyenne, soit un coût total de 37 dollars pour 10 000 tickets traités avec Haiku 4.5. Ramené à l’échelle d’une PME qui reçoit 300 conversations par mois sur son chatbot, ça tombe autour de 1,10 dollar mensuel de consommation API.

Pour des échanges plus nuancés (conseil produit, pré-qualification d’un devis), je monte sur Claude Sonnet 5, dont le tarif est exactement le double de Haiku 4.5 sur cette période : 2 dollars par million de tokens en entrée et 10 dollars en sortie, en tarif introductif jusqu’au 31 août 2026 (3 et 15 dollars ensuite, au tarif standard qui s’applique déjà à Sonnet 4.6). Sur le même volume de 300 conversations mensuelles, comptez environ 2,20 dollars. Même à volume dix fois supérieur, la facture Claude reste dérisoire comparée à ce que coûte un outil IA tout-en-un.

Ce que coûte l’alternative clé en main

C’est là que la comparaison devient intéressante. J’ai vérifié début août 2026 les grilles tarifaires publiques de deux solutions IA packagées, pour un même volume de 300 conversations résolues par mois.

Solution	Coût mensuel pour ~300 conversations	Ce que vous possédez
Claude API (DIY) avec Haiku 4.5	environ 1,10 $ de consommation API	le code, les données, le contexte
Claude API (DIY) avec Sonnet 5	environ 2,20 $ de consommation API	idem
Crisp, plan Essentials	95 $/mois (450 conversations IA incluses)	widget et IA gérés par Crisp
Intercom Fin	environ 297 $/mois (0,99 $ par résolution)	widget et IA gérés par Intercom

La brique DIY demande un investissement initial que Crisp ou Intercom Fin n’imposent pas : comptez 3 à 5 jours-homme pour l’architecture décrite plus haut, soit un budget ponctuel plutôt qu’un abonnement qui grossit avec le volume. Sur un site qui traite plusieurs centaines de conversations par mois pendant plusieurs années, l’écart se creuse vite en faveur du code qu’on possède. Sur un besoin ponctuel ou un volume qui reste incertain, Crisp reste un choix défendable pour démarrer sans développeur.

Les trois garde-fous que je n’enlève jamais

Contexte fermé, jamais de connaissance générale sur les faits de l’entreprise. Le prompt système précise explicitement que le modèle ne doit répondre sur les tarifs, délais et disponibilités qu’à partir du contexte fourni, jamais par extrapolation. Si l’information manque, la réponse dirige vers un humain.

Sortie contrôlée quand le chatbot déclenche une action. Dès qu’une conversation doit se transformer en action (prise de rendez-vous, envoi d’un email de qualification), je contrains la sortie de Claude à un schéma strict validé avec Zod, exactement comme pour mes pipelines d’extraction de documents. Une donnée qui ne respecte pas le schéma est rejetée, jamais transmise telle quelle à un système derrière.

Journal de conversation systématique. Chaque échange est loggé côté serveur avec un identifiant de session, pas d’historique complet côté navigateur. Ça sert à deux choses : améliorer le contexte au fil du temps, et répondre à une demande d’accès si un visiteur l’exerce.

Le RGPD à afficher avant le premier message

La CNIL a publié en 2026 de nouvelles recommandations sur l’IA et le RGPD qui s’appliquent directement aux chatbots : la personne doit être informée qu’elle échange avec une intelligence artificielle, pas avec un humain. Concrètement, j’ajoute systématiquement une ligne visible au-dessus du champ de saisie (“Vous échangez avec un assistant automatisé”) et un lien vers la politique de confidentialité qui précise la durée de conservation des conversations et les coordonnées pour exercer ses droits.

Deuxième point que beaucoup de dirigeants ignorent : Anthropic n’utilise pas les données envoyées via l’API pour entraîner ses modèles, et propose des contrats à rétention zéro pour les cas qui l’exigent. Ce n’est pas systématique chez tous les fournisseurs d’outils IA à abonnement, et c’est un argument que je fais valoir face à des clients hésitants sur la confidentialité.

Troisième point, la minimisation : le chatbot ne doit recevoir que ce qui sert la conversation. Pas besoin de brancher l’historique CRM complet d’un visiteur anonyme pour répondre à une question sur les horaires d’ouverture.

Résumé

Un chatbot Claude API pour une PME tient sur quatre briques : un widget frontend, une fonction backend qui protège la clé API, un contexte métier fermé injecté dans le prompt système (pas de base vectorielle pour moins de 50 questions), et le streaming pour l’expérience. Claude Haiku 4.5 suffit pour une FAQ standard, à environ 1,10 dollar par mois pour 300 conversations, selon le calcul officiel d’Anthropic. Passez sur Sonnet 5 pour des échanges plus nuancés, à un tarif exactement double. Comparé à Crisp (95 dollars par mois) ou Intercom Fin (environ 297 dollars par mois pour le même volume), l’écart se creuse vite en faveur d’une solution maison, à condition d’investir 3 à 5 jours-homme dans la mise en place initiale et de garder trois garde-fous non négociables : contexte fermé, sortie contrôlée par schéma, et journal de conversation systématique.

Ce qu’il faut retenir

• Un chatbot Claude API pour une PME n’a pas besoin de base vectorielle : la FAQ complète tient dans le prompt système avec le prompt caching pour moins de 50 questions.
• Claude Haiku 4.5 coûte environ 1,10 dollar par mois pour 300 conversations, calcul dérivé de l’exemple officiel Anthropic (37 dollars pour 10 000 tickets support).
• Claude Sonnet 5 coûte exactement le double de Haiku 4.5 sur la période introductive en vigueur jusqu’au 31 août 2026, ensuite le tarif standard s’applique.
• La fonction backend doit toujours protéger la clé API : jamais d’appel direct depuis le navigateur.
• Deux garde-fous non négociables : le chatbot ne répond sur les faits de l’entreprise qu’à partir du contexte fourni, et toute sortie qui déclenche une action passe par un schéma validé avec Zod.
• La CNIL exige que l’utilisateur soit informé qu’il échange avec une IA, avec une durée de conservation précisée et un accès à la politique de confidentialité.