Outils · 7 min
WhatsApp Agent Kit, crée ton agent IA WhatsApp en 10 questions
Un repo open source qui transforme Claude Code en builder d'agent WhatsApp.
Ce qu’il y a dedans
- Le problème que tout solo entrepreneur a
- C'est quoi WhatsApp Agent Kit
- Setup en 20 minutes
- Les 10 questions que Claude te pose
Un repo open source qui transforme Claude Code en builder d'agent WhatsApp. Tu clones le repo, tu lances une commande, Claude te pose 10 questions sur ton business, et il te configure un agent IA qui répond à tes clients sur WhatsApp 24/7. Resto, cabinet, boutique, agence : ça marche pour n'importe quel business qui reçoit des messages.
Le problème que tout solo entrepreneur a
Ton WhatsApp business sonne en boucle. Tes clients te demandent les horaires, les prix, si t'as encore de la dispo, si tu fais ce service ou pas, le plan d'accès, les jours fériés. Tu réponds 50 fois par semaine aux 10 mêmes questions.
Le truc dingue : tu pourrais déléguer ces 50 messages à une IA en 30 minutes. Mais entre construire un chatbot, brancher une API WhatsApp, configurer un serveur, le coût total te bloque. Résultat : tu continues à répondre à la main.
WhatsApp Agent Kit règle ça. Pas de no-code platform à 100 €/mois. Pas de développeur à embaucher. Juste Claude Code qui te builde ton agent en interviewant ta boîte.
C'est quoi WhatsApp Agent Kit
Open source MIT sur GitHub : github.com/Hainrixz/whatsapp-agentkit. Repo récent activement développé par Enrique Rocha (Todo de IA), une référence Claude Code dans la communauté LATAM.
C'est pas un produit. C'est un template de projet qui utilise Claude Code comme builder. Tu lances une commande /build-agent dans Claude Code, et il fait tout le boulot :
- Il t'interroge sur ton business (10 questions, 10 minutes)
- Il génère tous les fichiers de l'agent (config, prompts, structure mémoire)
- Il branche l'agent sur ton WhatsApp via Twilio ou Meta Cloud API
- Il déploie le tout (en local ou sur un serveur)
Résultat : t'as un agent IA qui reçoit les messages de tes clients sur ton vrai numéro WhatsApp, qui répond avec ton ton de marque, qui se souvient des conversations précédentes, et qui peut faire des trucs concrets (prise de RDV, devis, FAQ produits).
Sous le capot :
- Python 3.11+ avec FastAPI (le serveur qui reçoit les messages)
- SQLite ou PostgreSQL (la mémoire des conversations)
- Claude Sonnet 4.6 (le cerveau de l'agent)
- Twilio sandbox ou Meta Cloud API (le pont avec WhatsApp)
- Docker pour le déploiement facile
T'as rien à coder. Claude Code génère tout pour toi en se basant sur tes réponses.
Setup en 20 minutes
Compte 20 à 30 minutes la première fois. Le script dit « 2 clics » mais soyons honnête : entre les prerequis et le setup du compte WhatsApp provider, c'est plus près de 20 min en réel. Après, le scaling est rapide.
Prérequis
- Python 3.11+ installé sur ton ordi. Vérifie avec python3 --version dans ton terminal. Si t'as pas, télécharge sur python.org.
- Claude Code installé (npm install -g @anthropic-ai/claude-code)
- Une clé API Anthropic depuis platform.anthropic.com (gratuit à créer, tu paies les tokens utilisés)
- Un compte WhatsApp provider : soit Twilio (sandbox gratuit pour tester), soit Meta Cloud API (officiel WhatsApp Business, gratuit jusqu'à un certain volume de conversations)
Étape 1 — Clone le repo
git clone https://github.com/Hainrixz/whatsapp-agentkit.git
cd whatsapp-agentkit
Étape 2 — Lance le setup
bash start.sh
Le script vérifie les prerequis et te guide. Si Python n'est pas dispo, il t'indique quoi installer.
Étape 3 — Ouvre Claude Code dans le dossier
Dans le dossier whatsapp-agentkit, tape claude pour ouvrir Claude Code. Puis tape la commande spéciale :
/build-agent
C'est là que la magie commence. Claude te pose 10 questions sur ton business. Réponds aussi précisement que possible, c'est ce qui va déterminer la qualité de ton agent.
Les 10 questions que Claude te pose
- Nom de ton business (ex : « La Trattoria de Marco »)
- Description du business en 2-3 lignes (ex : « Restaurant italien à Lyon 6e, 35 couverts, spécialité pâtes fraîches »)
- Purpose de l'agent (support client, prise de RDV, prise de commandes, qualification de leads, FAQ produits)
- Nom de l'agent (ex : « Marco » pour personnifier, ou « Assistant Trattoria » si tu préfères neutre)
- Ton de communication (4 options : professionnel / amical / commercial / empathique)
- Heures d'ouverture (l'agent répond avec un message d'attente hors horaires)
- Fichiers de connaissance (PDF du menu, liste de prix, FAQ existante, doc d'onboarding clients) — tu uploades, Claude les ingere
- Clé API Anthropic (celle que t'as créée dans les prerequis)
- Provider WhatsApp choisi (Twilio ou Meta)
- Credentials du provider (tokens, numéros, webhooks que t'as récupérés lors de l'inscription au provider)
Claude génère ensuite TOUT : les prompts système de l'agent, la config FastAPI, la mémoire SQLite, les fichiers Docker. Tu n'as plus qu'à lancer.
Les 5 cas d'usage qui marchent le mieux
1. Restaurant | Menu, réservations, allergies
Uploade ton menu PDF + tes horaires + ta politique d'allergies. L'agent répond :
- « Vous avez quoi en plat sans gluten ce soir ? »
- « À quelle heure vous fermez le dimanche ? »
- « Je peux réserver pour 4 personnes vendredi 20h ? » (et il prend la réservation)
2. Cabinet médical / paramedical | Prise de RDV automatique
Uploade ton planning Google Calendar via API + tes services + ta zone de chalandise. L'agent qualifie le besoin et propose des créneaux disponibles. Tu valides manuellement avant confirmation finale pour les cas sensibles.
3. Boutique e-commerce | Suivi commande + SAV niveau 1
Uploade ta FAQ + ta politique de retour + l'accès à ton CRM (Shopify, etc.). L'agent gère 80 % des messages SAV classiques (où est ma commande, comment faire un retour, taille produit).
4. Agence immo / courtier | Qualification de leads
Uploade tes biens disponibles + tes critères clients + ton processus d'onboarding. L'agent qualifie chaque prospect (budget, surface, zone, urgence), enregistre le brief, et t'envoie un résumé quotidien des leads prêts à être rappelés.
5. Freelance / coach | Pré-discovery automatisé
Uploade ton offre + ton ICP + tes objections types. L'agent fait le pré-call : pose les questions de qualification, mesure le fit, te transmet uniquement les prospects qui rentrent dans ta target.
Mes 3 conseils
- Commence en Twilio sandbox pour tester gratuitement. Twilio offre un mode sandbox qui te permet de discuter avec ton agent depuis ton WhatsApp perso sans passer par la validation Meta Business (qui peut prendre 1-3 semaines). Une fois que t'es satisfait du comportement, tu migres vers Meta Cloud API pour le production.
- Uploade des knowledge files riches dès le début. Plus tu mets de docs spécifiques (menu détaillé avec tags allergies, FAQ avec verbatim clients, manuel interne avec process), plus l'agent est pertinent. La qualité des réponses est 100 % corrélée à la richesse des knowledge files. Si tu mets juste « on est un resto italien », t'auras un agent générique.
- Configure un escalade vers humain pour les cas sensibles. Dans les prompts de l'agent, ajoute « Si la question concerne [réclamation, prix spécifique, demande de modification, situation émotionnelle], repète au client que tu prends note et qu'un humain le rappellera. ». Ton agent ne va pas faire de bourde sur les cas délicats.
Les limites à garder en tête
- L'install demande Claude Code et un terminal. C'est pas no-code. Si t'as jamais ouvert un terminal, compte 30 min de plus pour caler l'environnement. Après, c'est automatique.
- Tu paies l'API Anthropic + le provider WhatsApp. L'agent consomme des tokens Anthropic à chaque conversation (à budgeter selon ton volume de messages). Meta Cloud API a un palier gratuit puis facture par conversation. Twilio facture au message envoyé. Estime : 5-30 €/mois pour 100-500 conversations/mois.
- La doc officielle du repo est en espagnol. Le créateur est hispanophone. La doc et les questions de Claude pendant le setup sont en espagnol. C'est pas un blocage (Claude Code traduit en français si tu lui demandes au début de la session), mais c'est utile à savoir avant de te lancer.
- Meta peut bannir ton compte si tu spam. WhatsApp Business est strict sur les messages non sollicités. L'agent doit répondre aux messages entrants, pas envoyer du cold outbound. Respecte les CGU Meta sinon ton numéro WhatsApp business saute.
Le mot de la fin
La différence entre un solo entrepreneur scotché à son WhatsApp et un qui passe ses messages en automatique, c'est rarement le modèle éco. C'est rarement le budget. C'est juste qui a pris 30 minutes pour configurer un agent.
Lance le clone du repo ce soir. Fais le setup demain matin. Après-demain ton agent répond à ta place pendant que tu déjeunes.
