Webhooks (saída)

Configure em Integrações → Acesso à API → Webhooks (session, workspaces:manage). O Flow envia POST JSON. Valide a assinatura X-Flow-Signature (HMAC-SHA256 do corpo bruto). A URL precisa ser HTTPS pública. Flow rejeita hosts privados/loopback (mitigação SSRF). Redirects HTTP durante a entrega não são seguidos.

Eventos

Evento	Quando
`contact.created`	Quando um contato é criado
`contact.updated`	Quando um contato é atualizado
`contact.deleted`	Quando um contato é apagado (soft-delete)
`lead.stage_changed`	Quando um lead muda de etapa no funil

Envelope

{
  "event": "contact.updated",
  "workspace_id": "uuid",
  "occurred_at": "2026-05-16T12:34:56Z",
  "data": { "contact_id": "uuid" }
}

X-Flow-Signature: sha256=<hex_minusculo>

Verificação: hex = HMAC-SHA256(secret, raw_body) — use os bytes brutos do JSON recebido, sem re-serializar. Falhas retentam com backoff; após falhas sustentadas o webhook pode ser desativado (active=false).

Começar

Workspaces

Contatos

Pesquisa de satisfação

Eventos

Inteligência artificial

Referência

Webhooks

Webhooks (saída)

Eventos

Envelope

​Webhooks (saída)

​Eventos

​Envelope

Webhooks (saída)

Eventos

Envelope