Webhooks: conectar Quizesia con tus herramientas

Un webhook hace que Quizesia avise a otra herramienta cada vez que alguien completa tu quiz o encuesta. Es la forma de conectarlo con Zapier, Make, n8n o tu propio sistema, sin esperar a que exista una integración nativa.

Se configura en el editor de tu quiz → pestaña Integraciones → URL del webhook.

Cómo probarlo antes de publicar

1. Consigue una URL de destino

• Zapier: crea un Zap con el disparador Webhooks by Zapier → Catch Hook. Te dará una URL única.
• Make: añade un módulo Webhooks → Custom webhook y copia su dirección.
• Solo para probar: entra en webhook.site. Te asigna una URL única nada más abrirla y te enseña en pantalla todo lo que recibe.

El error más común: copiar la dirección de la portada (https://webhook.site) en vez de la URL única que te asigna, que lleva un identificador largo. La portada no acepta envíos y verás la entrega como fallida con el error HTTP 405.

2. Usa el botón “Enviar prueba”

En la misma pestaña de Integraciones, junto al campo, tienes Enviar prueba. Manda un envío de ejemplo a tu URL sin necesidad de completar el quiz, y te dice ahí mismo si el destino respondió bien. Es la forma más rápida de confirmar que la URL es correcta antes de publicar.

3. Complétalo tú una vez

Abre tu quiz publicado, respóndelo como lo haría un visitante y comprueba que el envío aparece en tu herramienta. Así verificas el flujo real, con tus preguntas y tus respuestas.

Qué recibes exactamente

Un POST con este contenido en JSON:

{
  "event": "lead.created",
  "quiz": {
    "id": "…",
    "title": "¿Cuál es tu estilo de liderazgo?",
    "slug": "estilo-de-liderazgo",
    "type": "quiz"
  },
  "lead": {
    "id": "…",
    "name": "Ana García",
    "email": "ana@ejemplo.com",
    "score": 9,
    "result": { "id": "…", "title": "El Líder Visionario" },
    "created_at": "2026-09-06T10:31:00.000Z",
    "utm": {
      "utm_source": "instagram",
      "utm_medium": "paid",
      "utm_campaign": "lanzamiento-septiembre"
    }
  },
  "answers": [
    {
      "question_id": "…",
      "question_text": "¿Cómo defines el éxito de un proyecto?",
      "question_type": "single_choice",
      "answer": "Que el equipo haya crecido en el proceso"
    }
  ]
}

Notas útiles al montar tu automatización:

• email puede venir vacío en encuestas que permiten respuesta anónima. name también es opcional.
• score y result son null en las encuestas, que no puntúan.
• utm solo trae valores si el enlace del quiz llevaba parámetros de campaña. Te sirve para saber de qué anuncio vino cada lead.
• answer llega ya resuelto a texto legible, no como identificadores internos.

Cabecera de identificación

Cada envío incluye la cabecera X-Quizesia-Delivery-Id, con un identificador único de esa entrega. Si un envío se reintenta, el identificador es el mismo. Si tu sistema podría duplicar registros al recibir el mismo lead dos veces, guarda ese valor y descarta los repetidos.

Qué pasa si tu destino falla

No perdemos el lead. Siempre queda guardado en Quizesia y puedes exportarlo desde la página de respuestas, aunque el envío no llegue.

Fallos temporales → reintentamos

Si tu servidor no responde, tarda más de 8 segundos o devuelve un error de tipo “vuelve más tarde” (códigos 500, 502, 503, 429…), lo reintentamos automáticamente:

Son 5 envíos en total contando el primero, repartidos en unas 2 horas y media. Si tu herramienta tuvo una caída breve, lo normal es que el lead acabe llegando sin que hagas nada.

Fallos de configuración → no reintentamos

Si la respuesta indica que el problema no se va a arreglar solo (URL inexistente, credenciales rechazadas, método no permitido), lo marcamos como fallido al primer intento. Insistir no serviría de nada y solo golpearía tu servidor.

Cómo te enteras

• Un aviso en la página de respuestas del quiz, indicando cuántas entregas no llegaron.
• Un email, como mucho uno por quiz cada 24 horas para no llenarte la bandeja.

Errores frecuentes

Después de corregir la URL, los leads que ya fallaron no se reenvían automáticamente. Puedes exportarlos a CSV desde la página de respuestas e importarlos a mano.

Preguntas frecuentes

¿Ralentiza el quiz?

No. El envío ocurre por detrás, después de guardar la respuesta. Aunque tu destino esté caído, quien responde ve su resultado al instante.

¿Puedo tener varios webhooks en un mismo quiz?

Uno por quiz. Si necesitas avisar a varios sitios, usa Zapier o Make como punto de entrada y reparte desde ahí.

¿Y si prefiero una integración directa?

Mailchimp y ActiveCampaign están disponibles como integraciones nativas en la misma pestaña, sin necesidad de webhook.

¿Se envía algo al probar con “Enviar prueba”?

Sí, un envío de ejemplo con datos ficticios. No crea ningún lead en Quizesia ni afecta a tus estadísticas. Eso sí: tiene el mismo formato que un envío real, así que si tu automatización ya está activa creará un registro de prueba en tu herramienta. Lo reconocerás porque el email es prueba@quizesia.com y el identificador del lead es test-lead-id.