Agent IA WhatsApp : le créer avec Claude Code

En bref : un kit open source piloté par Claude Code permet de monter un agent IA WhatsApp sans écrire une ligne de code. Le cas de démonstration qualifie des candidats locataires : 5 questions, règle des revenus à 2,5 fois le loyer, lecture de l'avis d'imposition, fiche transmise à un conseiller humain. Budget de départ : 5 $ de crédits API Claude, un numéro de test gratuit, puis un VPS pour tourner 24h/24.

Une annonce de location publiée sur Leboncoin génère vite un flot de messages, et trier à la main les candidats hors critères prend des heures. Un agent IA WhatsApp fait ce tri à votre place, à toute heure, puis ne vous passe que les dossiers solides. J'ai décortiqué un tutoriel récent qui monte ce type d'agent de A à Z avec Claude Code : voici la méthode complète, ses coûts réels et surtout les limites légales que la vidéo survole.

🎯 Agent IA WhatsApp : définition et différence avec un chatbot

Un agent IA WhatsApp n'est pas ChatGPT ou Claude branché sur une messagerie. Parler à une IA, c'est obtenir une réponse. Parler à un agent, c'est confier une mission : l'agent pose ses questions, consulte ses fichiers, décide de l'étape suivante et transmet le résultat à un humain.

Le kit présenté dans la vidéo organise l'agent en trois blocs :

1. Le cerveau : l'historique des messages rattaché à chaque numéro de téléphone, qui sert de mémoire à long terme sur chaque contact.
2. La personnalité : la fiche d'identité de l'entreprise, les règles de conduite et le system prompt (les consignes permanentes que l'utilisateur ne voit jamais).
3. Les compétences : des dossiers de connaissance et d'outils (catalogue de biens, grille de qualification, simulateur de test).

Un chatbot classique suit un arbre de boutons. Un agent comprend "je suis en CDI, 2900 € net, pas de garant" dans un seul message et en extrait trois informations.

🚀 Les deux types d'agent IA sur WhatsApp

Les agents IA sur WhatsApp se rangent en deux familles, et le choix change tout le reste du projet.

Cet article traite la seconde famille : l'agent qui parle à vos clients. Pour l'usage personnel, un assistant comme Claude Cowork couvre déjà une bonne partie du besoin sans passer par WhatsApp.

🚀 Créer un agent IA WhatsApp avec Claude Code en 6 étapes

La création de l'agent avec Claude Code suit six étapes, toutes pilotées en langage naturel dans l'onglet Code de l'application Claude (Mac ou Windows).

1. Installer le kit. Un premier prompt demande à Claude Code de cloner le dépôt open source et d'installer la stack technique (Python et dépendances). Il suffit d'autoriser les actions proposées.
2. Lancer l'interview. La commande /build-agent déclenche un questionnaire de 8 questions sur votre activité : nom de l'entreprise, mission de l'agent, prénom de l'agent, ton, horaires, fichiers disponibles.
3. Renseigner les clés. Claude Code ouvre un fichier de configuration où vous collez vos clés API. Ne collez jamais une clé dans la barre de chat.
4. Créer le webhook. Le webhook est la porte d'entrée : il prévient l'agent dès qu'un message arrive. En local, Claude Code génère une URL temporaire via un tunnel Cloudflare.
5. Nourrir la base de connaissance. Annonces, infos pratiques, déroulé des visites, questions fréquentes : chaque apport devient un fichier Markdown que le system prompt référence.
6. Tester, corriger, déployer. Claude Code simule des candidats, liste les écarts, corrige, puis installe l'agent sur un serveur.

Prérequis : les 3 clés à préparer

L'agent construit avec ce kit a besoin de trois accès :

• La clé API Anthropic, créée dans la console Claude après achat d'au moins 5 $ de crédits. Le tarif dépend du modèle, détaillé sur la page tarifs d'Anthropic.
• La clé Zernio, visible dans le tableau de bord. Zernio fournit un numéro WhatsApp partagé de test, ce qui évite d'acheter un second numéro pour vous parler à vous-même.
• Le secret du webhook, généré par Zernio au moment où vous collez l'URL du webhook. Cochez au minimum les événements liés aux messages.

📊 Cas concret : qualifier des candidats locataires avec un agent IA WhatsApp

Le cas de démonstration est une agence de location d'appartements à Lyon qui publie ses annonces sur Leboncoin. L'agent s'appelle Louise : ton professionnel et chaleureux, messages courts, vouvoiement systématique, horaires 10h à 19h en semaine et 10h à 13h le samedi.

La mission de Louise tient en une phrase : répondre aux candidats qui écrivent après avoir vu une annonce, trier les dossiers, et transmettre les bons à un conseiller humain pour la visite.

Les critères de qualification de Louise

La qualification par l'agent Louise repose sur 5 informations demandées dans la conversation :

1. la date d'entrée souhaitée ;
2. la situation professionnelle ;
3. le revenu net mensuel du foyer ;
4. la présence d'un garant (personne physique ou Visale) ;
5. le nombre d'occupants.

Une fois les réponses obtenues, Louise calcule combien de fois les revenus nets couvrent le loyer charges comprises. Le seuil fixé : 2,5 fois le loyer sans garant. Un dossier bascule en "non qualifié" si le garant manque alors que l'annonce l'exige, si le logement est trop petit pour le nombre d'occupants, ou si la date d'entrée dépasse de plus de 30 jours la date de disponibilité.

Si le candidat pose une question sur le logement en cours de route, Louise répond puis reprend sa grille. Dans la démonstration, un candidat en CDI à 4200 € net pour un T3 à 1250 € charges comprises obtient un ratio de 3,36 : qualifié, visite proposée sur deux créneaux.

Les garde-fous de l'agent

Les garde-fous d'un agent client comptent autant que ses compétences. Louise n'invente jamais une information ni un créneau de visite, refuse toute négociation de loyer, ne demande aucun paiement par WhatsApp, passe la main à un humain sur demande, et ne cache jamais qu'elle est une assistante virtuelle. Ses réponses sont limitées à deux phrases (la démonstration montre qu'elle déborde parfois à trois ou quatre).

🎓 Tester l'agent IA WhatsApp avant de le brancher

Le test de l'agent se fait d'abord dans Claude Code, pas sur le téléphone. Claude Code joue plusieurs candidats en parallèle, chacun dans sa propre conversation, et rend un tableau "attendu contre obtenu".

L'examen final de la démonstration aligne 7 profils : bon dossier, dossier limite, revenus trop justes, dossier sans référence, tentative de négociation, famille avec enfants, demande de visite hors horaires. Les garde-fous sont passés au même crible : négociation, questions discriminantes, demande de paiement, demande de parler à un humain.

Ce que je retiens pour mes propres projets : cette boucle "tester, corriger, retester" doit tourner en continu après la mise en ligne, pas seulement au lancement. Un agent qui parle à des clients dérive dès que votre offre ou vos règles changent.

💡 Vocaux, photos et documents : rendre l'agent multimodal

Un agent WhatsApp limité au texte rate une bonne partie des échanges réels, car beaucoup de candidats répondent en vocal ou envoient une capture d'annonce. La version enrichie ajoute quatre capacités :

• la transcription des vocaux, via une clé Deepgram (compte gratuit pour démarrer), un moteur de transcription rapide très utilisé pour les agents vocaux ;
• la lecture d'images : l'agent reconnaît la capture d'une annonce et vérifie si le bien est disponible ;
• la lecture de l'avis d'imposition pour contrôler le revenu déclaré ;
• la fiche candidat envoyée au conseiller sur un autre numéro, avec un lien pour reprendre la conversation.

Une commande interne complète le dispositif : quand le numéro de l'agence écrit #fiche dans une conversation, l'agent affiche la fiche du candidat au lieu de lui répondre. Limite constatée : le numéro sandbox partagé ne permet pas de tester ce filtre par numéro, faute de second numéro connecté.

Pour aller plus loin sur la vérification de pièces justificatives par IA, j'ai détaillé une architecture dédiée dans cet article sur la vérification de documents avec un système agentique Claude.

🚀 Déployer l'agent IA WhatsApp sur un VPS pour tourner 24h/24

Le déploiement de l'agent sur un VPS (serveur privé virtuel loué chez un hébergeur) est obligatoire en production : en local, l'agent s'arrête dès que votre ordinateur s'éteint.

1. Louez un VPS (la démonstration utilise une offre Hostinger, serveur situé en France).
2. Générez une clé SSH sur votre poste, déclarez la clé publique chez l'hébergeur : Claude Code pourra piloter le serveur.
3. Demandez à Claude Code d'installer l'agent dans un conteneur Docker dédié, séparé de vos autres services.
4. Remplacez l'URL temporaire du webhook par l'URL du serveur, idéalement sur un nom de domaine. Dans la démonstration, Claude Code a mis à jour le webhook Zernio lui-même via l'API.
5. Envoyez "test" depuis WhatsApp, puis rejouez le scénario complet avec texte, vocal, photo et document.

📊 Combien coûte un agent IA WhatsApp ?

Le coût de l'agent monté avec ce kit se décompose en quatre postes, dont un seul est fixe.

Le poste que la vidéo ne chiffre pas : votre temps de maintenance. Un agent qui qualifie des clients se surveille, se corrige et se met à jour à chaque changement de catalogue.

📊 Zernio, API officielle Meta ou n8n : le comparatif

Le choix de la passerelle WhatsApp détermine la robustesse de l'agent en production.

Si vous travaillez déjà en workflow visuel, mon guide du chatbot WhatsApp avec n8n montre l'alternative, et mon accompagnement en automatisation Make couvre le branchement au CRM.

⚠️ Les limites légales à connaître avant de déployer un agent IA WhatsApp

Les limites légales d'un agent client sur WhatsApp sont le vrai angle mort du tutoriel. Quatre points à vérifier avant la mise en ligne.

1. La politique WhatsApp de Meta. Depuis le 15 janvier 2026, Meta interdit les assistants IA "généralistes" sur l'API WhatsApp Business. Les agents dédiés à une fonction métier précise (support, réservation, qualification de prospects) restent autorisés, comme le détaille cette analyse de la nouvelle politique. Louise, qui ne fait que qualifier des candidats, entre dans le cadre. Un agent "qui répond à tout" n'y entre pas.

2. L'AI Act. Depuis le 2 août 2026, l'article 50 du règlement européen sur l'IA impose d'informer une personne qu'elle échange avec un système d'IA. Le garde-fou "Louise ne cache jamais qu'elle est une assistante virtuelle" est donc une obligation, pas une option. Le mieux : l'annoncer dès le premier message.

3. Les pièces demandées au candidat. En France, le décret n° 2015-1437 du 5 novembre 2015 fixe la liste limitative des justificatifs qu'un bailleur peut exiger. Faire lire un avis d'imposition par l'agent est possible ; collecter une pièce hors liste ne l'est pas, que ce soit un humain ou une IA qui la demande.

4. Le RGPD. Une carte d'identité et un avis d'imposition stockés sur un VPS sont des données sensibles pour le candidat : durée de conservation définie, accès restreint, information claire. Et un refus de dossier ne doit pas reposer sur la seule décision de la machine : le conseiller humain valide. J'ai détaillé les niveaux de protection dans mon guide sur la protection des données avec l'IA.

⚠️ Les erreurs fréquentes avec un agent IA WhatsApp

Les erreurs fréquentes sur ce type d'agent se répètent d'un projet à l'autre :

• Coller une clé API dans le chat au lieu du fichier de configuration : la clé se retrouve dans l'historique.
• Rester sur l'URL de tunnel temporaire : elle change au redémarrage et l'agent devient sourd.
• Déployer sans base de connaissance : au premier test, Louise répond qu'elle n'a aucune information sur le bien demandé.
• Tester à la main, message par message, au lieu de faire jouer des profils en parallèle par Claude Code.
• Confondre démonstration et production : l'auteur du tutoriel le dit lui-même, un agent livré à une entreprise demande bien plus de développement qu'une fenêtre Claude Code, notamment une boucle d'auto-amélioration et une connexion au CRM.

La prochaine marche logique est de relier l'agent à un CRM ou à Google Drive pour ranger les pièces et suivre chaque lead dans un pipeline. C'est le passage d'un kit open source à une vraie application agentique, un sujet que je développe dans mon article sur les agents IA en entreprise. Pour les tâches récurrentes côté dirigeant, les routines Claude complètent bien l'agent client.

↑