Puede configurar webhooks en su dispositivo a través del portal CLUe para recibir eventos de webhook en tiempo real desde el dispositivo cuando ocurren eventos específicos. Esto habilita casos de uso como: 

  •  Integración con sistemas de registro de asistencia 

  •  Detección de eventos de suplantación facial 

 y otras integraciones en tiempo real basadas en eventos con su sistema. 

Dispositivo compatible

  •  Dispositivo: BioStation 3 

  •  Modelo: BS3-DB, BS3-APWB 

  •  Los siguientes dispositivos compatibles con CLUe también están planificados para soportar webhooks: 

    •  W3, N2, XS2, XP2. 

Versión de firmware

  •  Nombre del archivo: bs3-all_v1.1.0_20250626 o superior 

Beneficios clave

  • Notificaciones de eventos en tiempo real desde el dispositivo

  • Integración sencilla con sistemas externos mediante webhooks

  • Soporta casos de uso como integración con asistencia de RR. HH. y monitoreo de eventos de seguridad

Guía de configuración de Webhooks

Ubicación: Place > Menú del dispositivo

Nota

Si la opción de configuración de webhooks no es visible, verifique la versión de firmware CLUe en su dispositivo y actualícela a la versión indicada arriba o a una versión superior.

1. Método

El webhook utiliza el método POST de forma predeterminada.

2. Configuración del endpoint

Mientras el dispositivo esté en línea, configure la URL del endpoint a la cual el dispositivo enviará llamadas webhook en tiempo real cuando ocurran los eventos configurados.

La configuración del endpoint para eventos offline permite enviar los eventos almacenados en formato de lista cuando el dispositivo vuelve a estar en línea.

3. Configuración de encabezados

Configure las claves requeridas o valores de autenticación en el encabezado de la solicitud según lo necesite su servidor de webhooks.

4. Especificar eventos disparadores

Seleccione los eventos que activarán las llamadas webhook.
Además de los eventos seleccionados por defecto, también puede elegir eventos como detección de suplantación facial.

5. Configurar campos del webhook

Configure los campos del webhook para definir qué datos serán enviados desde el dispositivo.

  • Campos automáticos: Representan los tipos de conjuntos de datos que el dispositivo puede enviar.

  • nonString: Se refiere a tipos de datos como Boolean e int, los cuales no están encerrados entre comillas ("").

Seleccione los campos de datos requeridos y verifíquelos usando la función de vista previa.

Si necesita incluir valores fijos adicionales, puede agregarlos usando Campos manuales. Estos valores se enviarán como valores fijos junto con la carga útil del webhook.

6. Ejecutar llamada de prueba

Una vez completada la configuración, puede ejecutar una llamada de prueba.

Nota: Esta llamada de prueba le permite verificar la estructura y el formato de los datos que se enviarán al endpoint configurado directamente desde el navegador, no desde el dispositivo físico.

Nota adicional

Las pruebas de webhooks pueden realizarse incluso si su servidor aún no está listo utilizando servicios públicos de prueba de webhooks disponibles en internet.

Por ejemplo, puede verificar fácilmente las llamadas webhook usando: