Envoyer automatiquement vos leads Meta Ads dans WhatsApp avec n8n et l'API Whakup

Un prospect qui remplit un formulaire de publicité Meta (Lead Ads) est à son niveau d'intérêt maximal au moment où il valide. Chaque heure qui passe avant le premier contact réduit les chances qu'il se souvienne de votre offre. Pourtant, dans beaucoup d'entreprises, ces leads attendent dans un Google Sheet qu'une personne les copie à la main dans un autre outil. Ce tutoriel montre comment automatiser tout le parcours avec n8n et l'API Whakup : du Google Sheet jusqu'au message de bienvenue WhatsApp, sans intervention manuelle.

Vue d'ensemble du scénario

Le flux complet comporte quatre étapes :

Les leads Meta Ads arrivent dans un Google Sheet, une ligne par prospect.
n8n détecte chaque nouvelle ligne et normalise le numéro de téléphone dans un nœud Code.
n8n crée le contact dans Whakup avec un appel POST https://api.whakup.com/v1/contacts, en l'ajoutant au groupe « Prospect ».
L'ajout au groupe déclenche une automatisation Whakup de type « Ajout à un groupe », qui envoie un template de bienvenue.

La répartition des rôles est nette : n8n transporte et nettoie les données, Whakup gère le contact, le message et la suite de la conversation.

Prérequis

Un compte Whakup avec accès API. L'API est disponible avec l'offre Business (voir les tarifs). Sans cet accès, l'API répond 402 feature_locked.
Une clé API Whakup, créée dans Réglages puis Clés API. Elle commence par wk_ et n'est affichée qu'une fois.
Une instance n8n, hébergée chez n8n ou sur votre propre serveur.
Un Google Sheet alimenté par vos Lead Ads, via l'intégration proposée par Meta ou un outil intermédiaire.
Un template de bienvenue approuvé par Meta dans Whakup.

Point préalable : le consentement

Un lead qui remplit un formulaire publicitaire n'a pas automatiquement accepté de recevoir des messages WhatsApp. Ajoutez à votre formulaire Lead Ads une question explicite, par exemple une case « J'accepte d'être recontacté sur WhatsApp ». Dans n8n, vous filtrerez ensuite les leads qui ont coché cette case. C'est une condition de conformité aux règles de Meta et un facteur de protection de votre numéro.

Étape 1 : préparer le Google Sheet

Un export Lead Ads contient généralement des colonnes comme full_name, email, phone_number, ainsi que vos questions personnalisées. Deux problèmes reviennent souvent :

le numéro est préfixé par p: (par exemple p:+33612345678) ;
si quelqu'un ouvre ou retraite le fichier dans un tableur, le zéro initial des numéros nationaux peut disparaître.

Ces défauts seront corrigés dans n8n. Assurez-vous seulement que la première ligne contient bien les en-têtes de colonnes.

Étape 2 : déclencher le workflow sur chaque nouvelle ligne

Dans n8n, créez un workflow et ajoutez un nœud Google Sheets Trigger :

événement : ligne ajoutée (Row Added) ;
document et feuille : ceux qui reçoivent vos leads ;
fréquence de vérification : chaque minute suffit pour un délai de premier contact très court.

Alternative : n8n propose aussi un déclencheur Facebook Lead Ads qui reçoit les leads directement, sans passer par le Google Sheet. Le reste du workflow est identique.

Étape 3 : normaliser les numéros dans un nœud Code

Ajoutez un nœud Code (mode « Run Once for All Items », langage JavaScript). Il nettoie le numéro, construit le corps de la requête et marque les lignes inexploitables.

// Indicatif par défaut pour les numéros saisis au format national
const DEFAULT_CC = '33';

return $input.all().map((item) => {
  const row = item.json;

  let raw = String(row.phone_number || '').trim();
  raw = raw.replace(/^p:/i, '');          // préfixe des exports Lead Ads
  let digits = raw.replace(/[^\d+]/g, ''); // espaces, points, tirets

  if (digits.startsWith('+')) digits = digits.slice(1);
  else if (digits.startsWith('00')) digits = digits.slice(2);
  else if (digits.startsWith('0')) digits = DEFAULT_CC + digits.slice(1);
  else if (digits.length === 9) digits = DEFAULT_CC + digits; // zéro perdu (France)

  const valid = digits.length >= 8 && digits.length <= 15;

  return {
    json: {
      valid,
      body: {
        displayName: (row.full_name || '').trim(),
        phone: valid ? '+' + digits : null,
        email: row.email ? String(row.email).trim().toLowerCase() : undefined,
        groups: ['Prospect'],
      },
    },
  };
});

Adaptez DEFAULT_CC à votre marché principal : 225 pour la Côte d'Ivoire, 221 pour le Sénégal, 212 pour le Maroc. La règle sur les numéros à 9 chiffres est propre au format français ; supprimez-la ou adaptez-la pour d'autres pays.

L'API Whakup reconnaît déjà un même numéro quel que soit son format pour éviter les doublons. Normaliser en amont reste utile pour écarter les numéros inexploitables avant l'appel et garder des données propres partout.

Étape 4 : filtrer les lignes valides

Ajoutez un nœud IF (ou Filter) qui ne laisse passer que les éléments où valid est vrai, et, le cas échéant, où la case de consentement WhatsApp est cochée. Les lignes rejetées peuvent être envoyées vers une feuille « À vérifier » pour un traitement manuel.

Étape 5 : créer le contact dans Whakup

Ajoutez un nœud HTTP Request :

Method : POST
URL : https://api.whakup.com/v1/contacts
Authentication : Generic Credential Type, puis Header Auth, avec le nom Authorization et la valeur Bearer wk_votre_cle
Send Body : activé, Body Content Type JSON, Specify Body Using JSON
JSON : {{ JSON.stringify($json.body) }}

Le corps envoyé ressemble à ceci :

{
  "displayName": "Awa Koné",
  "phone": "+2250700000000",
  "email": "awa.kone@example.com",
  "groups": ["Prospect"]
}

L'API répond 201 si le contact est créé, 200 s'il existait déjà et a été mis à jour, avec un champ created qui l'indique. Comme le numéro sert de clé de dédoublonnage, vous pouvez rejouer le workflow sans créer de doublons. Le groupe « Prospect » est créé automatiquement s'il n'existe pas encore.

Stockez la clé dans les credentials n8n, jamais en clair dans le workflow. La référence complète de l'endpoint est sur la page développeurs.

Gérer les limites et les erreurs

Dans les paramètres du nœud, activez Retry On Fail avec quelques secondes d'attente. L'API autorise 1 200 requêtes par minute et par clé ; en cas de dépassement, elle répond 429 avec un en-tête Retry-After. Pour un flux de leads publicitaires, cette limite est rarement atteinte, mais un import rétroactif de plusieurs milliers de lignes peut la dépasser.

Étape 6 : créer l'automatisation de bienvenue dans Whakup

Dans Whakup, ouvrez l'éditeur d'automatisations et créez un flux :

Déclencheur : « Ajout à un groupe », groupe « Prospect ». Le nom doit correspondre exactement à celui envoyé par n8n.
Étape : « Envoyer un template », avec votre template de bienvenue. Le prospect ne vous a pas encore écrit, un template approuvé est donc obligatoire.
Étape : « Attendre une réponse », avec une branche en cas d'absence de réponse après 24 heures ou 3 jours.
Branche réponse : « Assigner à un agent », pour qu'un commercial reprenne la conversation dans l'inbox.
Branche sans réponse : une relance par template, ou la fin du flux.

Testez le flux avant de l'activer, puis consultez le rapport d'exécution après les premiers leads.

L'ajout au groupe déclenche l'automatisation pour les nouveaux membres. Un contact déjà présent dans le groupe « Prospect » qui remplirait de nouveau le formulaire ne recevra pas une seconde fois le message de bienvenue.

Rédiger le template de bienvenue

Le template est le premier contact du prospect avec votre marque sur WhatsApp. Quelques principes :

Rappelez le contexte : « Bonjour {{1}}, merci pour votre demande concernant notre offre... ». Le prospect doit comprendre immédiatement pourquoi il reçoit ce message.
Proposez une action simple : des boutons de réponse rapide (« Recevoir la brochure », « Être rappelé ») ou un bouton formulaire pour qualifier le besoin avec un formulaire WhatsApp.
Choisissez la bonne catégorie : un message de bienvenue qui présente une offre relève de la catégorie marketing.

Aller plus loin

Remonter les réponses dans vos outils : les webhooks sortants de Whakup (message reçu, formulaire rempli) peuvent être reçus par un nœud Webhook de n8n pour mettre à jour votre CRM ou votre Google Sheet.
Ajouter des champs personnalisés : le champ customFields de l'API (par exemple la campagne publicitaire d'origine) permet d'enrichir la fiche contact et d'utiliser ces valeurs comme variables de template.
Segmenter par source : envoyez les leads de chaque campagne publicitaire dans un groupe distinct pour adapter le message de bienvenue.

Pour une vue d'ensemble des possibilités, consultez la page API WhatsApp.

FAQ

Existe-t-il un connecteur n8n officiel pour Whakup ?

Non. L'intégration se fait via l'API Whakup et les webhooks, avec le nœud HTTP Request de n8n. Le même principe fonctionne avec Make ou Zapier en requête HTTP.

Que se passe-t-il si un même lead remplit deux fois le formulaire ?

L'API reconnaît le numéro et met à jour le contact existant au lieu d'en créer un nouveau. Comme il est déjà membre du groupe, l'automatisation de bienvenue ne se redéclenche pas.

Combien coûte l'envoi du message de bienvenue ?

Le template de bienvenue est un message initié par l'entreprise, facturé par Meta selon sa catégorie (marketing dans la plupart des cas), en plus de votre abonnement Whakup. Les réponses que vous envoyez ensuite dans la fenêtre de service client de 24 heures ne sont pas facturées par Meta.

Peut-on envoyer le message directement depuis n8n sans automatisation Whakup ?

L'API propose un endpoint d'envoi de messages. Passer par l'ajout au groupe et une automatisation Whakup présente toutefois des avantages : le template, les relances et l'assignation se gèrent dans l'interface, sans modifier le workflow n8n.

Automatiser vos leads

Pour mettre en place ce scénario, créez votre clé API depuis le tableau de bord et connectez votre premier workflow n8n. Ouvrez votre compte Whakup : essai gratuit de 15 jours, sans carte bancaire.