> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.rhombus.community/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks de Rhombus

> Configura los webhooks de Rhombus para recibir notificaciones HTTP POST en tiempo real de alertas de cámaras, eventos de puertas, umbrales de sensores y pulsaciones de botones sin necesidad de sondeo.

<Note>
  Esta página fue traducida automáticamente. Si encuentra errores o tiene sugerencias, [contáctenos](mailto:support@rhombus.com).
</Note>

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

<Steps>
  <Step title="Suscríbete a eventos">
    Usa la API de Rhombus para registrar una URL de webhook y especificar qué tipos de eventos deseas recibir.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Recibe notificaciones">
    Rhombus envía una solicitud HTTP POST a tu URL registrada con los detalles del evento como una carga útil JSON.
  </Step>

  <Step title="Procesa y responde">
    Tu servidor procesa el evento y devuelve una respuesta `200 OK` para confirmar la recepción.
  </Step>
</Steps>

## Tipos de eventos

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

<CardGroup cols={2}>
  <Card title="Eventos de cámaras" icon="video">
    Detección de movimiento, alertas de analítica, clips de video guardados, detecciones impulsadas por IA
  </Card>

  <Card title="Eventos de control de acceso" icon="door-open">
    Apertura/cierre de puertas, entrada forzada, acceso concedido/denegado, escaneos de credenciales
  </Card>

  <Card title="Eventos de sensores" icon="temperature-half">
    Alertas de umbral de temperatura, humedad y calidad del aire
  </Card>

  <Card title="Eventos de dispositivos" icon="bell">
    Pulsaciones de botones, cambios de estado en línea/fuera de línea de dispositivos
  </Card>
</CardGroup>

## 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:

```json theme={null}
{
  "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"
    }
  ]
}
```

<Note>
  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.
</Note>

## 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](/api-reference/overview) 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](/es/implementations/webhook-listener).

## 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](/es/low-code-no-code/zapier) — disparadores instantáneos para eventos de reglas, pulsaciones de botones, eventos de puertas y alertas de sensores
* [Make.com](/es/low-code-no-code/make) — disparadores de webhook con enrutamiento avanzado de datos
* [n8n](/es/low-code-no-code/n8n) — procesamiento de webhooks autoalojado con capacidades de agente de IA