Intégration n8n WhatsApp Business pas à pas

• Un compte Meta développeur, créé sur developers.facebook.com avec votre compte Facebook.
• Un portefeuille business Meta, l'ancien Business Manager, au nom de votre entreprise.
• Un numéro de téléphone pour l'API. Le plus simple est un numéro dédié, qui n'est pas déjà utilisé dans l'application WhatsApp.
• Une instance n8n accessible depuis internet en HTTPS. Meta n'envoie les messages entrants qu'à une adresse sécurisée, donc une installation sur votre ordinateur ne suffit pas pour recevoir.
• Une page de politique de confidentialité et des conditions d'utilisation en ligne. Meta demande leurs adresses avant d'activer l'application.

1. Dans le tableau de bord des applications Meta, créez une application de type business. 2. Ajoutez le produit WhatsApp et rattachez votre portefeuille business. 3. Dans App settings, puis Basic, renseignez l'adresse de votre politique de confidentialité et de vos conditions d'utilisation. 4. Dans WhatsApp, puis API Setup, ajoutez votre numéro et validez-le avec le code reçu par SMS ou par appel. 5. Passez l'application en mode Live.

Notez au passage deux identifiants affichés dans API Setup : l'identifiant du numéro de téléphone et l'identifiant du compte WhatsApp Business. n8n vous les demandera.

La page API Setup propose un bouton pour générer un jeton d'accès. Il fonctionne, mais il expire au bout de 24 heures. Le lendemain, vos workflows échouent sans que rien n'ait changé de votre côté.

Pour un usage réel, créez un utilisateur système dans les paramètres de votre portefeuille business, donnez-lui accès à l'application et au compte WhatsApp, puis générez un jeton pour cet utilisateur avec les autorisations de gestion et d'envoi de messages WhatsApp. Ce jeton n'expire pas tant que vous ne le révoquez pas. C'est lui qu'il faut coller dans n8n.

n8n utilise deux types d'identifiants pour WhatsApp.

• Pour envoyer des messages, le nœud WhatsApp Business Cloud demande le jeton d'accès et l'identifiant du compte WhatsApp Business.
• Pour recevoir des messages, le nœud WhatsApp Trigger demande l'App ID et l'App Secret, visibles dans App settings, puis Basic.

Un workflow simple pour démarrer : un WhatsApp Trigger qui reçoit le message, un nœud qui enregistre l'expéditeur et le texte dans Google Sheets, puis un nœud WhatsApp Business Cloud qui répond « Bien reçu, on vous rappelle dans la journée ».

Meta n'accepte qu'une seule adresse de réception par application. Or n8n utilise une adresse de test quand vous testez le workflow et une adresse de production quand il est actif. L'une remplace l'autre. Si vous lancez un test alors que le workflow tourne en production, les messages des clients partent vers l'adresse de test et ne sont plus traités.

Deux habitudes évitent les mauvaises surprises : désactivez le workflow avant de tester, et réactivez-le juste après. Pour un usage sérieux, créez une deuxième application Meta réservée aux tests.

Activer le workflow enregistre l'adresse de n8n chez Meta, mais ne relie pas automatiquement votre application au compte WhatsApp Business. Sans ce lien, aucun message n'arrive dans n8n, et aucune erreur ne s'affiche.

Si votre trigger reste muet, vérifiez dans le tableau de bord Meta que l'application est bien abonnée au compte WhatsApp Business et que le champ messages est coché dans la configuration des webhooks.

Quand un client vous écrit, une fenêtre de 24 heures s'ouvre. Pendant ces 24 heures, vous pouvez lui répondre librement, et ces messages de service ne sont pas facturés par Meta.

En dehors de cette fenêtre, ou pour écrire en premier à un client, vous devez utiliser un modèle de message validé par Meta. Ces modèles sont classés en marketing, utilitaire ou authentification, et chaque message envoyé est facturé selon le pays du destinataire. Les tarifs pour la France sont publiés sur la page de prix de la WhatsApp Business Platform. Ils changent régulièrement, vérifiez-les avant de lancer un envoi à grande échelle.

Pour écrire en premier, il faut aussi que le client ait accepté de recevoir vos messages WhatsApp, par exemple en cochant une case sur votre formulaire de devis.

• Confirmer un rendez-vous la veille avec un modèle utilitaire, et noter la réponse du client dans l'agenda.
• Recevoir les photos d'un dégât envoyées par un client et les ranger dans son dossier.
• Répondre aux questions fréquentes la nuit avec un agent IA qui connaît vos tarifs et vos zones d'intervention, puis passer la main à un humain le matin.
• Envoyer le lien du devis signé dès qu'il est validé dans votre logiciel.

Pour des idées d'agents IA, voir le guide agent IA, 8 exemples pour une PME. Si n8n n'est pas encore installé, commencez par utiliser n8n gratuit.