Comment envoyer les réponses et les UTM de mon formulaire de candidature vers n8n ou Airtable ?

1Étape 1 : Les UTM : rien à ajouter au formulaire

Le formulaire relève tout seul les paramètres de provenance présents dans le lien d'arrivée : utm_source, utm_medium, utm_campaign, utm_term, utm_content, ainsi que les identifiants de clic des publicités (Meta, Google).

Si le visiteur est arrivé sur une page précédente de votre tunnel avec ces paramètres, puis remplit le formulaire sur une page suivante, ils sont quand même retenus.

Il vous suffit donc de mettre des UTM dans vos liens. Exemple pour un lien placé sous une vidéo YouTube :

https://votre-nom.wolfeo.me/candidature?utm_source=youtube&utm_medium=video&utm_campaign=lancement

2Étape 2 : Demandez le téléphone dans le formulaire

Dans l'onglet Questions de votre formulaire, cliquez sur Ajouter une question et choisissez le type Téléphone. La réponse remplit automatiquement le téléphone de la fiche du contact (« Mappé automatiquement (verrouillé) »). Faites de même avec Prénom et Email.

3Étape 3 : Prévenez n8n à chaque envoi (action webhook)

1. Dans n8n, créez un scénario qui commence par un nœud Webhook (méthode POST) et copiez son adresse en https://….
2. Dans Wolfeo, ouvrez votre formulaire, onglet Actions.
3. Dans le bloc Toujours (à chaque soumission), cliquez sur Ajouter une action et choisissez Appel webhook (HTTP POST).
4. Collez l'adresse de n8n dans le champ URL https://…. Dans Secret (X-Webhook-Secret), inventez un mot de passe : il arrivera dans l'en-tête X-Webhook-Secret de chaque message, pour que votre scénario vérifie qu'il vient bien de vous.
5. Cliquez sur Enregistrer.

À chaque candidature, n8n reçoit un message de ce type :

{"telephone":"+33612345678","reponse_contact":null,"prenom":"Marie","email":"[email protected]",
 "reponses":[{"question_id":12,"label":"Quel est votre projet ?","type":"text","answer":"Lancer ma formation"}]}

reponses contient toutes les réponses du candidat : pour chaque question, son numéro (question_id), son intitulé (label), son type (type) et la réponse (answer).

reponse_contact contient en plus la réponse à une question, celle que vous choisissez dans la ligne Si sous l'action. Laissez la valeur attendue vide : le message part à chaque envoi avec cette réponse. Si vous remplissez la valeur (par exemple « Oui »), le message ne part que pour les candidats qui ont répondu cela.

Pour n'envoyer que les candidats chauds, ajoutez l'action dans le bloc Si la sortie est « Chaud » au lieu de Toujours.

4Étape 4 : Récupérez les UTM et le score avec l'API

Le message du webhook contient les réponses, mais ni les UTM, ni le score, ni la qualification. Si vous en avez besoin, votre scénario les demande ensuite à Wolfeo.

1. Dans Réglages, puis Développeurs, partie Clefs API, cliquez sur Générer une clef API et copiez la clef. Gardez-la pour vous : elle donne accès à vos données.

https://wolfeo.me/settings/developers

Agrandir

2. Dans n8n, après le nœud Webhook, ajoutez un nœud HTTP Request :
   • méthode GET ;
   • adresse https://api.wolfeo.me/v1/form-submissions?email= suivie de l'e-mail reçu, puis &include_attribution=true ;
   • un en-tête Authorization dont la valeur est Bearer suivi de votre clef API.
3. La réponse liste les candidatures de ce contact, la plus récente en premier : son numéro (id), le score, la qualification (bucket : hot, warm ou cold), et la provenance dans attribution (par exemple utm_source).
4. Pour avoir chaque question et sa réponse, ajoutez un deuxième nœud HTTP Request vers https://api.wolfeo.me/v1/form-submission?id= suivi du numéro obtenu. Vous recevez la fiche du candidat (avec son téléphone), la qualification, les UTM et la liste answers : pour chaque question, son intitulé (label) et la réponse (answer).
5. Terminez par un nœud Airtable qui crée une ligne avec les champs voulus.

Vous pouvez aussi récupérer d'un coup toutes les candidatures d'un formulaire : https://api.wolfeo.me/v1/form-submissions?form_id= suivi du numéro du formulaire (visible dans l'adresse de son éditeur), avec &include_attribution=true.

Les pièges à éviter

• Un contact peut avoir plusieurs candidatures : prenez la première de la liste, c'est la plus récente.
• Une question choisie dans « Si » mais laissée sans réponse par le candidat bloque le message : ne choisissez qu'une question obligatoire.
• Ne partagez jamais la clef API. Si elle a fuité, supprimez-la et générez-en une autre.

Si ça ne marche pas