Enviar respuestas a n8n
Inicia un flujo de n8n con cada respuesta que reciba una campaña, o desde un paso de un flujo de trabajo de Polzy — en n8n Cloud o en tu propio servidor. Conecta n8n una vez y da a cada campaña la URL de su flujo.
En esta página
n8n es una herramienta de flujos de trabajo que puedes usar en su nube o en tu propio servidor. Con n8n conectado, cada respuesta que recibe una campaña inicia uno de tus flujos de n8n, y un flujo de trabajo de Polzy también puede iniciar uno. Al final de esta guía tendrás un flujo de n8n que recibe tus respuestas y — si añades una clave de API — una lista de tus flujos para elegir en lugar de direcciones que pegar.
n8n está incluido en el plan Business. Solo un Administrador puede conectarlo y elegir adónde van las respuestas de una campaña.
Antes de empezar
Necesitas:
- Un espacio de trabajo en el plan Business, con el rol de Administrador.
- Integraciones activado para el espacio de trabajo, en Configuración → General → Qué hace este espacio de trabajo.
- Un flujo de n8n que empiece por un nodo Webhook que acepte
POST, publicado para que funcione su URL de producción. - Un n8n accesible desde internet por HTTPS. Polzy rechaza las direcciones de una red privada.
- Opcionalmente, una clave de API de n8n, para que Polzy pueda listar tus flujos por su nombre. n8n no ofrece su API durante la prueba gratuita.
Preparar el flujo en n8n
- En n8n, empieza el flujo con un nodo Webhook y pon su método en
POST. - En el ajuste Respond del nodo, elige Immediately, para que Polzy reciba respuesta enseguida mientras se ejecuta el resto del flujo. Polzy espera 30 segundos como máximo.
- Publica el flujo y copia la Production URL del nodo — no la URL de prueba, que solo funciona mientras escuchas en el editor.
n8n describe el nodo en n8n: Webhook node.
Conectar n8n a Polzy
- En la barra lateral, en Automatizar, abre Integraciones y elige la pestaña Disponibles.
- Busca n8n y elige Conectar.
- Para elegir los flujos por su nombre, rellena tanto URL de la instancia de n8n — la dirección donde abres n8n — como API Key. Para pegar las direcciones de los flujos, deja ambos vacíos: van juntos o ninguno.
- Elige Probar conexión. Con ambos rellenos, Polzy responde Connected to n8n; sin ninguno, Connected. Each step names the n8n workflow it starts.
- Elige Conectar.
Para crear una clave de API, en n8n abre Settings → n8n API y elige Create an API key — consulta n8n: API authentication. La clave se guarda cifrada.
Dar a una campaña su flujo
- Abre Campañas, luego la campaña y su pestaña Integraciones.
- En Añadir una conexión, busca n8n y elige Conectar. Si el botón dice Configurar, n8n aún no está conectado al espacio de trabajo.
- En URL del flujo, pega la URL de producción del flujo que deben iniciar estas respuestas.
- Elige Guardar cambios.
n8n aparece entonces en Conectado a esta campaña, con su interruptor, Editar configuración, Desconectar y cuántas respuestas se han enviado.
Qué recibe n8n
Cada respuesta es un POST con un cuerpo JSON:
| Campo | Qué contiene |
|---|---|
event | survey.response para la respuesta de una campaña, workflow.step desde un flujo de trabajo de Polzy. |
timestamp | Cuándo se envió la solicitud. En una respuesta anónima, el día en que se dio. |
data.survey.id, data.survey.title | El ID y el título de la encuesta. |
data.response.id | El ID de la respuesta en Polzy. Vacío en una respuesta anónima. |
data.response.submittedAt | Cuándo se terminó la respuesta. En una respuesta anónima, solo el día. |
data.response.answers | Un elemento por pregunta respondida, cada uno con questionId, questionText y value. |
data.response.score | La puntuación total, si ya estaba calculada al enviarse la solicitud. |
Cuando la conexión tiene una clave de API y la URL del flujo está en el mismo host que la URL de la instancia de n8n, la solicitud lleva también la clave en el encabezado X-N8N-API-KEY. Un flujo en otro host se llama sin ella.
Una respuesta anónima lleva lo que dice, su puntuación y su día, y nada que permita identificar o situar en el tiempo a quien la escribió. Polzy espera a la revisión de seguridad de cada respuesta, hasta 10 minutos, antes de enviarla. El tamaño mínimo de grupo no retiene las respuestas sueltas.
Iniciar n8n desde un flujo de trabajo de Polzy
- Abre Flujos de trabajo y el flujo, o crea uno nuevo.
- En Conectores, dentro de Pasos instalados, arrastra Activar un flujo de n8n · n8n al lienzo.
- En URL del flujo de trabajo, elige uno de tus flujos activos que empiecen por un nodo Webhook — aparecen cuando la conexión tiene una clave de API — o pega su URL de producción.
- Deja Contenido vacío para enviar todo lo que sabe la ejecución, o escribe el JSON que quieras, con
{{para insertar valores de la ejecución. - Elige Enviar prueba para enviar una solicitud rellenada con una respuesta de ejemplo y mírala en Executions de n8n.
El paso deja la respuesta de n8n como {{connector.statusCode}} y {{connector.response}} — con Respond en When Last Node Finishes, es el resultado de tu flujo.
¿No tienes el plan Business? El paso Webhook saliente de un flujo de trabajo envía a cualquier dirección, también a un nodo Webhook de n8n, sin conectar n8n. Los flujos de trabajo están incluidos en el plan Equipo. Consulta Flujos de trabajo.
Comprobar que funciona
En la pestaña Integraciones de la campaña, la línea de actividad cuenta las respuestas enviadas y las que fallaron. La página de n8n en Polzy muestra cada envío en Actividad, con Correcto o Falló y el motivo, y la pestaña Executions de n8n muestra cada ejecución de su lado.
Solución de problemas
- The instance URL and the API key go together. Solo está relleno uno de los dos. Rellena ambos o vacía ambos.
- n8n refused this API key. La clave es incorrecta, caducó o se eliminó. Crea una nueva en Settings → n8n API.
- n8n answered, but its public API is switched off. Enable it in n8n's settings. En tu propio servidor, la API está desactivada — consulta n8n: Disable the public REST API. Vuelve a activarla, o conecta sin clave.
- private addresses are not allowed. La dirección apunta a una red privada. Polzy solo puede llegar a un n8n que esté en internet.
- only https endpoints are allowed. La URL debe empezar por
https://. - Request failed with status code 404 (en Actividad). El flujo no está publicado, o la URL es su URL de prueba. Publícalo y usa la Production URL.
- Tu flujo no aparece en la lista URL del flujo de trabajo. Solo aparecen los flujos activos que empiezan por un nodo Webhook. Publícalo, o pega su URL.
Las respuestas que llegaron antes de guardar la URL, o con el interruptor apagado, no se envían después. Expórtalas desde Respuestas de la encuesta.
Conviene saber
- ¿Falla un flujo lento? Una solicitud a la que n8n no responde en 30 segundos cuenta como fallida y se reintenta, hasta tres veces en total. Responde con Immediately para evitarlo.
- ¿Puede n8n comprobar que una llamada viene de Polzy? La clave de API solo viaja a tu propia instancia. Para proteger un nodo Webhook por sí solo, n8n ofrece autenticación por encabezado; la conexión de n8n de Polzy no envía ningún otro encabezado.
- ¿Puede n8n devolver datos a Polzy? No por esta conexión. Un flujo de trabajo de Polzy puede empezar con un Webhook entrante — consulta Webhooks.
Enlaces útiles
Artículos relacionados
Los miembros con sesión iniciada pueden preguntar a Polzy o escribir al equipo desde Soporte. La rapidez de nuestra respuesta depende de tu plan.