Open source · MIT · en français

WhatsApp
AgentKit

Ton agent WhatsApp avec IA, construit par Claude Code en moins de 30 minutes. Sans écrire une ligne de code.

100 % en français Licence MIT Python 3.11+ Claude Sonnet

Pas besoin de savoir programmer. Il suffit de répondre à 12 questions sur ton entreprise.

~/whatsapp-agentkit-fr
$git clone https://github.com/Elie-Ander/whatsapp-agentkit-fr.git
$cd whatsapp-agentkit-fr
$bash start.sh
>environnement prêt. ouvre Claude et écris :
$/creer-agent
30 minutes plus tard
L Léa en ligne
Bonjour, une table pour 4 vendredi à 21 h ?21:14
Oui, il nous en reste une en terrasse. Je la réserve à votre nom ?21:14 · agent
Oui, au nom de Martin21:15
C'est noté Martin : vendredi 21 h, en terrasse, 4 personnes. À vendredi !21:15 · agent
Temps total
~30 min
Questions
12
Code que tu écris
0
Propriétaire du code
Toi
01 · le processus

Cinq phases. Tu réponds, Claude Code construit.

AgentKit n'est ni une bibliothèque ni un SaaS. C'est un mode d'emploi que Claude Code lit et exécute dans ton terminal. Voici les phases, dans l'ordre, et il ne passe pas à la suivante sans ton accord.

  1. 01

    Il vérifie ton environnement

    Il contrôle que tu as Python 3.11 ou plus et Claude Code installé, crée les dossiers et prépare ton .env vide. S'il manque quelque chose, il te dit exactement quoi installer et où.

    $ bash start.sh
  2. 02

    Il te pose ses questions

    Douze questions, une à la fois, en français : le nom de ton entreprise, ce qu'elle fait, à quoi doit servir l'agent, le nom et le ton que tu lui donnes, tes horaires, tes fichiers, tes clés API, et si tu veux être prévenu quand l'agent passe la main. Si tu as un PDF avec ta carte ou ta grille de prix, tu le déposes dans /knowledge et il le lit.

    NomActivitéCas d'usage TonHorairesFichiers
  3. 03

    Il génère l'agent complet

    Il écrit tout le projet, commenté en français, avec un system prompt taillé pour ton entreprise. Ce n'est pas un modèle à trous : chaque fichier sort différent selon tes réponses.

    agent/main.py · serveur FastAPI + webhook
    agent/brain.py · API Claude + system prompt
    agent/memory.py · historique par numéro
    agent/humain.py · passage à un humain
    agent/n8n.py · pont vers n8n
    agent/tools.py · outils de ton métier
    agent/providers/ · connexion à WhatsApp
    config/prompts.yaml · la personnalité
    Dockerfile · prêt pour la production
  4. 04

    Tu le testes dans ton terminal

    Avant de toucher à WhatsApp, tu parles à ton agent dans un chat simulé. Tu écris comme si tu étais un client. S'il répond quelque chose qui ne te plaît pas, tu le dis à Claude Code et il corrige sur place.

    $ python tests/test_local.py
  5. 05

    Mise en ligne sur Railway

    Tu envoies le projet sur GitHub, Railway le lance tout seul, tu renseignes les variables d'environnement et tu branches le webhook de ton fournisseur. À partir de là, celui qui t'écrit sur WhatsApp parle à ton agent, même quand ton ordinateur est éteint.

Le trajet d'un message

de la bulle du client à la réponse
01 Le client écrit WhatsApp
02 Fournisseur Zernio ou Meta
03 Webhook POST /webhook · main.py
04 Mémoire memory.py · SQLite
05 Cerveau brain.py · Claude
06 Réponse retour dans le chat

L'historique est récupéré avant d'appeler le modèle : l'agent se souvient ainsi de ce que vous vous êtes dit hier. Chaque numéro de téléphone a sa propre conversation.

02 · connexion à whatsapp

Deux chemins pour connecter ton numéro.

Ton agent doit pouvoir parler à WhatsApp. Claude Code te demande lequel tu veux et génère uniquement l'adaptateur de ce fournisseur, avec ses variables d'environnement. Tu peux changer plus tard sans toucher au reste du code.

Recommandé option A

Zernio

Intégration directe sur la WhatsApp Cloud API de Meta, avec l'Embedded Signup déjà réglé : tu connectes ton compte WhatsApp Business depuis un bouton. Sans créer d'application Facebook et sans passer l'App Review. Avec une boîte de réception unifiée et des webhooks signés.

Difficulté Faible. La connexion prend quelques minutes.
Coût Les 2 premiers comptes connectés sont gratuits. Sans carte bancaire.
Pour qui Pour presque tout le monde. Si tu veux ton agent en marche aujourd'hui, c'est par ici.
Sans numéro Il a un bac à sable avec un numéro partagé pour tester avant d'avoir le tien : 50 messages par 24 heures, gratuit, et la session dure 7 jours.
WHATSAPP_PROVIDER=zernio
ZERNIO_API_KEY=...
ZERNIO_WEBHOOK_SECRET=...
ZERNIO_ACCOUNT_ID=... (optionnel)
Aller sur zernio.com
Avancé option B

Meta Cloud API en direct

L'API officielle de WhatsApp, sans rien au milieu. Tu crées l'application sur developers.facebook.com, tu lui ajoutes le produit WhatsApp, tu génères le jeton permanent et tu fais vérifier ton compte Facebook Business.

Difficulté Élevée. Application Facebook, jetons, vérification Business.
Coût Tu paies les conversations à Meta, directement et sans intermédiaire.
Pour qui Si tu as déjà l'application et le Business vérifié, ou si tu veux maîtriser chaque pièce toi-même.
Sans numéro Meta fournit un numéro de test, mais il te faut quand même l'application créée.
WHATSAPP_PROVIDER=meta
META_ACCESS_TOKEN=...
META_PHONE_NUMBER_ID=...
META_VERIFY_TOKEN=...
META_APP_SECRET=...
META_API_VERSION=v25.0
Documentation de Meta
03 · à quoi ça sert

Le même moteur, un autre métier.

Ce qui change d'un agent à l'autre, ce n'est pas le code : c'est le prompt, les outils et les fichiers que tu lui as donnés. Voici les métiers où il sert le plus.

01

Restaurant

Il prend les commandes, lit la carte dans le PDF que tu as déposé, compose le panier, confirme l'adresse et l'heure de livraison.

« Deux pizzas margherita et une limonade, à emporter »

02

Cabinet ou salon

Il prend le rendez-vous : il demande la prestation, propose les créneaux que tu lui as donnés et te laisse les informations prêtes dans l'historique.

« Vous avez de la place jeudi après-midi ? »

03

Agence immobilière

Il qualifie les prospects : il demande le quartier, le budget et la date d'emménagement souhaitée. Les tièdes, il les entretient. Les bons, il les passe au commercial.

« Je cherche un deux-pièces, jusqu'à 900 euros »

04

Boutique en ligne

Il répond sur le stock, les tailles, les moyens de paiement, les frais de livraison et le suivi de commande. À 3 heures du matin aussi.

« Il vous reste la veste noire en M ? »

05

SaaS et support

Premier niveau de support : il règle ce qui revient tout le temps, ouvre un ticket quand il le faut et passe à un humain ce qu'il ne sait pas, sans inventer.

« Je ne reçois pas le mail de vérification »

06

Toute autre entreprise

Si tu réponds vingt fois par jour aux mêmes questions, l'agent y répond à ta place avec tes informations, ton ton et tes horaires. Rien de plus.

« Vous êtes ouverts jusqu'à quelle heure aujourd'hui ? »

04 · qui et pourquoi

Ce dépôt ne contient presque pas de code.

Ce qu'il y a dedans
CLAUDE.md · le cerveau
/creer-agent · le déclencheur
start.sh · le démarrage
scripts/audit.py · l'audit
README.md · le plan
LICENSE · MIT

Mettre un agent WhatsApp dans une petite entreprise, jusqu'ici, c'était payer un développeur ou s'abonner à un outil qui répond avec des boutons.

Ce kit prend le problème autrement : au lieu d'un bot de plus, il contient les instructions pour que Claude Code écrive le tien. Tout le travail tient dans un fichier, CLAUDE.md : quoi demander, dans quel ordre, quoi générer à chaque réponse, comment tester et comment mettre en ligne. Tu clones, tu lances une commande et tu réponds. Le code apparaît.

L'important : l'agent qui en sort est à toi. Il vit sur ta machine, dans ton dépôt, avec tes clés API. Tu peux le lire, le casser, changer son prompt à trois heures du matin. Pas de plateforme au milieu, pas d'abonnement, rien qui s'éteigne si l'auteur disparaît. Licence MIT, fais-en ce que tu veux.

Je m'appelle Elie LISSODA. J'ai adapté ce kit open source en français, et j'y ai ajouté le passage à un humain et le pont vers n8n, pour que les indépendants et les petites entreprises francophones puissent s'en servir. Un souci pour l'installer, ou une question ? Je suis disponible 😉

trois commandes et tu y es

Ton agent commence par un git clone.

$git clone https://github.com/Elie-Ander/whatsapp-agentkit-fr.git
$cd whatsapp-agentkit-fr
$bash start.sh

Il te faut : Python 3.11+, Claude Code et une clé API Anthropic.