Integra con n8n

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

Instala el nodo de Rhombus

1. Abre la configuración de n8n

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

2. Instala el paquete

   Ingresa el nombre del paquete y haz clic en Install:

   @rhombussystems/n8n-nodes-client

3. Añade tu clave de API

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

   1. Ve a Rhombus Console y genera una clave de API
   2. En n8n, crea una nueva credencial Rhombus API
   3. Pega tu clave de API y guarda

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

Operaciones disponibles

El nodo de Rhombus proporciona 41 operaciones a través de 11 tipos de recursos:

Control de acceso

Cámaras

Puertas

Eventos

Reconocimiento facial

Bloqueo (Lockdown)

Organización

Sensores

Usuarios

Vehículos

Webhooks

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

Desbloqueos programados

Para puertas que deben abrirse según un horario, como una sala de conferencias durante las reuniones reservadas, usa los horarios de puertas y sus excepciones en Rhombus en lugar de una automatización: siguen funcionando cuando la plataforma de automatización falla y tus administradores los ven en la consola. Si un flujo debe desbloquear una puerta, agrega un paso en el que una persona apruebe cada ejecución.

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 comunitario — o para apuntar a la región de la UE (reemplaza el host por api2.eu.rhombussystems.com) — 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"
      }
    ]
  }
}

const cameras = $input.all()[0].json.cameraStates;

return cameras.map(cam => ({
  uuid: cam.uuid,
  name: cam.name,
  status: cam.connectionStatus,
  location: cam.locationName
}));

Despliega n8n

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

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

Compatibilidad

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

Solución de problemas

Recursos