¿Cómo usar los Webhooks?

¿Qué son los Webhooks?

Los Webhooks son un sistema de notificaciones automáticas en tiempo real que conecta a Ecopass con tus propias herramientas. En lugar de revisar manualmente si hubo ventas, los Webhooks "empujan" la información hacia tu sistema en el momento exacto en que ocurre una acción.

En palabras simples, es como si Ecopass te enviara un mensaje instantáneo cada vez que alguien compra una entrada o se registra, permitiendo que tus otros sistemas (como un CRM, una hoja de cálculo o un sistema de accesos propio) se actualicen solos y al instante.

¿Cómo configurar los Webhooks en la plataforma?

Para configurarlos, el proceso es bastante rápido y se realiza directamente desde tu panel:

Inicia sesión en tu cuenta y selecciona tu evento.
Dirígete a las opciones de tu perfil.
Ingresa a la sección Webhooks.

Selecciona la opción "Crear webhook"

Pega la URL a la cual se enviarán los datos (tu sistema) y también puedes agregar una URL de notificación de error.
Configura una autorización secreta para asegurar la conexión.
Marca en la lista proporcionada qué datos específicos deseas capturar.
Finalmente, guarda en el botón "Crear Webhook".

¿Qué datos específicos se pueden capturar mediante los Webhooks?

Al momento de crear un Webhook en tu perfil se desplegará una "listado de eventos que deseas capturar" donde podrás elegir qué acciones enviarán la información a tu sistema. Los eventos específicos que puedes capturar y que activan estas notificaciones automáticas son los siguientes:

→ Gestión de Órdenes de Compra:

Orden creada (OrderCreated): Informa en el instante en que un usuario inicia el proceso y el sistema genera una nueva orden de compra.
Orden pagada (OrderPaid): Te avisa cuando la transacción de una orden se ha completado y pagado con éxito.
Orden rechazada (OrderRejected): Notifica si el intento de pago de una orden no se concretó o fue rechazado por el sistema de pago.

→ Gestión de Tickets / Entradas:

Ticket creado (TicketCreated): Notifica en el momento exacto en que se genera una nueva entrada para un asistente, ya sea por una compra exitosa o por una asignación directa.
Ticket activado (TicketActivated): Se dispara cuando un asistente completa el formulario con sus datos para habilitar su entrada (un paso muy común en las entradas de cortesía o eventos nominales).
Ticket validado o acreditado en el evento (TicketValidated): Envía la información en tiempo real cuando el código QR o el RUT del asistente es escaneado y validado exitosamente en la puerta o control de acceso de tu evento.
Ticket transferido (TicketTransferred): Te avisa cuando una entrada ha sido transferida de un usuario a otro.
Ticket actualizado (TicketUpdated): Informa cuando se realiza alguna modificación en los datos o en el estado de una entrada ya emitida para un asistente.

→ Gestión de Eventos y Categorías de Entradas:

Evento creado (EventCreated): Envía una notificación automática cuando generas un nuevo evento dentro de tu cuenta.
Evento actualizado (EventUpdated): Te avisa cuando realizas cualquier modificación en la configuración general, descripción o datos de un evento ya existente.
Categoría de ticket de evento creada (EventTicketCreated): Dispara una alerta cuando creas una nueva categoría de entrada o un nuevo tipo de ticket disponible para la venta o registro en tu evento.
Categoría de ticket de evento actualizada (EventTicketUpdated): Informa cuando modificas los detalles, el precio o el stock de una categoría de ticket ya existente.

→ Transmisiones (Streamings):

Usuario conectado a la transmisión (StreamingConnected): Dispara una alerta en el momento exacto en que un usuario ingresa y se une a la sala de transmisión de tu evento online o híbrido.
Usuario desconectado de la transmisión (StreamingDisconnected): Te informa cuando un usuario abandona o se desconecta de la sala de transmisión.

Preguntas frecuentes:

¿Quien hace la configuración de los Webhooks?

Para realizar la configuración de los webhooks forma exitosa, necesitarás el apoyo de un profesional con conocimientos técnicos en programación e integración de software. El perfil especializado o miembro de tu empresa ideal para llevar a cabo esta tarea es un Desarrollador de Software (Programador), un Ingeniero de Integraciones o un miembro de tu Equipo Técnico / Departamento de TI (Tecnología de la Información).

¿Por qué necesitas a este tipo de profesional?

Aunque configurar la URL de un Webhook es un proceso bastante sencillo que puedes hacer tú mismo con unos pocos clicks desde la configuración de tu perfil en Ecopass, la "conexión" real entre la plataforma y tus sistemas internos (como tu CRM) requiere escribir y configurar código.