Webhooks
Nível de acesso requerido
Admin ou Super Admin
Para que servem os Webhooks?
Webhooks permitem que o Flowi Agentic notifique sistemas externos automaticamente quando eventos ocorrem na plataforma, sem que o sistema externo precise ficar consultando (polling).
Exemplos de uso:
- Notificar um ERP quando uma instância de compra é aprovada
- Enviar dados para um dashboard externo quando uma tarefa é concluída
- Disparar automação em outro sistema quando um processo termina
Como funcionam
Quando um evento ocorre no Flowi Agentic, o sistema envia uma requisição HTTP POST para a URL cadastrada no webhook, com os dados do evento no corpo (JSON).
Cadastrando um webhook
- Acesse Integração → Webhooks
- Clique em Novo Webhook
- Preencha:
- Nome — identificação do webhook
- URL — endpoint do sistema externo que vai receber as notificações
- Eventos — quais tipos de evento disparam esse webhook
- Secret — chave secreta para validação HMAC (opcional, mas recomendado)
- Clique em Salvar
Validação HMAC
Se você configurar um secret, o Flowi Agentic assina cada payload com HMAC-SHA256 e inclui a assinatura no header:
X-Flowi Agentic-Signature: sha256=<assinatura>No sistema receptor, valide a assinatura usando o mesmo secret para garantir que a requisição é legítima e não foi adulterada.
Eventos disponíveis
| Evento | Disparado quando |
|---|---|
instance.started | Uma instância de processo é iniciada |
instance.completed | Uma instância é concluída |
instance.failed | Uma instância falha |
task.created | Uma nova tarefa é criada |
task.completed | Uma tarefa é concluída |
task.overdue | Uma tarefa vence sem conclusão |
Retry automático
Em caso de falha (servidor externo retornar erro ou não responder), o Flowi Agentic realiza retentativas automáticas com backoff exponencial. O histórico de tentativas é registrado em cada webhook.
Monitorando entregas
Na listagem de webhooks, clique em um para ver o histórico de eventos entregues, com status de cada entrega (sucesso / falha) e o payload enviado.