Webhook (HTTP callback)

Qué es un webhook

Un webhook es una solicitud HTTP automática que un servicio envía a la URL que elijas cuando ocurre un evento. En las encuestas, el evento suele ser una respuesta nueva, y la solicitud lleva las respuestas a tu CRM, a tu backend o a una herramienta de automatización.

La diferencia con una API es la dirección. Con una API, tu sistema pide los datos. Con un webhook, los datos llegan solos, así que no tienes que revisar cada cierto tiempo si hay respuestas nuevas.

Cómo funciona en SurveyNinja

• Los webhooks están disponibles en el plan Básico y superiores. Se agregan en la pestaña Integraciones de la encuesta.
• Cada respuesta completa llega a tu URL de callback como solicitud POST, PUT, PATCH o GET con cuerpo JSON.
• Puedes agregar encabezados propios, por ejemplo un token de autorización, elegir qué preguntas enviar y darles nombres cortos.
• En los planes que guardan respuestas incompletas (Estándar y superiores), el webhook también puede enviarlas cada 1, 6, 12 o 24 horas.
• El registro muestra cada envío con la respuesta de tu servidor. Desde ahí mandas una solicitud de prueba y reenvías las fallidas.

Configuración y formato de la solicitud: Webhooks. Si los datos dejan de llegar, consulta ¿Por qué las respuestas no llegan a Google Sheets, webhooks o Telegram?

Errores comunes

• Un webhook nuevo se guarda desactivado. Activa su interruptor o no se enviará nada.
• La URL debe ser pública. Las direcciones locales e internas se rechazan.
• Tu servidor debe responder con un código 2xx en menos de 30 segundos. Devuelve primero el código y procesa los datos después.
• Tras 20 fallos seguidos, o 5 seguidos con respuesta 4xx, SurveyNinja desactiva el webhook. Corrige el receptor, vuelve a activarlo y reenvía desde el registro las solicitudes fallidas.