Comment Créer un Agent de IA sur WhatsApp en 10 Minutes

Comment Créer un Agent de IA sur WhatsApp en 10 Minutes (Étape par Étape)

Créer un agent de IA sur WhatsApp était un projet de trois mois : obtenir l'API de Meta, coder l'intégration, héberger le serveur, tester. Avec OpenClaw, la même livraison fonctionne en 10 minutes du cadastre à la première conversation réelle. Ce post est l'étape par étape honnête — avec les 4 obstacles que vous allez rencontrer et comment passer par chacun.

TL;DR: Cadastre → décrire l'agent en texte → connecter WhatsApp Business → configurer 1 intégration → première conversation. ~10 min. Aucune ligne de code.

---

Ce que vous avez besoin avant de commencer

Trois choses (et rien d'autre) :

1. Compte WhatsApp Business (l'application gratuite de Meta — ne confondez pas avec le personnel).
2. Numéro de téléphone dédié. Peut être fixe, virtuel ou cellulaire — mais ne peut pas être en usage sur WhatsApp personnel.
3. 10 minutes sans interruption. Le flux bloque si vous sortez au milieu de l'authentification.

Vous n'avez pas besoin de carte de crédit sur le plan gratuit. Vous n'avez pas besoin de CNPJ (bien que nous vous recommandions). Vous n'avez pas besoin de savoir ce qu'est un webhook.

---

Étape 1 — Créer le compte (1 min)

Allez sur openclaw.com.br, cliquez sur Créer compte gratuit et renseignez :

• Adresse e-mail
• Mot de passe
• Nom de votre entreprise

Le système crée votre espace de travail en quelques secondes. Vous tombez sur la dashboard avec un tour de 3 étapes.

Obstacle commun : L'e-mail de confirmation peut aller dans le spam de Gmail. Si en 1 min il n'est pas arrivé, vérifiez la boîte "Promotions" ou "Spam".

---

Étape 2 — Décrire l'agent en langage naturel (3 min)

Voici où OpenClaw se démarque des autres plateformes. Au lieu de monter un fluxogramme avec des blocs déplaçables, vous décrivez l'agent en texte et la plateforme monte la logique.

Ouvrez Agents → + Nouvel agent. Vous verrez trois champs :

Nom

Le nom que voit le client. Ex : Sofia, Agent OpenClaw, Assistant de la Clinique Soleil.

Objetif

Une phrase courte de ce que l'agent doit faire. Exemples qui fonctionnent :

• ✅ Qualifier de nouveaux leads et réserver une évaluation gratuite avec un conseiller.
• ✅ Répondre aux questions sur nos cours, appliquer un code de réduction et envoyer un lien de paiement.
• ❌ Vendre. (trop générique)
• ❌ Être amical, efficace, professionnel et vendre. (l'objectif devient une liste d'adjectifs — mauvais)

Personnalité et restrictions

Voici où vous donnez le "manuel de marque" en texte continu. Exemple que nous utilisons comme baseline :

---

Étape 3 — Connecter WhatsApp Business (2 min)

Allez sur Intégrations → WhatsApp Business et suivez les étapes pour connecter votre compte WhatsApp Business.

Obstacle commun : Le code de vérification peut aller dans le spam de Gmail. Si en 2 min il n'est pas arrivé, vérifiez la boîte "Promotions" ou "Spam".

---

Étape 4 — Configurer l'intégration (2 min)

Allez sur Intégrations → WhatsApp Business et suivez les étapes pour configurer l'intégration.

Obstacle commun : Le code de vérification peut aller dans le spam de Gmail. Si en 2 min il n'est pas arrivé, vérifiez la boîte "Promotions" ou "Spam".

---

Étape 5 — Première conversation (1 min)

Allez sur Agents → + Nouvel agent et suivez les étapes pour démarrer la première conversation.

Obstacle commun : Le code de vérification peut aller dans le spam de Gmail. Si en 1 min il n'est pas arrivé, vérifiez la boîte "Promotions" ou "Spam".

Tom: un Brésilien informel, proche mais professionnel. Il peut utiliser des émoticônes avec parcimonie (1 par message).

Toujours: se présenter au premier tour. Utiliser le prénom du client lorsque vous le savez. Confirmer l'agendement deux fois.

Jamais: promettre des remises qui ne sont pas dans le catalogue. Parler de la concurrence. Inventionner un horaire ou un prix. Répondre à une question de santé/juridique/financière — renvoyer à un humain.

Lorsque vous bloquez: demander poliment à la personne de patienter et d'appeler un humain via /chamar_humano.

Sauvegarder. En 2 secondes, vous avez un agent fonctionnel — encore sans intégrations.

---

Étape 3 — Connecter WhatsApp Business (3 min)

C'est la partie qui génère le plus d'attrition et où la plupart des plateformes perdent l'utilisateur. OpenClaw raccourcit le flux officiel de Meta en une séquence linéaire.

3.1 Initialiser la connexion

Dans la table de bord, cliquez sur Intégrations → WhatsApp → Connecter. Choisissez :

• Nouveau numéro: si vous allez utiliser un numéro qui n'est pas encore dans aucun WhatsApp.
• Migrer de WhatsApp Business (app): si vous avez déjà installé l'application WhatsApp Business et que vous souhaitez transférer le numéro vers l'API. Attention : l'application cesse de fonctionner après la migration.

3.2 Authentifier avec Meta

OpenClaw redirige vers le login de Meta (pas Google, pas Facebook personnel — compte Business Manager). Si vous n'avez jamais ouvert Business Manager, Meta crée un compte pour vous en temps réel.

Attrition commune #1: Votre compte personnel de Facebook doit être administrateur de Business Manager. Si personne ne vous a donné accès, vous ne pouvez pas passer cette page.

3.3 Sélectionner/ Créer WhatsApp Business Account

À l'intérieur de l'authentification de Meta, vous choisissez quel WABA (WhatsApp Business Account) vous allez utiliser. Si il n'existe pas encore, Meta crée un compte en temps réel via l'interface intégrée.

3.4 Vérifier le numéro

Meta envoie un code SMS ou un appel vers le numéro que vous allez connecter. Entrez le code dans l'interface d'OpenClaw.

Attrition commune #2: Si vous avez déjà utilisé ce numéro dans un WhatsApp (personnel ou application business), le code ne parvient pas. Solution : désinstaller WhatsApp de ce numéro sur votre téléphone AVANT de lancer la connexion.

3.5 Configurer webhook

OpenClaw configure automatiquement le webhook. Vous n'avez rien à faire. Lorsque la page montre Numéro connecté ✅, vous êtes prêt.

---

Étape 4 — Brancher UNE intégration (2 min)

Vous pouvez sauter cette étape et commencer à discuter — mais 95% des agents qui restent en ligne utilisent au moins 1 intégration. Nous recommandons de commencer par celle qui génère la plus grande valeur dans votre cas :

RÈGLES CRITIQUES :

• Préservez TOUTE la mise en forme markdown EXACTEMENT (entêtes ##, listes -, gras, italique, liens, blocs de code, etc.)
• N'AYEZ PAS traduire les URLs, le code ou les balises HTML
• N'AJOUTEZ PAS de préambule ou de commentaire
• Sortez SEULEMENT le markdown traduit, rien d'autre

Markdown source :

Votre entreprise	Intégration première
Clinique, cabinet, atelier	Google Agenda
Produit d'information, cours	Stripe ou Mercado Pago
Service B2B (consultance, agence)	HubSpot ou RD Station
Magasin physique / livraison	Tableaux Google

Exemple — Google Agenda :

1. Intégrations → Google Agenda → Connecter.
2. Autorisez avec le compte Google qui possède l'agenda de l'opération.
3. Choisissez quel calendrier l'agent peut consulter / créer un événement.
4. Définissez la plage (par exemple lun-ven 9h-18h, sam 9h-13h).
5. Enregistrez.

Prêt. L'agent peut maintenant consulter les horaires libres en temps réel et créer un événement sans intervention humaine.

---

Étape 5 — Première conversation réelle (1 min)

Prenez votre autre téléphone (ou demandez à quelqu'un), envoyez un message au numéro que vous avez connecté. Testez des scénarios que vous savez qu'ils se produiront :

• "salut"
• "combien ça coûte ?"
• "est-ce qu'on est ouvert le samedi ?"
• "je veux réserver"
• "je dois parler à un humain"

Observez les réponses. Retournez dans le panneau d'OpenClaw → Conversations pour voir la transcription.

Ajustez ce qui ne s'est pas bien passé : si l'agent a fait une erreur de compréhension ou a inventé quelque chose, retournez dans le champ de personnalité et ajoutez la règle qui manquait. L'agent re-lit la description à chaque nouvelle message — les modifications sont valables pour la prochaine conversation.

---

Les 4 erreurs les plus courantes dans les 10 premières minutes

1. Objectif trop vague. L'agent avec un objectif vague donne une réponse vague. Réécrivez avec le résultat concret que vous attendez.
2. Oublier les restrictions négatives. "N'oubliez jamais de dire que vous êtes ouvert" vaut plus que "soyez professionnel". Les règles négatives guident mieux.
3. Passer l'intégration et tester uniquement avec du texte. L'agent sans calendrier dans l'exemple de la clinique devient décoratif — le client quitte la conversation sans avoir réservé rien.
4. Croyez que vous êtes prêt au premier test. Les 20-30 premiers tours réels révèlent des modèles que vous n'aviez pas prévus. Réservez une semaine pour itérer avant de désactiver l'agent humain.

---

Et après les 10 minutes ?

L'agent en ligne est seulement le point de départ. Le travail réel pour maximiser le résultat est de :

• Analyser les conversations réelles et affiner la personnalité.
• Ajouter des compétences personnalisées pour les opérations spécifiques de votre entreprise (consultation de stock, vérification de paiement, etc).
• Configurer un handoff intelligent pour quand l'agent doit appeler un humain.
• Suivre les indicateurs de résolution vs échelle.

Nous abordons chacun de ces points dans des posts séparés — mais il est d'abord nécessaire de comprendre ce qui se passe à l'intérieur de l'agent à chaque tour de conversation pour ajuster nos attentes.