Cómo Conectar Webhooks de Quiz
Los webhooks de quiz envían datos estructurados de envío desde AtomicQuiz a un endpoint seguro que controlas — CRM, middleware, herramientas de automatización o sistemas de scoring personalizados.
Configúralos en Configuración del quiz → Webhooks, luego publica para que visitantes en vivo disparen la configuración.
Antes de Empezar
Asegúrate de tener:
- Un quiz abierto en el editor de AtomicQuiz (guardado, con pasos y Flow listos).
- Un endpoint HTTPS listo para recibir payloads JSON (TLS requerido).
- Nombres de webhook que tu equipo reconocerá en logs.
- Acceso a Entrega de webhooks de quiz o logs de tu receptor para verificación.
Los webhooks corren en paralelo a Leads — los envíos aún se almacenan en Atomicat cuando Leads está habilitado.
Consulta Webhooks de quiz (referencia).
Paso 1: Abrir Configuración de Webhooks
- Abre el quiz en el editor.
- Haz clic en Configuración en el encabezado.
- Selecciona Webhooks en la barra lateral de configuración.
Paso 2: Agregar un Webhook
- Haz clic en Agregar webhook.
- Completa:
| Campo | Requisito |
|---|---|
| Nombre del webhook | Etiqueta interna corta (obligatorio). |
| URL del webhook | Debe comenzar con https:// (obligatorio). |
| Descripción | Notas opcionales del equipo. |
- Elige un disparador de envío (siguiente paso).
- Haz clic en Guardar en el panel de webhooks.
El producto valida nombre y URL y rechaza URLs que no sean HTTPS.
Paso 3: Elegir un Disparador de Envío
| Disparador | Cuándo se dispara |
|---|---|
| En cada etapa | Después de que el encuestado completa una etapa del quiz — útil para enriquecimiento progresivo. |
| Disparador basado en clic | Cuando ítems clicables seleccionados del quiz disparan la acción configurada — ingresa identificadores separados por coma como solicita el producto. |
Notas:
- Volver a En cada etapa limpia automáticamente las listas de identificadores basados en clic.
- Usa disparadores basados en clic cuando solo botones u opciones específicos deben disparar el webhook.
Encuentra identificadores en las etiquetas del editor de quiz mostradas para ítems clicables configurados para acciones.
Paso 4: Revisar el Payload de Ejemplo
La pantalla de configuración incluye una entrega de ejemplo para que tu equipo técnico prepare el receptor:
- Tipo de evento y metadatos del quiz
- Respuestas y estado de finalización
- Tiempo y contexto básico del visitante
Los nombres de campos de respuesta dependen de cómo nombraste preguntas y opciones en Builder.
Comparte el ejemplo con quien implemente el endpoint antes de salir en vivo.
Paso 5: Guardar y Publicar
- Guarda webhooks en configuración.
- El producto te recuerda publicar el quiz — los cambios de webhook se aplican al tráfico en vivo solo después de publicar.
- Haz clic en Publicar y confirma sitio/dominio/slug. Consulta Cómo publicar un quiz.
Los guardados de webhook en borrador no afectan visitantes en la URL ya publicada hasta que republices.
Paso 6: Probar en la URL Publicada
- Abre el enlace HTTPS en vivo del quiz en incógnito.
- Completa una ruta que deba disparar el webhook.
- Confirma que tu endpoint recibió el payload.
- Abre Entrega de webhooks de quiz en Atomicat para inspeccionar el estado de entrega cuando esté disponible.
Prueba cada tipo de disparador que habilitaste (finalización de etapa vs basado en clic).
Opcional: Claves API
Si tu destino valida remitentes confiables, configura claves vía Claves API de webhook y coincide la validación en tu servidor.
Solución de Problemas
| Problema | Qué intentar |
|---|---|
| URL rechazada | Usa solo HTTPS; verifica typos o espacios. |
| Sin entrega en quiz en vivo | Republica después de guardar webhook; prueba URL publicada, no solo Vista previa. |
| El disparador por clic nunca se dispara | Verifica que los IDs separados por coma coincidan con identificadores del editor. |
| El receptor devuelve 4xx/5xx | Compara payload con el ejemplo; verifica auth y validación de campos. |
| Eventos duplicados | El disparador por etapa se dispara por etapa — ajusta disparador o deduplica en el servidor. |
Resultado
Tu quiz envía datos de envío a tu endpoint HTTPS en los disparadores que configuraste — en vivo después de publicar y verificable a través de tu receptor y logs de entrega de Atomicat.
Documentación Relacionada
- Webhooks de quiz (referencia)
- Configuración del quiz
- Entrega de webhooks de quiz
- Claves API de webhook
- Visión general de Leads
FAQ
¿Puedo usar HTTP sin TLS?
No. Solo las URLs HTTPS pasan la validación.
¿Los webhooks reemplazan Leads?
No. Leads aún almacena envíos en Atomicat. Los webhooks son un canal de entrega adicional.
¿Debo republicar después de editar webhooks?
Sí. Los visitantes en vivo usan la configuración publicada.
¿De dónde vienen los identificadores basados en clic?
Usa etiquetas o identificadores mostrados en el editor de quiz para los ítems clicables que configuraste.
¿Puedo agregar múltiples webhooks?
Sí. Agrega filas separadas para cada destino con su propio nombre, URL y disparador.