Reacciona a los cambios con webhooks

Los webhooks conectan los cambios del procesamiento con tu aplicación. Un administrador configura el destino desde el panel. El worker independiente de webhooks debe estar en ejecución para realizar las entregas.

Prepara el receptor

Crea un endpoint HTTPS en tu backend.
Regístralo en el entorno de Orilla y conserva su secreto en el servidor.
Lee el cuerpo original de la solicitud, antes de transformarlo.
Verifica la firma y el tiempo de entrega.
Guarda el ID del evento para evitar procesarlo dos veces.

El SDK ofrece @orilla/sdk/webhooks para verificar la cabecera Mux-Signature sobre el cuerpo original. Acepta secretos actuales y anteriores para facilitar la rotación. Consulta la firma de sus helpers y ejemplos completos en packages/sdk/README.md y los tipos del paquete.

Diseña para reintentos

Una entrega puede repetirse o llegar después de que tu aplicación ya haya procesado el cambio. Guarda el ID de evento con una restricción única y aplica tus efectos de forma idempotente.

Confirma una entrega cuando la hayas aceptado de forma duradera. Si delegas el trabajo a tu propia cola, guarda primero el evento y procesa después.

Inspecciona las entregas

Desde el panel puedes revisar los destinos y el historial de entregas con los permisos adecuados. En una instalación propia, ejecuta el worker de webhooks junto al de procesamiento de medios.

Para desarrollo local:

pnpm dev:webhooks

El Compose de producción incluye su servicio independiente. Un asset preparado se puede consultar también por API; recibir el evento no sustituye la autorización de acceso al recurso.

Incidentes y otros canales

Los eventos propios data.incident.opened, data.incident.closed y data.incident.expired permiten reaccionar a alertas. Selecciona destinos explícitamente en la regla o el detector. Los canales directos de correo, Slack y PagerDuty tienen una cola y auditoría separadas y no sustituyen los IDs del historial de webhooks.