What is a Webhook and why do I need it?

A Webhook is an HTTP notification that SurveyNinja sends to your server when a survey is submitted. You receive all response data as JSON.

Do I need a developer to set up a Webhook?

On the SurveyNinja side, no — just enter the URL. The receiving server must handle POST requests with JSON. Use Zapier if you have no backend.

What data does the Webhook request contain?

JSON with response ID, date/time, all answers by question name, contact details, UTM parameters, IP address, and user agent.

What happens if my server is unavailable?

SurveyNinja retries the request with increasing intervals on 5xx errors. Data is not lost.

Can I configure multiple Webhooks for one survey?

Yes. Add multiple URLs — each receives the full payload independently, letting you send to CRM, database, and chatbot simultaneously.

How do I secure my Webhook endpoint?

Add a secret token via custom authorization headers in SurveyNinja settings. Accept connections over HTTPS only.

How does a Webhook differ from Zapier?

Webhook sends data directly to your server. Zapier accepts the Webhook and routes it to other services visually — no server required.

Are incomplete responses sent via Webhook?

No. Webhooks fire only on Submit. Partial responses are not transmitted.

Integración

SurveyNinja Webhooks — Conecta Cualquier Sistema al Instante

Envía respuestas de encuestas directamente a tu servidor, CRM, base de datos o script personalizado como JSON vía HTTP POST. Sin intermediarios — datos en tiempo real en cada envío.

Conectar gratis Ver planes

Tiempo realentrega

JSONpayload

Cualquiersistema

Qué Puedes Hacer con Webhooks

Sincronización con CRM

Una nueva respuesta de encuesta crea o actualiza automáticamente un contacto en tu CRM con todos los campos mapeados

Almacenamiento en Base de Datos

Guarda respuestas directamente en tu propia base de datos — control total sobre la estructura y retención de datos

Alertas por Mensajería

Envía notificaciones instantáneas por Telegram, WhatsApp o Discord al equipo responsable en cada nueva respuesta

Disparadores de Código Personalizado

Activa tus propias funciones serverless, AWS Lambda o cualquier script backend con el payload completo de la respuesta

Alertas Basadas en Puntuación

Detecta puntuaciones bajas de NPS o CSAT y activa flujos de escalación — contacta al cliente antes de que se vaya

Cadenas Multi-sistema

Configura múltiples Webhooks para una encuesta — envía datos a CRM, base de datos y chatbot simultáneamente

Formato y Fiabilidad del Webhook

Payload JSON

Cada respuesta enviada como JSON estructurado: ID de respuesta, fecha/hora, todas las respuestas por nombre de pregunta, datos de contacto y parámetros UTM

HTTP POST

Solicitud HTTP POST estándar a tu endpoint. Funciona con cualquier servidor, framework o función serverless que acepte solicitudes POST

Entrega Instantánea

El Webhook se activa en segundos desde que el encuestado hace clic en Enviar — sin polling ni retrasos

Cabeceras Personalizadas

Añade tokens de autorización secretos como cabeceras personalizadas para asegurar tu endpoint y verificar que las solicitudes provienen de SurveyNinja

HTTPS Requerido

Tu endpoint debe usar HTTPS. Esto garantiza que los datos estén cifrados en tránsito y que tu integración sea segura

Reintentos Automáticos

Si tu servidor devuelve un error 5xx, SurveyNinja reintenta automáticamente con intervalos crecientes — no se pierde ningún dato

Configura en 3 Pasos

Crea tu Encuesta

Crea una encuesta en SurveyNinja — diseña preguntas, configura la lógica y personaliza el aspecto

Comenzar gratis

Añade la URL del Webhook

En configuración de encuesta → Integraciones → Webhooks. Pega la URL de tu endpoint y añade cabeceras de autorización opcionales

Recibe y Procesa

Envía una respuesta de prueba — tu servidor recibe el payload JSON. Procesa los datos según lo que tu sistema necesite

FAQ — Webhooks

¿Qué es un Webhook y para qué lo necesito?

Un Webhook es una notificación HTTP que SurveyNinja envía a tu servidor cuando se envía una encuesta. Recibes todos los datos de respuesta como JSON — sin polling ni exportación manual.

¿Necesito un desarrollador para configurar un Webhook?

En el lado de SurveyNinja, no — solo introduce la URL. El servidor receptor debe manejar solicitudes POST con JSON. Usa Zapier si no tienes backend.

¿Qué datos contiene la solicitud del Webhook?

JSON con ID de respuesta, fecha/hora, todas las respuestas por nombre de pregunta, datos de contacto, parámetros UTM, dirección IP y agente de usuario.

¿Qué sucede si mi servidor no está disponible?

SurveyNinja reintenta la solicitud con intervalos crecientes en errores 5xx. Los datos no se pierden.

¿Puedo configurar múltiples Webhooks para una encuesta?

Sí. Añade múltiples URLs — cada una recibe el payload completo de forma independiente, permitiéndote enviar a CRM, base de datos y chatbot simultáneamente.

¿Cómo aseguro mi endpoint de Webhook?

Añade un token secreto mediante cabeceras de autorización personalizadas en la configuración de SurveyNinja. Acepta conexiones solo por HTTPS.

¿En qué se diferencia un Webhook de Zapier?

El Webhook envía datos directamente a tu servidor. Zapier acepta el Webhook y lo enruta a otros servicios visualmente — sin necesidad de servidor.

¿Se envían respuestas incompletas mediante Webhook?

No. Los Webhooks se activan solo al enviar. Las respuestas parciales no se transmiten.