Webhook

El bloque Webhook envía solicitudes HTTP POST a endpoints de webhook externos con encabezados de webhook automáticos y firma HMAC opcional.

Configuración

El endpoint de destino para tu solicitud de webhook. Admite tanto URL estáticas como valores dinámicos de otros bloques.

Datos JSON para enviar en el cuerpo de la solicitud. Usa la varita de IA para generar cargas útiles o referenciar variables del flujo de trabajo:

{
  "event": "workflow.completed",
  "data": {
    "result": "<agent.content>",
    "timestamp": "<function.result>"
  }
}

Secreto opcional para la firma HMAC-SHA256 de la carga útil. Cuando se proporciona, añade un encabezado X-Webhook-Signature:

X-Webhook-Signature: t=1704067200000,v1=5d41402abc4b2a76b9719d911017c592...

Para verificar las firmas, calcula HMAC-SHA256(secret, "${timestamp}.${body}") y compara con el valor v1.

Encabezados personalizados de clave-valor para incluir con la solicitud. Estos sobrescriben cualquier encabezado automático con el mismo nombre.

Cada solicitud incluye estos encabezados automáticamente:

Encabezado	Descripción
`Content-Type`	`application/json`
`X-Webhook-Timestamp`	Marca de tiempo Unix en milisegundos
`X-Delivery-ID`	UUID único para esta entrega
`Idempotency-Key`	Igual que `X-Delivery-ID` para deduplicación

Salida	Tipo	Descripción
`data`	json	Cuerpo de respuesta del endpoint
`status`	number	Código de estado HTTP
`headers`	object	Encabezados de respuesta

Notificar servicios externos - Envía resultados del flujo de trabajo a Slack, Discord o endpoints personalizados

Agent → Function (format) → Webhook (notify)

Activar flujos de trabajo externos - Inicia procesos en otros sistemas cuando se cumplan las condiciones

Condition (check) → Webhook (trigger) → Response

El bloque Webhook siempre usa POST. Para otros métodos HTTP o más control, usa el bloque API.