Envoyer les réponses vers n8n
Lancez un workflow n8n à chaque réponse reçue par une campagne, ou depuis une étape de workflow Polzy — sur n8n Cloud ou votre propre serveur. Connectez n8n une fois, puis donnez à chaque campagne l’URL de son workflow.
Sur cette page
n8n est un outil de workflows que vous pouvez utiliser dans son cloud ou sur votre propre serveur. Avec n8n connecté, chaque réponse reçue par une campagne lance l’un de vos workflows n8n, et un workflow Polzy peut aussi en lancer un. À la fin de ce guide, vous aurez un workflow n8n qui reçoit vos réponses et — si vous ajoutez une clé API — une liste de vos workflows à choisir plutôt que des adresses à coller.
n8n est inclus dans l’offre Business. Seul un Administrateur peut le connecter et choisir où vont les réponses d’une campagne.
Avant de commencer
Il vous faut :
- Un espace de travail sur l’offre Business, avec le rôle Administrateur.
- Intégrations activé pour l’espace de travail, dans Paramètres → Général → Ce que fait cet espace de travail.
- Un workflow n8n qui commence par un nœud Webhook acceptant
POST, publié pour que son URL de production fonctionne. - Un n8n accessible depuis internet en HTTPS. Polzy refuse les adresses d’un réseau privé.
- Facultativement, une clé API n8n, pour que Polzy puisse lister vos workflows par leur nom. n8n ne propose pas son API pendant l’essai gratuit.
Préparer le workflow dans n8n
- Dans n8n, commencez le workflow par un nœud Webhook et réglez sa méthode sur
POST. - Dans le réglage Respond du nœud, choisissez Immediately, pour que Polzy reçoive une réponse tout de suite pendant que le reste du workflow s’exécute. Polzy attend 30 secondes au maximum.
- Publiez le workflow et copiez la Production URL du nœud — pas l’URL de test, qui ne fonctionne que pendant que vous écoutez dans l’éditeur.
n8n décrit le nœud dans n8n: Webhook node.
Connecter n8n à Polzy
- Dans la barre latérale, sous Automatiser, ouvrez Intégrations et choisissez l’onglet Disponibles.
- Trouvez n8n et choisissez Connecter.
- Pour choisir les workflows par leur nom, renseignez à la fois URL de l'instance n8n — l’adresse à laquelle vous ouvrez n8n — et API Key. Pour coller plutôt les adresses des workflows, laissez les deux vides : c’est les deux ou aucun.
- Choisissez Tester la connexion. Avec les deux renseignés, Polzy répond Connected to n8n ; sans aucun, Connected. Each step names the n8n workflow it starts.
- Choisissez Connecter.
Pour créer une clé API, ouvrez dans n8n Settings → n8n API et choisissez Create an API key — voir n8n: API authentication. La clé est stockée chiffrée.
Donner son workflow à une campagne
- Ouvrez Campagnes, puis la campagne et son onglet Intégrations.
- Sous Ajouter une connexion, trouvez n8n et choisissez Connecter. Si le bouton indique Configurer, n8n n’est pas encore connecté à l’espace de travail.
- Sous URL du flux, collez l’URL de production du workflow que ces réponses doivent lancer.
- Choisissez Enregistrer les modifications.
n8n apparaît alors sous Connecté à cette campagne, avec son interrupteur, Modifier la configuration, Déconnecter et le nombre de réponses envoyées.
Ce que reçoit n8n
Chaque réponse est un POST avec un corps JSON :
| Champ | Contenu |
|---|---|
event | survey.response pour une réponse de campagne, workflow.step depuis un workflow Polzy. |
timestamp | Le moment où la requête a été envoyée. Pour une réponse anonyme, le jour où elle a été donnée. |
data.survey.id, data.survey.title | L’identifiant et le titre de l’enquête. |
data.response.id | L’identifiant de la réponse dans Polzy. Vide pour une réponse anonyme. |
data.response.submittedAt | Le moment où la réponse a été terminée. Pour une réponse anonyme, le jour seulement. |
data.response.answers | Un élément par question répondue, chacun avec questionId, questionText et value. |
data.response.score | Le score global, s’il était calculé au moment de l’envoi de la requête. |
Quand la connexion a une clé API et que l’URL du workflow est sur le même hôte que l’URL de l'instance n8n, la requête porte aussi la clé dans l’en-tête X-N8N-API-KEY. Un workflow sur un autre hôte est appelé sans elle.
Une réponse anonyme contient ce qu’elle dit, son score et son jour, et rien qui permette d’identifier ou de dater son auteur. Polzy attend la lecture de sécurité de chaque réponse, jusqu’à 10 minutes, avant de l’envoyer. La taille minimale des groupes ne retient pas les réponses individuelles.
Lancer n8n depuis un workflow Polzy
- Ouvrez Workflows et le workflow, ou créez-en un.
- Sous Connecteurs dans Étapes installées, faites glisser Déclencher un workflow n8n · n8n sur le canevas.
- Sous URL du workflow, choisissez l’un de vos workflows actifs qui commencent par un nœud Webhook — listés quand la connexion a une clé API — ou collez son URL de production.
- Laissez Charge utile vide pour envoyer tout ce que l’exécution connaît, ou écrivez le JSON voulu, avec
{{pour insérer des valeurs de l’exécution. - Choisissez Envoyer un test pour envoyer une requête remplie à partir d’une réponse d’exemple, puis consultez-la dans Executions de n8n.
L’étape transmet la réponse de n8n sous la forme {{connector.statusCode}} et {{connector.response}} — avec Respond réglé sur When Last Node Finishes, c’est le résultat de votre workflow.
Pas d’offre Business ? L’étape Webhook sortant d’un workflow envoie vers n’importe quelle adresse, y compris un nœud Webhook de n8n, sans connecter n8n. Les workflows sont inclus dans l’offre Équipe. Voir Workflows.
Vérifier que tout fonctionne
Dans l’onglet Intégrations de la campagne, la ligne d’activité compte les réponses envoyées et celles qui ont échoué. La page n8n de Polzy liste chaque envoi dans Activité, avec Réussi ou Échec et la raison, et l’onglet Executions de n8n montre chaque exécution de son côté.
Dépannage
- The instance URL and the API key go together. Un seul des deux est renseigné. Renseignez les deux, ou videz les deux.
- n8n refused this API key. La clé est erronée, expirée ou supprimée. Créez-en une nouvelle dans Settings → n8n API.
- n8n answered, but its public API is switched off. Enable it in n8n's settings. Sur votre propre serveur, l’API est désactivée — voir n8n: Disable the public REST API. Réactivez-la, ou connectez sans clé.
- private addresses are not allowed. L’adresse pointe vers un réseau privé. Polzy ne peut joindre qu’un n8n accessible sur internet.
- only https endpoints are allowed. L’URL doit commencer par
https://. - Request failed with status code 404 (dans Activité). Le workflow n’est pas publié, ou l’URL est son URL de test. Publiez-le et utilisez la Production URL.
- Votre workflow manque dans la liste URL du workflow. Seuls les workflows actifs qui commencent par un nœud Webhook y figurent. Publiez-le, ou collez son URL.
Les réponses reçues avant l’enregistrement de l’URL, ou pendant que l’interrupteur était coupé, ne sont pas envoyées plus tard. Exportez-les plutôt depuis l’onglet Réponses de l’enquête.
Bon à savoir
- Un workflow lent échoue-t-il ? Une requête à laquelle n8n n’a pas répondu en 30 secondes compte comme un échec et est retentée, jusqu’à trois fois au total. Répondez avec Immediately pour l’éviter.
- n8n peut-il vérifier qu’un appel vient de Polzy ? La clé API ne part que vers votre propre instance. Pour protéger un nœud Webhook seul, n8n propose une authentification par en-tête ; la connexion n8n de Polzy n’envoie aucun autre en-tête.
- n8n peut-il renvoyer des données dans Polzy ? Pas par cette connexion. Un workflow Polzy peut démarrer par un Webhook entrant — voir Webhooks.
Liens utiles
Articles liés
Les membres connectés peuvent demander à Polzy ou écrire à l’équipe depuis Support. Notre délai de réponse dépend de votre forfait.