Comment créer un bot WhatsApp intelligent en hébreu · Le guide visuel complet.

Pensez à votre entreprise dans une semaine. Un prospect envoie un message sur WhatsApp à 2h du matin, reçoit une réponse en quelques secondes et planifie une réunion Zoom dans votre calendrier sans même que vous soyez réveillé. Ce n'est pas un rêve, c'est un processus de 30 minutes. Le tout à l'aide de 5 outils gratuits ou généreux qui constituent la nouvelle norme pour créer des agents : Kapso (numéro WhatsApp approuvé par Meta), Maton (connexion au calendrier et à Zoom), Google AI Studio (cerveau Gemini), Claude Code (le développeur qui assemble le tout) et Vercel (déploiement sur le cloud). Lors de la session 3 de l'atelier Claude Code, nous avons créé un tel bot en direct, à partir de zéro. Ce guide est une capture de tout ce que nous avons fait, avec 34 captures d'écran organisées. Suivez étape par étape et à la fin, vous aurez un bot WhatsApp professionnel qui travaille pour vous 24/7.

Ce que vous aurez à la fin du guide

• Un numéro WhatsApp professionnel approuvé par Meta · Sans acheter de carte SIM, sans connecter votre numéro personnel
• Un bot qui répond aux clients en hébreu avec votre voix, 24/7
• Une intégration automatique avec Google Calendar · Chaque rendez-vous conclu par le bot est ajouté au calendrier
• Une intégration avec Zoom · Un lien de réunion est créé et envoyé automatiquement au client
• Un déploiement sur le cloud Vercel · Le bot fonctionne même lorsque votre ordinateur est éteint
• Un contrôle total : possibilité de mettre à jour le comportement, d'ajouter des fonctionnalités, de changer de modèle à tout moment

Ce dont vous avez besoin avant de commencer

Si vous n'avez pas encore Claude Code, la page de l'atelier contient des instructions d'installation complètes + des autorisations + un CLAUDE.md personnel : ai-masterclub.com/claude-workshop

Étape 1 · Inscription sur Kapso et création d'un numéro WhatsApp

✅ Vous avez terminé l'étape 1. Vous avez un numéro WhatsApp professionnel approuvé. Jusqu'à présent, vous avez investi 5 à 10 minutes.

Étape 2 · Maton · Connexion du bot au calendrier et à Zoom

Étape 3 · Collecte de toutes les clés API

3a · Clé API de Kapso

3b · Clé API de Google AI Studio (Gemini)

💳 L'utilisation de Gemini ne coûte presque rien. Mais plus le bot fonctionnera, plus la facture augmentera. Il est conseillé de définir un plafond de dépenses mensuel sur le compte Google Cloud · Ainsi, vous neSword aurez pas de mauvaises surprises.

✅ Nous avons maintenant 3 clés enregistrées de côté · Kapso, Maton (déjà enregistré à l'étape 18) et Gemini. De plus · le numéro Kapso que nous avons créé à l'étape 1 et notre numéro personnel (pour la vérification de la propriété). Tout cela va dans Claude à l'étape suivante.

Étape 4 · Connexion à Claude Code · Création d'un nouveau dossier

Le club AI Master vous ouvre ses portes : une session en direct chaque semaine, des enregistrements et une communauté. 47 ₪ par mois, annulation à tout moment.

Étape 5 · La compétence du site de l'atelier · La magie

Coller la compétence dans Claude · Avec les 3 clés

Le prompt complet à coller dans Claude · Une fois la compétence installée

Construis-moi un agent WhatsApp. J'ai déjà créé un numéro sur Kapso, connecté des outils sur Maton et créé une clé API sur Google AI Studio. Voici les clés : • KAPSO_API_KEY : [Coller la clé Kapso de l'étape 22] • MATON_API_KEY : [Coller la clé Maton de l'étape 18] • GEMINI_API_KEY : [Coller la clé Gemini de l'étape 29] • Numéro Kapso : [Le numéro américain créé à l'étape 1] • Mon numéro personnel : [Votre numéro, uniquement pour la vérification de la propriété] Utilise la compétence whatsapp-agent que j'ai déjà installée. Travaille d'abord en mode Plan, présente-moi le plan et après mon approbation, passe à la construction et au déploiement sur Vercel.

💡 Claude détecte automatiquement la compétence que vous avez installée et charge les instructions. Il prendra les 3 clés, créera un projet Next.js, connectera les webhooks, déploiera sur Vercel et reconnectera l'URL du webhook à Kapso · Tout seul. Vous validez simplement le plan lorsqu'il le présente.

🎉 Vous avez terminé. Vous avez un bot WhatsApp intelligent, en direct et fonctionnant 24/7. Envoyez un message au numéro Kapso que vous avez créé · L'agent répondra en hébreu, planifiera des réunions Zoom et créera des événements dans Google Calendar. Vous pouvez donner le numéro à vos clients.

Que faire une fois que le bot est en ligne

5 choses à faire la première semaine

• **Envoyer un premier message à vous-même** · Et vérifier qu'il répond comme vous le souhaitez. Si le ton n'est pas correct, dites à Claude 'affine le prompt système dans le fichier X. Je veux un ton plus/moins _____'
• **Définir qui ne pas contacter** · Dans le prompt système, dites au bot 'si le numéro X ou Y envoie un message, ne réponds pas'. Ainsi, vous ne recevrez pas de messages automatiques à votre femme ou à vos amis
• **Limiter les heures de fonctionnement** · Vous pouvez dire au bot 'entre 22h00 et 08h00, réponds uniquement avec un message automatique : Je répondrai le matin' si vous souhaitez qu'il soit clair qu'il s'agit d'un bot
• **Ajouter des fonctionnalités** · S'il y a une tâche répétitive que le bot ne fait pas (envoi de devis, suivi après 72 heures), dites à Claude 'ajoute cette capacité au bot', et il met à jour le code et redéploie
• **Suivre les conversations** · Sur Maton, vous pouvez voir un journal de toutes les conversations gérées par le bot. Il vaut la peine de les parcourir une fois par semaine pour voir où il se trompe

💡 Économie de jetons : un agent fonctionnant 24/7 peut consommer des crédits. Pour économiser · 1) utilisez Gemini Flash au lieu de Pro pour la plupart des requêtes (5 fois moins cher), 2) placez de la mémoire dans Supabase pour que le bot ne répète pas les questions, 3) définissez un maximum de 1500 jetons par réponse.

Problèmes courants et solutions

Solution rapide pour les 3 problèmes les plus fréquents

• **Le Webhook ne reçoit pas de messages** · Vérifiez dans Kapso que l'URL du Webhook est correcte (il s'agit de l'URL Vercel + /api/webhook). Dites à Claude 'vérifie le webhook sur Kapso et corrige si nécessaire'
• **Gemini répond en anglais sans qu'on le lui demande** · Dans le prompt système du fichier de projet, ajoutez 'réponds toujours en hébreu, même si l'utilisateur écrit en anglais ou mélange'
• **Google Calendar ne reçoit pas d'événements** · Vérifiez dans Maton que les autorisations du calendrier sont restées actives (parfois Google annule les autorisations après 7 jours en cas de problème). Ouvrez Maton, reconnectez-vous et réapprouvez toutes les autorisations

🚀 **Vous voulez un accompagnement tout au long du parcours ?** Le club AI Master dispose d'un groupe WhatsApp actif de personnes qui construisent des bots exactement comme le vôtre. Chaque problème que vous rencontrerez a déjà été résolu par quelqu'un. Rejoignez-nous, partagez l'agent que vous avez construit et obtenez des idées d'autres agents à créer pour votre entreprise.

Quelle est la prochaine étape ?

Questions fréquentes

Kapso · Numéro américain gratuit, et aussi un plan de base pour 1000 messages par mois gratuitement. Maton · Jusqu'à 100 actions par mois gratuitement (Zoom, calendrier, e-mail). Gemini · Après avoir connecté une carte bancaire, le paiement se fait selon l'utilisation réelle. En pratique, des milliers de messages par mois coûtent quelques sjekels. Vercel · Totalement gratuit pour les projets personnels. Au total, si le bot reçoit jusqu'à 100 messages par jour, vous paierez moins de 50 sjekels par mois.

Oui. Sur Kapso, au lieu de choisir Digital Numbers, choisissez Bring your own number. Vous avez besoin d'une carte SIM physique (vous pouvez en acheter une prépayée pour 30 ₪) et vous effectuez le même processus de validation auprès de Meta. Le bot fonctionnera exactement de la même manière, mais avec un numéro israélien. L'avantage · Plus professionnel pour les entreprises israéliennes. L'inconvénient · Une étape supplémentaire d'achat et d'activation de la carte SIM.

Oui. Tout ce que j'ai fait dans ce guide, vous pouvez le faire. Le secret est que Claude est le développeur. Vous le guidez simplement · 'Construis-moi un bot WhatsApp', 'Ajoute la fonctionnalité X', 'Corrige le bug que j'ai vu'. Si quelque chose ne fonctionne pas, vous dites à Claude 'Voici le problème, corrige-le'. Il n'est pas nécessaire de lire le code ou de le comprendre. Traitez Claude comme un développeur senior travaillant pour vous.

Exactement le même processus. La seule différence réside dans le prompt que vous donnez à Claude à l'étape 4. Au lieu de demander 'un bot qui coordonne des rendez-vous', demandez 'un bot qui répond aux questions fréquentes sur mes produits' ou 'un bot qui crée des devis selon le modèle X'. Tout le reste est identique · Kapso, Maton, Gemini, Vercel. Les agents diffèrent dans Claude, pas dans l'infrastructure.

Oui, facilement. Vous dites à Claude 'remplace le modèle Gemini par Claude', et il met à jour le code, demande la nouvelle clé API (d'Anthropic ou OpenAI) et redéploie. Mieux encore · vous pouvez même exécuter l'agent avec 2 modèles en parallèle et choisir celui qui fonctionne le mieux pour chaque type de question. C'est toute la beauté de travailler avec Claude Code · la structure est totalement flexible.

💪 Prêt à créer d'autres agents ?

📎 Version concise du guide · Sans images

Pensez-y : chaque prospect qui arrive sur votre WhatsApp à 2h du matin reçoit une réponse en quelques secondes. Il ne se contente pas d'une réponse, il planifie réellement une réunion Zoom avec lui, crée un événement dans votre Google Calendar et lui envoie un lien pour se connecter. Ce n'est pas le futur. C'est aujourd'hui. Dans ce guide, je vais vous montrer comment créer vous-même un agent WhatsApp intelligent en hébreu, sans écrire une seule ligne de code. La compétence que j'ai créée fait tout le travail difficile : elle crée un projet Next.js, connecte toutes les API, déploie sur Vercel et configure les webhooks. Vous fournissez simplement 3 clés API et appuyez sur Entrée.

Ce que fait l'agent une fois qu'il est en ligne

• Reçoit des messages WhatsApp via Kapso (WhatsApp Business API)
• Répond en hébreu avec votre voix, grâce à un prompt système que vous maîtrisez
• Planifie des réunions Zoom et crée automatiquement un événement dans Google Agenda
• Envoie au client un lien Zoom prêt à l'emploi ainsi qu'une invitation au calendrier
• Mémorise l'historique complet de la conversation pour ne jamais se répéter
• Fonctionne 24h/24 et 7j/7 sans maintenance, sur une infrastructure Vercel presque entièrement gratuite

L'installation : une seule commande dans le terminal

La commande pour installer la compétence (à copier dans le terminal)

mkdir -p ~/.claude/skills/whatsapp-agent && curl -sL https://www.ai-masterclub.com/skills/whatsapp-agent.md -o ~/.claude/skills/whatsapp-agent/SKILL.md && echo '✅ La compétence est installée. Ouvrez Claude Code et écrivez : Crée-moi un agent WhatsApp'

Cette compétence est également publiée sur GitHub avec tous les fichiers et modèles : github.com/amichaiai/whatsapp-agent. La version sur le site est la version courte (SKILL.md uniquement). Pour une installation complète avec des modèles et des références, il est recommandé de faire un clone git du dépôt.

Comment utiliser la compétence après l'installation

Ce que la compétence fait à votre place (8 étapes automatiques)

• Vérifie que node, npm et Vercel CLI sont installés
• Crée un dossier de projet avec Next.js 15 et TypeScript prêts à l'emploi
• Récupère les identifiants indispensables depuis Kapso (phone_number_id et autres)
• Connecte Maton à Zoom et à Google Agenda via OAuth
• Transmet toutes les variables d'environnement à Vercel via l'API REST (plus rapide que la CLI)
• Effectue un premier déploiement en production
• Crée un webhook dans Kapso qui pointe vers votre nouvelle URL
• Valide de bout en bout avec un test de santé et un test d'agent

Il est obligatoire de désactiver Vercel Deployment Protection sur le projet, sinon Kapso recevra une erreur 401 et ne pourra pas appeler le webhook. La compétence explique où désactiver cette option en 30 secondes. Il s'agit d'un seul paramètre dans Settings → Deployment Protection → Disabled.

À qui s'adresse cet agent

Questions supplémentaires

Maton prend en charge Google Workspace, Slack, HubSpot, Salesforce, Notion, Linear et bien d'autres. La compétence ajoute automatiquement les outils de base. Pour en ajouter d'autres, c'est simple : vous écrivez à Claude Code 'Ajoute à l'agent la capacité d'envoyer des e-mails', et il mettra à jour le code.

Gemini prend en charge plus de 50 langues. La langue par défaut de la compétence est l'hébreu, mais vous pouvez mettre à jour le prompt système (dans lib/prompts.ts) pour qu'il réponde selon la langue du client. C'est une modification de 3 lignes.

Au sein du club AI Master, une session hebdomadaire en direct permet d'examiner ce type de cas ensemble. De plus, il existe une communauté active de chefs d'entreprise qui ont déjà créé des agents et partagent ce qui fonctionne ou non. Vous pouvez poser vos questions dans le groupe WhatsApp silencieux.

Ce guide n'est pas théorique. J'ai conçu cet agent pour moi-même, il tourne et répond aux clients, et c'est ce qui me libère du temps pour me consacrer à des tâches plus importantes. En le construisant pour vous, vous vous libérez l'esprit.