Integra con n8n

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

Automatiza tu plataforma de seguridad Rhombus con n8n, una herramienta de automatización de flujos de trabajo autoalojable. El nodo oficial de la comunidad de Rhombus te da acceso nativo a cámaras, puertas, eventos, usuarios y más — sin necesidad de configurar HTTP en bruto.

Nodo oficial de la comunidad: @rhombussystems/n8n-nodes-client proporciona 6 tipos de recursos con 19 operaciones, todas validadas contra la especificación OpenAPI de Rhombus.

Instala el nodo de Rhombus

Abre la configuración de n8n

En tu instancia de n8n, ve a Settings > Community Nodes.

Instala el paquete

Ingresa el nombre del paquete y haz clic en Install:

@rhombussystems/n8n-nodes-client

Añade tu API key

Cuando agregas un nodo de Rhombus a un flujo de trabajo por primera vez, n8n te pedirá crear credenciales:

Ve a Rhombus Console y genera una API key
En n8n, crea una nueva credencial Rhombus API
Pega tu API key y guarda

El nodo maneja automáticamente los headers x-auth-apikey y x-auth-scheme.

Operaciones disponibles

El nodo de Rhombus proporciona 19 operaciones a través de 6 tipos de recursos:

Cámaras

Operación	Descripción
Get	Obtiene el estado completo de una sola cámara
Get Many	Lista todas las cámaras de la organización
Create Clip	Crea un clip de video desde una cámara
Get Frame	Obtiene la URL de imagen de un fotograma exacto
Update	Actualiza el nombre, descripción o ubicación de una cámara

Puertas

Operación	Descripción
Get Many	Lista todas las puertas con control de acceso
Unlock	Desbloquea temporalmente una puerta
Get Events	Obtiene el historial de eventos de acceso de una puerta

Eventos

Operación	Descripción
Get Alerts	Obtiene alertas de políticas con filtros de tiempo y dispositivo
Get Many	Obtiene una lista de clips de video guardados

Usuarios

Operación	Descripción
Create	Crea un nuevo usuario con email y nombre
Get Many	Lista todos los usuarios de la organización
Update	Actualiza el nombre, los permisos o la configuración de MFA del usuario

Organización

Operación	Descripción
Get	Obtiene información de la organización
Get Locations	Lista las ubicaciones de la organización
Update	Actualiza el nombre, los contactos o la configuración de la organización

Webhooks

Operación	Descripción
Get	Obtiene la configuración de la integración de webhook
Create/Update	Crea o actualiza la configuración del webhook (URL, secret, habilitado)
Delete	Elimina la integración de webhook

Flujos de trabajo de ejemplo

Reporte diario de alertas de seguridad

Genera un resumen diario de alertas de seguridad y envíalo a tu equipo.

Schedule Trigger (daily at 8 AM)
  ↓
Rhombus Node → Event → Get Alerts (last 24 hours)
  ↓
Code Node → Format alert summary
  ↓
Email Node → Send to security team

Desbloquear puerta en evento de calendario

Desbloquea automáticamente la puerta de una sala de conferencias antes de una reunión.

Google Calendar Trigger (meeting starts in 5 minutes)
  ↓
Rhombus Node → Door → Unlock (conference room door)

Clip de cámara al recibir alerta

Guarda automáticamente un clip cuando se dispara una alerta de política.

Schedule Trigger (every 5 minutes)
  ↓
Rhombus Node → Event → Get Alerts (last 5 minutes)
  ↓
Rhombus Node → Camera → Create Clip (from alert device, 60 seconds)

Automatización de onboarding de usuarios

Crea cuentas de Rhombus cuando los empleados se incorporan desde tu sistema de RR. HH.

Webhook Trigger (from HR system)
  ↓
Rhombus Node → User → Create (email, name from payload)

Flujos de trabajo con agentes de IA

Las capacidades de agentes de IA de n8n te permiten construir flujos de trabajo de seguridad inteligentes combinando datos de Rhombus con LLMs.

Asistente de seguridad conversacional

Crea un bot de Slack que pueda consultar datos de Rhombus:

Slack Trigger → "Show me camera status"
  ↓
AI Agent with Rhombus tools:
  ├─→ Camera → Get Many (list cameras)
  ├─→ Event → Get Alerts (recent alerts)
  └─→ Camera → Create Clip (save footage)
  ↓
AI Response → Slack

Detección de anomalías

Detecta patrones de acceso inusuales y alerta al equipo de seguridad:

Schedule Trigger (every 15 minutes)
  ↓
Rhombus Node → Door → Get Events (last 15 minutes)
  ↓
AI Agent → Analyze patterns for anomalies
  ↓
IF anomaly detected → Create incident + alert team

Avanzado: Fallback con HTTP Request

Para operaciones que aún no estén cubiertas por el nodo de la comunidad, usa el nodo HTTP Request de n8n con autenticación manual:

{
  "method": "POST",
  "url": "https://api2.rhombussystems.com/api/camera/getMinimalCameraStateList",
  "authentication": "predefinedCredentialType",
  "sendHeaders": true,
  "headerParameters": {
    "parameters": [
      {
        "name": "x-auth-apikey",
        "value": "={{$credentials.rhombusApiKey}}"
      },
      {
        "name": "x-auth-scheme",
        "value": "api-token"
      }
    ]
  }
}

La API de Rhombus tiene más de 800 endpoints. El nodo de la comunidad cubre las operaciones más comunes, pero puedes acceder a cualquier endpoint mediante nodos HTTP Request. Consulta la referencia de la API para ver la lista completa de endpoints.

Despliega n8n

Docker (lo más rápido)
Docker Compose (Producción)
n8n Cloud

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Accede en http://localhost:5678

version: '3.8'
services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=n8n.yourdomain.com
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://n8n.yourdomain.com/
    volumes:
      - ~/.n8n:/home/node/.n8n

La autenticación se configura desde la interfaz de n8n en el primer arranque. Consulta la documentación de despliegue de n8n para ver el endurecimiento de producción.

Compatibilidad

Requisito	Versión
n8n	1.60.0 o posterior
Node.js	22+ (para autoalojamiento)
API de Rhombus	Todas las operaciones usan `api2.rhombussystems.com`

Para los límites de tasa de la API de Rhombus, consulta Rate Limits.

Solución de problemas

El nodo no aparece tras la instalación

Reinicia tu instancia de n8n después de instalar el nodo de la comunidad. Si usas Docker, reinicia el contenedor.

Errores de autenticación

Verifica que tu API key esté activa en Rhombus Console. Asegúrate de que la credencial en n8n tenga el valor correcto de la key.

Errores de límite de tasa

Añade nodos Wait entre operaciones de Rhombus dentro de bucles para distribuir las solicitudes en el tiempo. Consulta Rate Limits para los límites actuales y orientación sobre reintentos.

El webhook no recibe eventos

Verifica que tu instancia de n8n sea accesible públicamente. Confirma que la URL del webhook en Rhombus Console coincida con tu endpoint de webhook de n8n.

Recursos

Paquete npm

Nodo oficial de la comunidad de Rhombus

Repositorio en GitHub

Código fuente y seguimiento de incidencias

Documentación de n8n

Documentación y tutoriales de la plataforma

Comunidad de n8n

Plantillas y soporte de la comunidad

Sin código / Bajo código

IA y LLMs

Instala el nodo de Rhombus

Operaciones disponibles

Cámaras

Puertas

Eventos

Usuarios

Organización

Webhooks

Flujos de trabajo de ejemplo

Reporte diario de alertas de seguridad

Desbloquear puerta en evento de calendario

Clip de cámara al recibir alerta

Automatización de onboarding de usuarios

Flujos de trabajo con agentes de IA

Asistente de seguridad conversacional

Detección de anomalías

Avanzado: Fallback con HTTP Request

Despliega n8n

Compatibilidad

Solución de problemas

Recursos

Paquete npm

Repositorio en GitHub

Documentación de n8n

Comunidad de n8n

Sin código / Bajo código

IA y LLMs

Documentation Index

​Instala el nodo de Rhombus

​Operaciones disponibles

​Cámaras

​Puertas

​Eventos

​Usuarios

​Organización

​Webhooks

​Flujos de trabajo de ejemplo

​Reporte diario de alertas de seguridad

​Desbloquear puerta en evento de calendario

​Clip de cámara al recibir alerta

​Automatización de onboarding de usuarios

​Flujos de trabajo con agentes de IA

​Asistente de seguridad conversacional

​Detección de anomalías

​Avanzado: Fallback con HTTP Request

​Despliega n8n

​Compatibilidad

​Solución de problemas

​Recursos

Paquete npm

Repositorio en GitHub

Documentación de n8n

Comunidad de n8n

Instala el nodo de Rhombus

Operaciones disponibles

Cámaras

Puertas

Eventos

Usuarios

Organización

Webhooks

Flujos de trabajo de ejemplo

Reporte diario de alertas de seguridad

Desbloquear puerta en evento de calendario

Clip de cámara al recibir alerta

Automatización de onboarding de usuarios

Flujos de trabajo con agentes de IA

Asistente de seguridad conversacional

Detección de anomalías

Avanzado: Fallback con HTTP Request

Despliega n8n

Compatibilidad

Solución de problemas

Recursos