Introducción a los webhooks
Un webhook es un método para recibir notificaciones en tiempo real cuando se activa un evento. Los datos asociados al evento activado se envían a la URL del webhook especificado.
Aiwifi puede notificar eventos a tu aplicación mediante webhooks. Cada webhook está firmado criptográficamente para evitar su manipulación. Al recibir un webhook, puedes validarlo para asegurarte de que proviene de Aiwifi y corresponde al evento al que te suscribiste.
Cómo funcionan los webhooks
Antes de comenzar a utilizar los webhooks, es importante comprender su propósito.
Supongamos que desea rastrear la información que recibe de una conexión de invitado en su marca. Una opción sería verificar la presencia del invitado en su aplicación periódicamente. Sin embargo, este método es repetitivo y podría no ofrecer resultados en tiempo real.
En su lugar, se puede configurar un webhook para que detecte un evento de conexión de invitado. Cuando un invitado se conecte a su portal cautivo, recibirá una notificación inmediata.
Terminología de webhooks
Antes de configurar un webhook, es esencial comprender la terminología común utilizada en un sistema de webhook típico.
- URL del webhook: La URL donde desea recibir los datos del webhook (payload). Esta URL debe cumplir los siguientes criterios:
- Debe ser una URL HTTPS.
- Debe ser públicamente accesible.
- Evento: La acción realizada por los invitados en su portal cautivo. Admitimos notificaciones (webhooks) para varios tipos de eventos, como conexiones de invitados, intereses seleccionados y respuestas a campañas de encuestas.
- Payload: Los datos relacionados con el evento que enviaremos a tu URL. Generalmente, la carga útil enviada a la URL de tu webhook está en formato JSON y puedes utilizarla según tu caso de uso empresarial.