1. Base de Conocimientos
  2. Configurar y usar los módulos y las funcionalidades de Eventtia

Cómo configurar un Webhook

En este artículo, aprenderás qué son los webhooks y cómo configurarlos para recibir información en tiempo real desde Eventtia.

¿Qué es un Webhook?

Un webhook es un mecanismo que permite que una aplicación envíe actualizaciones en tiempo real a otro sistema cada vez que ocurre un evento específico. A diferencia de las API tradicionales, que requieren que una aplicación verifique repetidamente si hay cambios (un proceso conocido como "polling"), un webhook transmite instantáneamente los datos a una URL preconfigurada tan pronto como ocurre el evento.

Por ejemplo, cuando configuras un webhook para que te notifique sobre el registro de un nuevo asistente, el software de Eventtia enviará de inmediato una solicitud HTTP POST que contiene los detalles del nuevo asistente directamente a la URL que hayas especificado.

¿Cómo configurar un Webhook?

Para recibir notificaciones por webhook, necesitas proporcionar una URL de destino donde tu sistema pueda escuchar y procesar los datos de llegada.

Así es como se hace:

  1. Ve al módulo de Configuración de tu evento y haz clic en la pestaña ‘Webhooks’.

  2. Luego, marca ‘Activar Webhooks’ y haz clic en ‘Crear’.

Luego continúa con los siguientes pasos:

Crear una "Listener URL"

  • Necesitas crear un endpoint en tu servidor o aplicación que pueda aceptar solicitudes HTTP POST. Este endpoint debe:
    • Ser accesible públicamente (por ejemplo, https://tuservidor.com/webhooks/mi-evento)

    • Aceptar solicitudes POST

    • Analizar el cuerpo de la solicitud (usualmente en formato JSON)

    • (Opcional) Verificar un token o firma por razones de seguridad

Probar tu URL

  • Antes de usarla en producción, recomendamos probar la URL con herramientas como:
  • Esto asegura que tu endpoint está recibiendo los datos correctamente.

Configurar el Webhook en Eventtia

  • Una vez que tu "listener URL" esté lista y sea accesible públicamente, pégala en la sección de URL del Webhook de tu evento.

  • Desde allí, podrás seleccionar los eventos específicos que deseas, tales como:
    • attendee_created – cuando se crea un nuevo asistente

    • attendee_updated – cuando se actualiza la información de un asistente

    • event_created – cuando se crea un evento

    • event_updated – cuando se actualiza un evento

    • payment_created – cuando se realiza un pago

Ahora tu Webhook está completamente configurado y listo para funcionar correctamente.

 

Prácticas de seguridad recomendadas

Asegúrate de seguir las siguientes recomendaciones por razones de seguridad:

  • Utiliza siempre HTTPS
    Esto asegura que los datos enviados a tu endpoint estén cifrados y sean seguros.
  • Valida los datos que llegan a tu servidor
    Asegúrate de que los datos que recibes coincidan con el formato esperado.
    También puedes verificar que la solicitud sea auténtica comprobando un secret  token o firma.