Configurar webhook del dispositivo Web

Cuando configuras un webhook en el portal de CLUe, el dispositivo envía eventos en tiempo real al endpoint que especificas (un servidor externo) cuando ocurre un evento especificado. Usa esta feature para los siguientes casos de uso.

• Integración con un sistema de tiempo y asistencia

• Recibir eventos duplicados de detección facial

También puedes usarlo para varias integraciones en tiempo real basadas en eventos con sistemas.

Dispositivos compatibles

Dispositivo	Modelo	Versión de firmware compatible
BioStation 3	BS3-DB, BS3-APWB	bs3-all_v1.1.0_20250626 o posterior

Información

Los siguientes dispositivos compatibles con CLUe también admitirán webhooks.

• BioEntry W3, BioLite N2, X-Station 2, XPass 2

Ventajas clave

• Envía las notificaciones de eventos en tiempo real del dispositivo a un sistema externo.

• Integra sistemas externos fácilmente mediante webhooks.

• Admite casos de uso como la integración de tiempo y asistencia y la supervisión de eventos de seguridad.

Configuración de webhooks

1. Inicie sesión en el portal web de CLUe.

2. Ve al Place asignado al dispositivo donde quieres configurar el webhook.

3. Haz clic en Device en la barra lateral izquierda.

4. Selecciona el dispositivo de la lista de dispositivos donde quieres configurar el webhook.

   

5. Haz clic en la pestaña Webhook en la parte superior de la pantalla.

   

Información

Si la pestaña Webhook no aparece, revisa la versión de firmware de CLUe del dispositivo y actualízala a la versión de firmware compatible o posterior.

Método

Los webhooks usan el método POST de forma predeterminada.

Configuración de URL del endpoint

• Evento en línea: Un punto de conexión que envía llamadas webhook en tiempo real cuando ocurre un evento especificado mientras el dispositivo está en línea.

• Evento sin conexión: Un punto de conexión que envía una lista de eventos ocurridos mientras el dispositivo estaba sin conexión, después de que vuelve a estar en línea.

Configuración de encabezados

Define las claves requeridas o los valores de autenticación para el servidor del webhook en los encabezados de la solicitud. Para agregar un encabezado, haz clic en el botón .

Selecciona los eventos desencadenantes

Selecciona los eventos que desencadenan llamadas de webhook. Además de los eventos seleccionados de forma predeterminada, también puedes seleccionar eventos como Duplicated face fail from the device.

Configuración de campos del webhook

Para definir los datos que envía el dispositivo, configura los campos del webhook.

• Auto Fields: Indica el tipo de conjunto de datos que el dispositivo puede enviar.

• nonString: Se refiere a tipos de datos que no usan comillas (""), como Boolean e int.

Después de seleccionar los campos de datos necesarios, puedes obtener una vista previa del payload del webhook en el panel Preview.

Si también necesitas incluir valores fijos, agrégalos con Manual Fields. Estos valores se envían como valores fijos con el payload del webhook.

Ejecutar una llamada de prueba

Después de completar la configuración, puedes ejecutar Test Call.

Información

Una llamada de prueba te permite comprobar la estructura y el formato de los datos enviados directamente desde el navegador al endpoint configurado, no al dispositivo real.

Notas

Aunque el servidor todavía no esté listo, puedes probar webhooks con un servicio público de prueba de webhooks en internet. Por ejemplo, usa Webhook.site para verificar fácilmente las llamadas de webhook.