Poser la pierre angulaire de notre système en connectant WhatsApp à n8n.
📖 COURS
1) QU'EST-CE QUE N8N ?
Imaginez n8n comme une boîte de Legos pour vos applications. C'est un outil d'automatisation de flux de travail (*workflow automation*) qui vous permet de connecter différentes applications et services entre eux pour qu'ils communiquent et travaillent ensemble, sans que vous ayez à écrire une seule ligne de code complexe. Nous l'utiliserons comme le "cerveau" central de notre agent IA, car c'est lui qui recevra les messages de WhatsApp et décidera quoi en faire.
2) POURQUOI CONNECTER WHATSAPP DIRECTEMENT ?
En connectant directement WhatsApp à n8n, nous créons un pont entre vos conversations et un monde de possibilités d'automatisation. Chaque message reçu peut devenir un **déclencheur** (*trigger*) pour :
- Répondre automatiquement à un client.
- Enregistrer une information dans votre CRM.
- Ajouter une tâche à votre liste de choses à faire.
- Et bien plus encore...
3) LE CONCEPT CLÉ : LE WEBHOOK
Pour que n8n puisse "écouter" ce qui se passe sur WhatsApp, nous utilisons un mécanisme appelé **Webhook**. Un webhook est simplement une URL spéciale que n8n génère. Nous allons fournir cette URL à WhatsApp (via la plateforme des développeurs Meta). Ainsi, chaque fois qu'un nouveau message arrive sur votre numéro WhatsApp, Meta enverra instantanément une notification à cette URL. N8n, qui écoute attentivement, recevra cette notification (contenant le message, le numéro de l'expéditeur, etc.) et démarrera le flux de travail que nous aurons défini.
🗝️ POINTS CLÉS
1) N8N EST LE HUB CENTRAL
- Toute la logique de notre agent IA résidera dans des flux de travail (workflows) n8n.
2) CONNEXION DIRECTE
- Nous utilisons l'API officielle de WhatsApp Business Platform, gérée via un compte Meta for Developers, pour éviter les intermédiaires coûteux.
3) LE WEBHOOK EST LA PORTE D'ENTRÉE
- C'est le mécanisme qui permet à n8n de recevoir en temps réel les messages envoyés à votre numéro WhatsApp.
4) CONTRÔLE TOTAL
- Cette approche vous garantit la souveraineté sur vos données et une flexibilité maximale pour faire évoluer votre agent.
💪 PRATIQUE
PRÉREQUIS
1) **Un compte n8n** : Assurez-vous d'avoir une instance n8n fonctionnelle. Vous pouvez utiliser n8n Cloud (version d'essai gratuite) ou l'auto-héberger.
2) **Un compte Facebook/Meta** : Un compte personnel est nécessaire pour accéder à la plateforme développeur.
3) **Un numéro de téléphone** : Pour les tests, vous utiliserez un numéro fourni par Meta. Pour la production, vous aurez besoin d'un numéro de téléphone qui n'est pas déjà lié à un compte WhatsApp personnel.
1) CRÉATION DE VOTRE APPLICATION SUR LA PLATEFORME META FOR DEVELOPERS
1) Ouvrez votre navigateur et allez sur [https://developers.facebook.com/](https://developers.facebook.com/).
2) Connectez-vous avec votre compte Facebook.
3) Cliquez sur **"Mes apps"** en haut à droite.
4) Cliquez sur le bouton vert **"Créer une app"**.
5) On vous demande de choisir un type d'application. Sélectionnez **"Autre"**, puis cliquez sur **"Suivant"**.
6) Choisissez le type d'application **"Business"**, puis **"Suivant"**.
7) Donnez un nom à votre application (ex: `Agent IA n8n`) et laissez l'email de contact. Ne sélectionnez pas de compte Business Manager pour l'instant si vous n'en avez pas. Cliquez sur **"Créer une app"**. Vous devrez peut-être saisir votre mot de passe Facebook.
8) Vous arrivez sur le tableau de bord de votre nouvelle application. Cherchez la carte **"WhatsApp"** et cliquez sur **"Configurer"**.
9) Dans la barre latérale gauche, cliquez sur **"Configuration de l'API"**. Meta va automatiquement créer pour vous un compte WhatsApp Business et un **numéro de téléphone de test**.
**Actions à réaliser sur cette page :**
- Notez précieusement l'**"ID du numéro de téléphone"** (Phone number ID).
- Notez l'**"Identifiant du compte WhatsApp Business"**.
- Vous verrez un **"Jeton d'accès temporaire"** (Temporary access token). Copiez-le et gardez-le dans un endroit sûr pour l'instant. **Attention : ce jeton expire après 23 heures.**
2) CRÉATION DU WEBHOOK DANS N8N
1) Ouvrez votre interface n8n.
2) Créez un nouveau workflow vide.
3) Le premier nœud (node) est par défaut le nœud **"Start"**. Cliquez sur le `+` pour ajouter un nouveau nœud.
4) Cherchez et sélectionnez le nœud **"Webhook"**.
5) Le nœud Webhook apparaît. Une URL est automatiquement générée. Cliquez sur le bouton **"Copier"** à côté de l'URL de **TEST**.
3) CONNEXION ENTRE META ET N8N
1) Retournez sur la page "Configuration de l'API" de votre application Meta.
2) Faites défiler jusqu'à la section **"Étape 3 : Configurer des webhooks pour recevoir des messages"** et cliquez sur le bouton **"Modifier"**.
3) Dans la fenêtre qui s'ouvre :
- **URL de rappel (Callback URL)** : Collez ici l'URL de TEST de votre webhook n8n que vous avez copiée à l'étape précédente.
- **Jeton de vérification du webhook (Verify Token)** : Inventez une chaîne de caractères secrète. C'est comme un mot de passe entre Meta et n8n. Par exemple : `MonAgentEstSuperSecret`. Notez-le.
4) Cliquez sur **"Vérifier et enregistrer"**. Si tout va bien, la fenêtre se ferme.
4) S'ABONNER AUX ÉVÉNEMENTS DE MESSAGE
1) Juste en dessous de là où vous avez cliqué sur "Modifier", vous verrez une ligne "Webhook Fields". Cliquez sur **"Gérer"** à droite de cette ligne.
2) Une fenêtre apparaît. Cherchez la ligne `whatsapp_business_account` et dans la colonne de droite, cliquez sur **"S'abonner"**.
3) Dans la liste qui apparaît, cochez la case **`messages`**.
4) Cliquez sur **"Terminé"**.
5) ENVOYER UN MESSAGE DE TEST POUR ACTIVER LE WEBHOOK
1) Retournez dans votre workflow n8n. Cliquez sur le bouton bleu **"Listen for Test Event"** dans le nœud Webhook. N8n se met maintenant en attente.
2) Retournez sur la page "Configuration de l'API" de Meta.
3) Allez à l'**"Étape 2 : Envoyer des messages avec l'API"**.
- Dans le champ "À" (To), sélectionnez votre numéro de téléphone personnel (vous devrez peut-être l'ajouter et le vérifier via un code envoyé sur votre WhatsApp).
- Cliquez sur le bouton **"Envoyer le message"**.
4) Regardez votre workflow n8n. Le nœud Webhook devrait afficher une coche verte et les données du message devraient apparaître ! Vous avez réussi.
❓ FAQ
1) LA VÉRIFICATION DE MON WEBHOOK ÉCHOUE, QUE FAIRE ?
Assurez-vous que :
- Vous avez bien cliqué sur "Listen for Test Event" dans n8n **AVANT** de cliquer sur "Vérifier et enregistrer" dans Meta.
- Le "Jeton de vérification" est exactement le même des deux côtés.
- Vous avez bien copié l'URL de **TEST** et non l'URL de Production de n8n.
2) MON JETON D'ACCÈS A EXPIRÉ. COMMENT LE RENOUVELER ?
Le jeton fourni est temporaire (23h). Pour une utilisation en production, vous devrez générer un jeton d'accès système qui n'expire pas. Cela se fait dans les paramètres de votre "Business Manager" de Meta, dans la section "Utilisateurs système".
3) PUIS-JE UTILISER MON PROPRE NUMÉRO DE TÉLÉPHONE ?
Oui, mais pour la production. Le processus implique de connecter votre numéro à l'API WhatsApp Business, ce qui le dissociera de toute utilisation personnelle de WhatsApp. Pour les tests, il est fortement recommandé de n'utiliser que le numéro de test fourni par Meta.
🧠 QUIZ
1) QUEL EST LE RÔLE PRINCIPAL D'UN WEBHOOK DANS CE MODULE ?
* a) Envoyer des messages depuis n8n.
* b) Permettre à n8n de recevoir des notifications de nouveaux messages de WhatsApp.
* c) Sécuriser la connexion entre n8n et WhatsApp.
* d) Créer une application sur la plateforme Meta.
...
Réponse : B
2) QUELLE INFORMATION N'EST PAS FOURNIE AUTOMATIQUEMENT LORS DE LA CRÉATION D'UNE APP WHATSAPP SUR LA PLATEFORME META ?
* a) Un numéro de téléphone de test.
* b) Un jeton d'accès permanent.
* c) Un ID de numéro de téléphone.
* d) Un identifiant de compte WhatsApp Business.
...
Réponse : B
3) QUELLE EST L'ACTION LA PLUS IMPORTANTE À FAIRE DANS N8N JUSTE AVANT DE VÉRIFIER L'URL DU WEBHOOK DANS L'INTERFACE META ?
* a) Copier l'URL de production.
* b) Cliquer sur "Listen for Test Event".
* c) Ajouter un nœud "HTTP Request".
* d) Sauvegarder le workflow.
...
Réponse : B