Webhooks de Rhombus

Esta página fue traducida automáticamente. Si encuentra errores o tiene sugerencias, contáctenos.

Los webhooks de Rhombus entregan notificaciones HTTP POST en tiempo real a tu servidor cuando ocurren eventos: apertura de puertas, alertas de cámaras, superación de umbrales de sensores, pulsaciones de botones y más. En lugar de sondear la API, tu aplicación recibe los eventos a medida que suceden.

Cómo funcionan los webhooks

Suscríbete a eventos

Usa la API de Rhombus para registrar una URL de webhook y especificar qué tipos de eventos deseas recibir.

Ocurren los eventos

Cuando ocurre un evento suscrito en tu entorno de Rhombus (por ejemplo, una puerta se abre a la fuerza), el sistema genera una carga útil del evento.

Recibe notificaciones

Rhombus envía una solicitud HTTP POST a tu URL registrada con los detalles del evento como una carga útil JSON.

Procesa y responde

Tu servidor procesa el evento y devuelve una respuesta 200 OK para confirmar la recepción.

Tipos de eventos

Rhombus admite notificaciones por webhook para una amplia variedad de eventos en toda tu infraestructura de seguridad:

Eventos de cámaras

Detección de movimiento, alertas de analítica, clips de video guardados, detecciones impulsadas por IA

Eventos de control de acceso

Apertura/cierre de puertas, entrada forzada, acceso concedido/denegado, escaneos de credenciales

Eventos de sensores

Alertas de umbral de temperatura, humedad y calidad del aire

Eventos de dispositivos

Pulsaciones de botones, cambios de estado en línea/fuera de línea de dispositivos

Ejemplo de carga útil de webhook

Cuando un evento dispara un webhook, Rhombus envía una solicitud POST a tu URL con una carga útil JSON:

{
  "uuid": "event-uuid-here",
  "orgUuid": "org-uuid-here",
  "ruleUuid": "rule-uuid-here",
  "triggeredTimestampMs": 1712678400000,
  "deviceEvents": [
    {
      "eventUuid": "device-event-uuid-here",
      "deviceUuid": "camera-uuid-here",
      "deviceType": "CAMERA",
      "locationUuid": "location-uuid-here",
      "timestampMs": 1712678400000,
      "activities": ["MOTION_HUMAN"]
    }
  ],
  "ruleTriggers": [
    {
      "type": "DEVICE_ACTIVITY_EVENT"
    }
  ]
}

Los webhooks se disparan mediante las reglas que configuras en Rhombus. Cada carga útil identifica la regla que se activó (ruleUuid), los disparadores que coincidieron (ruleTriggers) y los eventos de dispositivo subyacentes (deviceEvents). Los campos específicos presentes dependen del tipo de evento que la activó, así que configura un endpoint de webhook de prueba para inspeccionar la carga útil completa de tus reglas.

Administrar webhooks vía la API

Usa los endpoints de Webhook Integrations para administrar tus suscripciones de webhook:

Crea una suscripción de webhook con la URL de tu endpoint y filtros de eventos
Lista las suscripciones de webhook activas de tu organización
Actualiza las suscripciones existentes para cambiar URLs o tipos de eventos
Elimina las suscripciones que ya no necesites

Explora los endpoints de webhook en la Referencia de la API bajo la sección Webhook Integrations.

Guía de implementación

Para una guía completa sobre cómo configurar un listener de webhooks —incluyendo la recepción de webhooks en servidores detrás de firewalls mediante túneles SSH inversos— consulta la Implementación del listener de webhooks.

Alternativas sin código

Si prefieres un creador de flujos de trabajo visual en lugar de escribir manejadores de webhook personalizados, Rhombus se integra con:

Zapier — disparadores instantáneos para eventos de reglas, pulsaciones de botones, eventos de puertas y alertas de sensores
Make.com — disparadores de webhook con enrutamiento avanzado de datos
n8n — procesamiento de webhooks autoalojado con capacidades de agente de IA

Comenzar

Guías de implementación

Eventos en tiempo real

Cómo funcionan los webhooks

Tipos de eventos

Eventos de cámaras

Eventos de control de acceso

Eventos de sensores

Eventos de dispositivos

Ejemplo de carga útil de webhook

Administrar webhooks vía la API

Guía de implementación

Alternativas sin código

​Cómo funcionan los webhooks

​Tipos de eventos

Eventos de cámaras

Eventos de control de acceso

Eventos de sensores

Eventos de dispositivos

​Ejemplo de carga útil de webhook

​Administrar webhooks vía la API

​Guía de implementación

​Alternativas sin código

Cómo funcionan los webhooks

Tipos de eventos

Ejemplo de carga útil de webhook

Administrar webhooks vía la API

Guía de implementación

Alternativas sin código