Tu ouvres WhatsApp. Tu écris « est-ce qu'un CDD peut faire des heures supplémentaires ? ». Trente secondes plus tard, tu as la réponse avec l'article du Code du travail en source.
Ce document est le mode d'emploi. Trois commandes pour démarrer, cinq étapes guidées, puis le branchement aux sources officielles de l'État. Tu n'écris pas une ligne de code : c'est Claude Code qui l'écrit, tu réponds à ses questions.
1Ce qu'il te faut avant de commencer
Quatre choses. Si l'une manque, tu te bloqueras à la première commande — c'est l'erreur la plus fréquente, et le point que les guides trouvés en ligne oublient systématiquement.
| Prérequis | Où | Remarque |
|---|---|---|
| Python 3.11 ou plus | python.org | Vérifie avec python3 --version. Le script refuse de démarrer en dessous |
| Claude Code | npm install -g @anthropic-ai/claude-code | Demande Node.js installé avant |
| Une clé API Anthropic | Réglages → API Keys | Distincte de ton abonnement Claude. C'est un compte à part, facturé à l'usage |
| Un accès WhatsApp Business | Zernio ou Meta | Le choix se fait pendant le setup — voir l'étape 4 |
2Les trois commandes de départ
Le dépôt est ici : github.com/Hainrixz/whatsapp-agentkit — open source, licence MIT, gratuit. Tu l'ouvres dans ton terminal :
git clone https://github.com/Hainrixz/whatsapp-agentkit.git
cd whatsapp-agentkit
bash start.shstart.sh ne construit rien. Il vérifie ton environnement en quatre points : la version de Python, la présence de Claude Code, la création des dossiers, et la préparation du fichier de configuration. S'il s'arrête, il te dit exactement ce qui manque.
Ensuite tu lances Claude Code et tu tapes une seule commande :
claude
# puis, dans Claude Code :
/build-agent3Les cinq étapes que Claude Code déroule
À partir de /build-agent, tu n'as plus qu'à répondre. Voici ce qui se passe, pour que tu saches où tu en es.
Étape 1 — Il prépare le terrain
Contrôle de Python, création des dossiers, installation des dépendances, préparation du fichier de configuration. Automatique.
Étape 2 — Il t'interroge
Dix questions, posées une par une : le nom de ton activité, ce que tu fais, à quoi doit servir l'agent, comment il s'appelle, quel ton il adopte, tes horaires, tes fichiers de tarifs ou de documentation, ta clé API, et par quel service tu connectes WhatsApp.
Étape 3 — Il construit
Il écrit le serveur qui reçoit les messages, la connexion à Claude, l'historique par client, les fichiers de configuration de ton activité, et de quoi déployer. Tu regardes défiler.
Étape 4 — Tu testes, sans WhatsApp
Un simulateur de conversation dans ton terminal : tu écris comme si tu étais un client, l'agent répond. Rien n'est encore en ligne, aucun vrai message n'est envoyé. Si une réponse ne te plaît pas, tu le dis à Claude Code en français et il ajuste sur-le-champ.
Étape 5 — Tu le mets en ligne
Il te guide pour publier sur GitHub, brancher un hébergeur (Railway par défaut), charger tes clés et configurer la réception des messages. À partir de là, ton numéro répond.
4Le choix à faire : par où passe ton WhatsApp
Question posée pendant l'entretien. Deux chemins, et ce n'est pas un détail technique — c'est un choix de confidentialité.
| Zernio | Meta Cloud API | |
|---|---|---|
| Ce que c'est | Un intermédiaire qui gère la connexion pour toi | L'API officielle de Meta, en direct |
| App Facebook à créer | Non | Oui, avec validation |
| Mise en route | ★ Rapide | Plus longue |
| Tester sans numéro | Oui, bac à sable | Oui, mais après création de l'app |
| Tes messages transitent par | Un tiers, puis Meta | Meta uniquement |
Bonne nouvelle : changer d'avis plus tard tient en une phrase adressée à Claude Code. Tu n'es pas enfermé.
5Brancher les sources officielles
À ce stade, tu as un agent qui répond avec ce que tu lui as écrit pendant l'entretien. Utile pour des horaires ou des tarifs. Insuffisant dès qu'il faut une information à jour et vérifiable.
C'est l'étape que le dépôt ne fait pas, et il l'assume : les fonctions prévues pour aller chercher de l'information existent, mais elles ne sont pas reliées à l'agent. Voilà comment on les relie.
Les adresses à connaître
data.gouv.fr — public, sans compte, sans clé. La plateforme d'open data de l'État expose son propre point d'accès à l'adresse https://mcp.data.gouv.fr/mcp, en lecture seule. C'est le meilleur endroit pour tester, puisqu'il n'y a ni inscription ni carte bancaire. Documentation officielle.
OpenLegi — le juridique et les entreprises. Service tiers (openlegi.fr), une adresse par périmètre :
| Périmètre | Ce que ça couvre | Adresse |
|---|---|---|
| Légifrance | Codes, JORF, jurisprudence, LODA | mcp.openlegi.fr/legifrance/mcp |
| RNE | Registre national des entreprises | mcp.openlegi.fr/rne/mcp |
| BODACC | Annonces, procédures collectives | mcp.openlegi.fr/bodacc/mcp |
| BOFiP | Doctrine fiscale | mcp.openlegi.fr/bofip/mcp |
| EUR-Lex | Législation européenne | mcp.openlegi.fr/eurlex/mcp |
Deux modes de connexion : OAuth (recommandé pour claude.ai) ou un jeton personnel placé dans l'adresse ou l'en-tête — c'est ce second mode qui convient à un agent qui tourne sur un serveur. Leur guide de démarrage. Attention, tous les périmètres ne sont pas au même régime : plusieurs sources annoncent RNE, EUR-Lex et Judilibre comme réservés à un abonnement. Confirme avant d'annoncer un budget.
La modif, en une phrase à Claude Code
Il n'y a pas de gros développement. L'API d'Anthropic sait se connecter seule à une source distante : tu lui donnes l'adresse, elle va y chercher l'information quand la question le demande. Concrètement, tu ouvres Claude Code dans ton projet et tu lui demandes de brancher la source. Trois réglages, dans le fichier qui fabrique la réponse :
- déclarer la source, avec son adresse et un nom, dans
mcp_servers; - déclarer aussi la trousse d'outils correspondante dans
tools, sous la formemcp_toolset, en reprenant exactement le même nom ; - activer l'option, encore en bêta, via l'en-tête
mcp-client-2025-11-20.
Un piège de raisonnement pour finir : les connecteurs que tu as branchés dans ton compte Claude ne suivent pas. Ce sont deux plomberies séparées. Ton compte, c'est pour tes conversations à toi. Ton agent WhatsApp tape sur l'API avec ses propres accès, qu'il faut lui donner explicitement.
6Ce que ça coûte vraiment
Le dépôt est gratuit. Ce que tu paies, c'est l'usage. Un agent ne se facture pas au message mais au volume de texte traité — et à chaque échange, tout l'historique de la conversation est renvoyé. C'est ce qui fait grimper la note plus vite qu'on ne l'imagine.
Les tarifs officiels par million d'unités de texte, entrée puis sortie :
| Modèle | Tarif | Quand l'utiliser |
|---|---|---|
| Claude Opus 5 | 5 $ / 25 $ | L'agent doit raisonner sur des règles complexes |
| Claude Sonnet 5 | 2 $ / 10 $ | ★ Le bon équilibre pour de la relation client |
| Claude Haiku 4.5 | 1 $ / 5 $ | Questions fréquentes et réponses courtes |
Ajoute à ça l'hébergement, quelques euros par mois, et le coût des conversations facturé par Meta. Le levier le plus efficace pour faire baisser la facture n'est pas de changer de modèle : c'est de ne pas charger l'agent d'informations que tes clients ne demandent jamais.
7Les quatre points de vigilance
Si tu ne retiens qu'une section, c'est celle-ci. C'est ce qui sépare une démo d'un outil qu'on laisse tourner devant des clients.
La sécurité de ton adresse. Chaque message entrant est signé, et l'agent vérifie cette signature. Mais si tu laisses le champ correspondant vide dans ta configuration, le serveur démarre quand même et laisse tout passer — avec un simple avertissement dans les journaux. C'est prévu pour te laisser tester sans blocage. N'oublie pas de le remplir avant d'ouvrir à de vrais clients : sans lui, n'importe qui connaissant ton adresse peut faire parler ton agent à tes frais.
L'agent ne peut pas écrire le premier. WhatsApp n'autorise le texte libre que dans les 24 heures suivant le dernier message du client. Au-delà, il faut un message type validé par Meta. Toute promesse de relance automatique ou de newsletter WhatsApp se heurte à cette règle — c'est faisable, mais bien plus lourd que ce qu'on te vendra.
Il conseille, il n'agit pas. Le kit livre un agent qui comprend, répond et enregistre. Il n'écrit pas dans ton agenda, ne décrémente pas ton stock et n'encaisse pas. Le dépôt le dit lui-même : ces fonctions sont préparées mais pas reliées. Brancher chacune, c'est un chantier en plus. Méfie-toi des ressources qui vendent la prise de rendez-vous automatique comme incluse — elle ne l'est pas.
La responsabilité de la réponse. Brancher une source officielle réduit fortement l'invention, mais ne la supprime pas — l'équipe de data.gouv.fr l'écrit noir sur blanc. Un agent qui cite l'article, c'est un outil de travail. Un agent qui rend un avis juridique, c'est un risque. La différence se décide dans ses instructions, avant la mise en ligne.
Ce que tu pilotes, ce qui se délègue
| Décision | Qui tranche | Pourquoi |
|---|---|---|
| Les réponses aux dix questions de l'entretien | ★ Toi | C'est ton métier, et ça détermine tout le reste |
| Par quel service passe ton WhatsApp | ★ Toi | Choix d'intermédiaire = choix de confidentialité |
| Quelles sources l'agent a le droit de consulter | ★ Toi | Détermine la crédibilité de chaque réponse |
| Ce qu'il n'a pas le droit de faire | ★ Toi | Le périmètre est une décision de risque |
| L'écriture du code et le déploiement | Ça se délègue | Claude Code le fait pendant l'entretien |
| Le branchement des sources | Ça se délègue | Trois réglages, pas un projet |
| La maintenance quand une bêta évolue | Ça se délègue | Mais prévois-la : ce n'est pas du « une fois pour toutes » |
