Skip to main content
Esta página fue traducida automáticamente. Si encuentra errores o tiene sugerencias, contáctenos.
El flujo de eventos de WebSocket de Rhombus entrega notificaciones en tiempo real sobre todo lo que ocurre en tu organización. Esta guía cubre la estructura de los eventos, los tipos de entidad disponibles y los patrones para filtrar y procesar eventos.

Tópico de eventos

Todos los eventos de la organización se publican en un único tópico:
Cada operación de creación, actualización y eliminación en tu organización de Rhombus emite un evento en este tópico.

Estructura de la carga útil del evento

Cada frame MESSAGE contiene un cuerpo JSON con los siguientes campos:

Campos principales

El detalle específico del evento (por ejemplo, los pormenores de una alerta de política) reside dentro del objeto update. Su forma depende del tipo de entity, así que lee las claves presentes en update en lugar de asumir una estructura fija.

Tipos de cambio

Tipos de entidad

El campo entity indica qué tipo de objeto cambió. Los tipos de entidad comunes incluyen:
Los tipos de entidad disponibles dependen de los dispositivos y las políticas configurados en tu organización. Suscríbete a /topic/change/{orgUuid} y registra el campo entity de cada evento para descubrir todos los tipos de evento disponibles.
Comienza filtrando los eventos POLICY_ALERT, que son el caso de uso más común. Todos los tipos de entidad se entregan en el mismo tópico /topic/change/{orgUuid} — no hay un filtro de entidad del lado del servidor en la suscripción, así que filtra del lado del cliente inspeccionando el campo entity en tu manejador de mensajes e ignorando los tipos que no necesites.

Inspección de alertas de política

Cuando un evento tiene entity: "POLICY_ALERT", el detalle específico de la alerta se transporta dentro del objeto update. La forma de update depende del tipo de entidad y no es un esquema público fijo, así que inspecciona las claves presentes en cada alerta en lugar de asumir campos particulares:
Para conocer la estructura de update de los tipos de entidad que te interesan, conéctate, suscríbete y registra algunos eventos reales. Las claves presentes dependen del tipo de entidad y pueden evolucionar, así que trata update de forma defensiva.

Filtrado de eventos

Por tipo de entidad

Filtra tipos de evento específicos para reducir el ruido:

Por tipo de cambio

Reacciona de forma diferente según si un evento fue creado, actualizado o eliminado:

Por dispositivo

Filtra los eventos de una cámara o sensor específico:

Por entidad y tipo de cambio

Reacciona a tipos específicos de eventos de seguridad combinando los campos entity y type:

Enriquecimiento de eventos con datos de la API REST

Los eventos de WebSocket contienen datos mínimos por eficiencia. Usa la API REST para obtener detalles adicionales cuando sea necesario:

Obtener el nombre de la cámara a partir del UUID del dispositivo

Obtener detalles de la alerta

Almacena en caché los nombres de las cámaras localmente para evitar llamadas excesivas a la API REST. Los nombres de las cámaras cambian con poca frecuencia, así que una caché con un TTL de 5 minutos funciona bien.

Formatos de salida

Visualización de alerta con formato

Salida JSON sin procesar

Para canalizar a otras herramientas o sistemas de registro:

Patrones de integración

Relé de webhook

Reenvía los eventos de Rhombus a tu propio endpoint de webhook:

Notificaciones de Slack

Envía alertas de alta prioridad a un canal de Slack:

Registro en base de datos

Persiste los eventos para análisis histórico:
Última modificación el 8 de julio de 2026