Automatiser WhatsApp avec n8n : tutoriel complet 2026

Prérequis avant de commencer :

• Un compte Meta Business Manager vérifié (document légal : kbis ou extrait Infogreffe)
• Un numéro de téléphone dédié (mobile, fixe ou virtuel VOIP — pas votre numéro WhatsApp actuel)
• Une instance n8n accessible depuis internet (self-hosted sur VPS ou n8n Cloud)
• Un compte 360dialog (BSP recommandé pour l'UE — hébergement Allemagne)
• Comptez 1 à 2 heures pour la configuration complète

Procédure d'inscription 360dialog :

• Créez un compte sur 360dialog.com avec votre email professionnel
• Dans le tableau de bord, cliquez 'Add Channel' → 'WhatsApp'
• Connectez votre Meta Business Manager via le bouton Facebook (autorisation OAuth)
• Entrez votre numéro de téléphone dédié et choisissez la méthode de vérification (SMS ou appel vocal)
• Entrez le code de vérification reçu — votre numéro est maintenant lié à l'API
• Copiez votre API Key depuis 360dialog Dashboard → Settings → API Keys

Configuration du webhook dans n8n :

• Dans n8n, créez un nouveau workflow et ajoutez un nœud 'Webhook' en trigger
• Sélectionnez la méthode POST et notez l'URL générée (ex: https://votre-n8n.com/webhook/whatsapp-entrant)
• Dans 360dialog Dashboard → Settings → Webhooks, entrez cette URL et cochez 'Message received'
• Enregistrez — 360dialog va envoyer un message de test immédiatement
• Dans n8n, activez votre workflow (toggle en haut à droite) pour commencer à recevoir les webhooks
• Testez en envoyant un message WhatsApp sur votre numéro dédié — vous devriez voir l'événement apparaître dans n8n

Configuration du nœud HTTP Request pour répondre :

• Méthode : POST
• URL : https://waba.360dialog.io/v1/messages
• Headers : D360-API-KEY = votre_api_key_360dialog, Content-Type = application/json
• Body (JSON) : { "to": "{{ $json.messages[0].from }}", "type": "text", "text": { "body": "Bonjour ! Merci pour votre message. Notre équipe revient vers vous sous 24h." } }
• Testez le nœud — vous devriez recevoir la réponse sur votre téléphone WhatsApp

Exemple de logique Switch sur le contenu du message :

• Ajoutez un nœud 'Switch' après le webhook
• Valeur à évaluer : {{ $json.messages[0].text.body.toLowerCase() }}
• Règle 1 : contient 'prix' ou 'tarif' → branche Tarification
• Règle 2 : contient 'rdv' ou 'rendez-vous' ou 'disponibilité' → branche Prise de RDV
• Règle 3 : contient 'urgence' ou 'urgent' → branche Escalade humaine
• Règle Default : message non reconnu → réponse menu général

Workflow complet pour un nouveau contact :

• Nœud 1 : Webhook → reçoit le message WhatsApp
• Nœud 2 : HubSpot → 'Search Contact' avec le numéro de téléphone comme critère
• Nœud 3 : IF → contact trouvé ? OUI → passer au traitement normal, NON → créer la fiche
• Nœud 4 (branche NON) : HubSpot → 'Create Contact' avec phone = {{ $json.messages[0].from }}
• Nœud 5 : Slack → notification interne 'Nouveau contact WhatsApp : +33XXXXXXXXX'
• Nœud 6 : HTTP Request → réponse de bienvenue personnalisée au client

Exemples de gestion des types de messages :

• type = 'image' → télécharger l'image via l'API 360dialog, l'envoyer à GPT-4o Vision pour analyse, répondre selon le contenu
• type = 'audio' → télécharger le fichier audio, l'envoyer à Whisper (OpenAI) pour transcription, traiter le texte transcrit
• type = 'document' → télécharger le PDF, extraire le texte, traiter comme un message texte
• type = 'location' → récupérer les coordonnées GPS, utiliser dans un workflow de dispatch terrain
• type non géré → répondre 'Je gère uniquement les messages texte pour l'instant'

Logique d'escalade recommandée :

• Si le message contient 'humain', 'agent', 'parler à quelqu'un' → stocker status='escalade' pour ce numéro
• Si status='escalade' → ne pas répondre automatiquement, envoyer une notification Slack/email à votre équipe avec le message du client
• Le collaborateur répond depuis WhatsApp Business App (ou depuis votre interface) et met status='résolu'
• Si pas de réponse humaine sous 4h → bot envoie 'Nous revenons vers vous au plus vite' automatiquement
• Reset automatique du status='normal' après résolution ou après 24h d'inactivité

Procédure de création et validation d'un template :

• Dans 360dialog Dashboard → Templates → Create Template
• Choisissez une catégorie : MARKETING, UTILITY ou AUTHENTICATION
• Rédigez votre template en français avec des variables entre doubles accolades : 'Bonjour {{1}}, votre rendez-vous du {{2}} à {{3}} est confirmé.'
• Soumettez pour validation — délai Meta : 24 à 72h
• Une fois approuvé, appelez-le depuis n8n avec les valeurs de substitution dans le corps JSON
• Catégorie UTILITY (confirmation RDV, suivi commande) → validation plus rapide et moins de restrictions

Problèmes courants :

• Webhook non déclenché : vérifiez que votre workflow n8n est bien activé (toggle vert) et que l'URL webhook est correctement saisie dans 360dialog. n8n doit être accessible depuis internet (pas depuis localhost).
• Erreur 401 sur l'API 360dialog : votre API Key est incorrecte ou expirée. Régénérez-la dans 360dialog Dashboard → Settings → API Keys.
• Message non reçu côté client : le numéro destinataire doit avoir WhatsApp installé. Testez avec votre propre numéro personnel d'abord.
• Template rejeté par Meta : les templates marketing avec des offres promotionnelles sont plus souvent rejetés. Reformulez en UTILITY (information transactionnelle) si possible.
• Boucle infinie (le bot répond à ses propres messages) : filtrez les messages entrants — ignorez si messages[0].from === votre_numero_api.