Configurar un endpoint y vincularlo a un grupo de cámaras

Objetivo

Crear un destino HTTP, probar su conectividad y asociarlo con un grupo que recibe eventos y utiliza paquetes de Perceiver.

Rol y requisitos

• Rol: administrador o integrador.
• URL HTTP/HTTPS del sistema receptor.
• Identificador de origen acordado.
• Token opcional, si el destino lo requiere.
• Paquetes de Perceiver disponibles, cuando el grupo deba utilizarlos.

Flujo ilustrado

El integrador prueba y guarda el destino, crea el grupo, lo vincula y comparte la URL de ingreso.

Pasos

1. Crea el endpoint de egreso

Abre Configuración → Endpoints de Egreso. Completa nombre, URL, origen y, si aplica, Secret / Token.

2. Prueba la conexión

Pulsa Probar conexión. Face Dashboard envía un POST de prueba. Si existe token, se envía como Bearer. Confirma que la respuesta sea satisfactoria antes de guardar.

3. Guarda y activa

Pulsa Guardar. Comprueba que el endpoint aparezca en la lista y que Notificaciones esté activo.

Si posteriormente cambias URL, origen o token, usa Editar y Actualizar.

4. Crea el grupo

Abre Endpoints. Introduce un nombre y una group_key. Puedes pulsar Generar para obtener una clave normalizada con sufijo aleatorio.

Selecciona los paquetes de Perceiver necesarios y el endpoint de egreso creado.

Formulario con nombre, group key, paquetes de Perceiver y selector del endpoint de egreso.

5. Guarda y revisa la tarjeta

Pulsa Crear grupo. La tarjeta muestra:

• URL de recepción /api/webhooks/<group_key>.
• Código de grupo.
• Paquetes asociados.
• Endpoint de egreso.
• Estado activo o inactivo.

Tarjetas de grupos con URL, clave, flujos, webhook asociado y acciones de estado.

6. Comparte la URL de ingreso

Pulsa la URL para copiarla y entrégala al sistema emisor junto con el método de autenticación acordado. No compartas secretos en la documentación ni en capturas.

7. Verifica el recorrido

Envía un evento de prueba desde el emisor. Confirma que:

1. El grupo está activo.
2. Face Dashboard recibe y procesa el evento.
3. Los paquetes seleccionados se aplican cuando corresponde.
4. El endpoint de egreso recibe la notificación esperada.

Resultado

El grupo queda disponible mediante una URL única y vinculado con el destino que recibirá sus notificaciones.

Errores comunes

Problema	Qué hacer
La prueba de conexión falla	Revisa URL, red, certificado y token.
No permite guardar el endpoint	Completa nombre, URL y origen.
La group key ya existe	Genera otra clave.
No aparecen paquetes	Comprueba la conexión con Perceiver.
El grupo no entrega eventos	Verifica que esté activo y que tenga el endpoint correcto.
No se puede eliminar el grupo	El servidor impide borrarlo si ya tiene eventos asociados.

Consulta Endpoints y Configuración.