Los webhooks permiten que Evalandgo notifique automáticamente a sus sistemas externos en tiempo real en cada etapa del viaje de un respondente. Es la forma ideal de conectar sus cuestionarios a sus herramientas (Zapier, Make, un CRM, una aplicación personalizada) sin intervención manual.

Funcionalidad disponible exclusivamente para clientes con suscripción PRO+ o PRO+ Equipo.

Crear y configurar un webhook en 5 pasos

1. Vaya al módulo Conectador en su cuenta (menú principal → Conectador).
2. Haga clic en la pestaña Webhooks.
3. Haga clic en Crear un webhook.
4. Rellene la siguiente información:
   • Nombre del webhook: un identificador legible (máximo 50 caracteres)
   • URL de devolución de llamada: la dirección donde Evalandgo enviará las notificaciones (HTTPS obligatorio, máximo 2 000 caracteres)
   • Cuestionario destino: vincula el webhook a un cuestionario específico, o déjalo en blanco para un webhook global (se activa en todos tus cuestionarios)
   • Eventos a escuchar: marca las etapas del viaje del respondente que deseas seguir
5. Haz clic en Guardar.

Su webhook ahora está activo y se activará automáticamente en los eventos que seleccionó.

Los tres eventos disponibles

Un webhook se activa en uno de estos tres eventos en el viaje de un respondente:

• started: el respondente ha hecho clic en el enlace del cuestionario y está accediendo a la primera página.
• in_progress: el respondente está progresando en el cuestionario (en cada cambio de página).
• finished: el respondente ha enviado sus respuestas y el cuestionario está completo.

Puede escuchar los tres eventos simultáneamente o seleccionar solo los que necesite, dependiendo de sus requisitos de integración.

El contenido de la notificación del webhook

Con cada evento, Evalandgo envía una solicitud POST en formato JSON a su URL de devolución de llamada. La carga útil contiene:

• El identificador del respondente e historial de respuestas
• Información de contacto (correo electrónico, nombre, apellido) si está disponible
• El cuestionario afectado (ID y título)
• El detalle de cada respuesta ingresada (texto, opciones, puntuación, etc.)
• Puntuaciones o cálculos generados por el cuestionario
• Para archivos adjuntos: un enlace de descarga directo que es válido y está listo para usar, inmediatamente utilizable por su herramienta de terceros sin autenticación adicional

Esta notificación le permite procesar respuestas en tiempo real en su sistema de información (agregar un contacto a un CRM, activar una automatización, crear un registro, etc.).

Reglas esenciales para la entrega de webhooks

Antes de conectar sus cuestionarios, conozca las garantías y limitaciones de los webhooks de Evalandgo:

Envío único, sin reintentos: cada notificación se envía exactamente una vez, en el momento del evento. Si la entrega falla (servidor no disponible, demasiado lento, error HTTP), la notificación se pierde permanentemente. El umbral de tiempo de espera es de 5 segundos.

No confíe en los webhooks como su única fuente de verdad: planifique recuperaciones periódicas a través de la API de Evalandgo para recuperar cualquier respuesta que se pierda debido a interrupciones de red o indisponibilidad temporal.

Las llamadas no están firmadas (HMAC): trata tu URL de devolución de llamada como un secreto. No utilices una URL adivinable; complétala con un token o clave privada en tu aplicación si es posible.

El interruptor activo/inactivo no pausa los envíos: no existe un mecanismo de pausa. Para detener realmente un webhook, elimínalo o elimina todos los eventos que se están escuchando.

Bueno saberlo: Los errores de envío (tiempo de espera agotado, errores HTTP 4xx/5xx, excepciones de red) se registran en el servidor de Evalandgo pero no se muestran en su interfaz. Si sospecha un problema, póngase en contacto con nuestro equipo de soporte con la fecha y hora aproximadas del incidente.

Casos de uso comunes

Agregar automáticamente un contacto a su CRM: configure un webhook global en el evento finished apuntando a su CRM o a Zapier/Make. Cuando se envía el cuestionario, Evalandgo envía las respuestas (correo electrónico, nombre, etc.) al CRM, donde una regla agrega el nuevo contacto.

Activar una automatización según la respuesta: a través de Zapier o Make, escuche el evento finished y enrute a diferentes acciones según el contenido de la respuesta (por ejemplo: puntuación alta → enviar al equipo de ventas, puntuación baja → enviar a soporte).

Registrar respuestas en una base de datos: cree un webhook apuntando a su aplicación personalizada. Con cada evento, Evalandgo envía los detalles de la respuesta, que su aplicación escribe en la base de datos en tiempo real.

Preguntas frecuentes

¿Por qué no se activa mi webhook? Verifique que (1) su plan sea PRO+ o PRO+ Equipo, (2) el cuestionario esté activo y accesible, (3) la URL sea HTTPS, (4) el evento esté marcado en la configuración de su webhook.

¿Hay reintentos si falla el envío? No. El webhook nunca se reenvía automáticamente. Si falla el envío, la notificación se pierde permanentemente.

¿Puedo crear un webhook global para todos mis cuestionarios? Sí. En lugar de seleccionar un cuestionario específico, deje ese campo en blanco. El webhook se activará en todos los cuestionarios de su cuenta. (Nota: a través de la API REST, un cuestionario específico sigue siendo obligatorio).

¿Puedo enrutar mis respuestas a una herramienta de automatización de marketing? Sí. Evalandgo envía el evento y los detalles de la respuesta a su URL. Luego depende de su herramienta (Zapier, Make o su solución) aplicar su lógica empresarial (segmentación, enriquecimiento, decisión, acción).

Bueno saberlo: Los webhooks son especialmente potentes cuando se combinan con la API de Evalandgo. Puede enriquecer datos en tiempo real consultando la API para obtener información adicional (resultados detallados, puntuación avanzada, contactos enriquecidos), mientras sincroniza a través del webhook.

Artículos relacionados

• ¿Cómo utilizo la API de Evalandgo?
• Seguridad de integraciones

¿Necesita ayuda?

Los webhooks son una funcionalidad técnica. Póngase en contacto con nuestro equipo al +33 4 67 17 96 77 para validar su configuración, resolver un problema o discutir una integración compleja.