Outgoing Webhook

O bloco Outgoing Webhook envia requests HTTP POST a endpoints de webhook externos com headers de webhook automáticos e assinatura HMAC opcional.

Configuração

Webhook URL

O endpoint de destino da sua request de webhook. Suporta tanto URLs estáticas quanto valores dinâmicos de outros blocos.

Payload

Dados JSON a enviar no body da request. Use a AI wand para gerar payloads ou referencie variáveis de workflow:

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

Signing Secret

Secret opcional para assinatura HMAC-SHA256 do payload. Quando fornecido, adiciona um header X-Webhook-Signature:

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

Para verificar assinaturas, calcule HMAC-SHA256(secret, "${timestamp}.${body}") e compare com o valor v1.

Additional Headers

Headers customizados chave-valor a incluir na request. Eles sobrescrevem quaisquer headers automáticos com o mesmo nome.

Headers automáticos

Toda request inclui estes headers automaticamente:

Header	Descrição
`Content-Type`	`application/json`
`X-Webhook-Timestamp`	Timestamp Unix em milissegundos
`X-Delivery-ID`	UUID único desta entrega
`Idempotency-Key`	Igual a `X-Delivery-ID` para deduplicação

Saídas

Saída	Tipo	Descrição
`data`	json	Body da resposta do endpoint
`status`	number	Código de status HTTP
`headers`	object	Headers da resposta

Exemplos

Notificar um serviço externo

Formate o resultado e faça POST para um endpoint Slack, Discord ou customizado.

Disparar um processo externo numa checagem

Quando o Condition passa, o Outgoing Webhook inicia um processo em outro sistema.

O bloco Outgoing Webhook sempre usa POST. Para outros métodos HTTP ou mais controle, use o bloco API.

Common Questions

Não. O bloco Outgoing Webhook sempre envia requests POST. Se precisar de GET, PUT, DELETE ou PATCH, use o bloco API, que suporta todos os métodos HTTP padrão.

Quando você fornece um signing secret, o bloco gera uma assinatura HMAC-SHA256 do payload e a inclui no header X-Webhook-Signature no formato t=timestamp,v1=signature. O receptor pode verificar calculando HMAC-SHA256(secret, "timestamp.body") e comparando com o valor v1.

Toda request de webhook inclui automaticamente Content-Type (application/json), X-Webhook-Timestamp (timestamp Unix em milissegundos), X-Delivery-ID (UUID único) e Idempotency-Key (igual a X-Delivery-ID para deduplicação).

Sim. Qualquer header customizado que você definir na seção Additional Headers sobrescreve headers automáticos que compartilham o mesmo nome.

O bloco Outgoing Webhook é feito para entrega de webhook: é só POST, adiciona automaticamente headers específicos de webhook (timestamp, delivery ID, idempotency key) e suporta assinatura HMAC opcional. O bloco API é mais genérico, com suporte a todos os métodos HTTP, query parameters e retries configuráveis.

Outgoing Webhook

Common Questions

On this page