v2026.4.10
Data de lançamento: 29 de abril de 2026
✨ Novas Funcionalidades
Nó Webhook Trigger no Construtor de Fluxos
Um novo tipo de nó para receber webhooks externos e iniciar fluxos automaticamente a partir de eventos de sistemas terceiros, como plataformas de vendas, ERPs, CRMs ou qualquer serviço que envie dados via HTTP.
Para que serve?
- Receber pedidos, eventos ou notificações de sistemas externos e iniciar fluxos automaticamente
- Mapear campos do payload do webhook diretamente em variáveis do fluxo
- Vincular ou criar clientes e chats a partir dos dados recebidos
- Rotear a execução do fluxo com base no tipo de evento (
body.event,body.type, etc.)
Como usar?
- Arraste o nó Webhook Trigger para o construtor de fluxos
- Configure o tipo de autenticação (Bearer, Header customizado, Query param, HMAC ou Público)
- Copie a URL do webhook gerada e configure no sistema externo
- Mapeie os campos do body para variáveis do fluxo
- (Opcional) Configure o vínculo com cliente e chat
- (Opcional) Configure o roteamento por evento para direcionar o fluxo com base no tipo de evento recebido
Autenticação configurável do Webhook
O nó Webhook Trigger suporta cinco modos de autenticação:
| Tipo | Descrição |
|---|---|
| Bearer | Token no header Authorization: Bearer <token> |
| Header customizado | Token em qualquer header definido pelo usuário |
| Query param | Token como parâmetro na URL (?token=xxx) |
| HMAC | Verificação de assinatura criptográfica (SHA-1, SHA-256, SHA-512) — compatível com serviços como Kiwify |
| Público | Sem autenticação |
O token é gerado automaticamente (ou pode ser definido manualmente) e armazenado criptografado no banco de dados. Administradores podem revelar o token original quando necessário.
Segurança por IP e Origem
Na aba Segurança do nó é possível restringir as chamadas ao webhook a:
- IPs específicos — lista de endereços IPv4/IPv6 permitidos
- Domínios/Origins — lista de origens HTTP permitidas
Deixar em branco aceita qualquer origem.
Modo "Ouvir" para testes em tempo real
Ao abrir o nó no modo de edição, o botão Ouvir aguarda a chegada de um webhook real e exibe:
- O payload completo recebido (body, headers, query params)
- O IP e a origem do chamador (sugestão para o allowlist)
- Botão para mapear variáveis diretamente a partir do payload recebido
- Botão para copiar o caminho de cada campo (ex.:
body.data[0].name)
O painel de Logs também permite expandir requisições anteriores e mapear variáveis a partir delas.
Vínculo com Cliente e Chat
Na aba Cliente & Chat é possível configurar a criação/atualização automática de clientes e chats a partir dos dados recebidos:
Vínculo com Cliente (Multi-key lookup)
- Adicione os campos do cliente mapeando o caminho no body (ex.:
body.user.email → E-mail) - Ative a lupa 🔍 nos campos que devem ser usados para buscar o cliente (lógica OR entre os campos marcados)
- Se o cliente não for encontrado, ele é criado automaticamente
- Regras de atualização inteligente:
- Nome: sempre atualizado
- E-mail / Telefone: preenchidos na coluna direta se estiver vazio; caso contrário, adicionados em
customer_contacts - Documento: atualizado apenas se estiver vazio
- WhatsApp, Instagram, Telegram: adicionados em
customer_contactssem sobrescrever valores existentes
Vínculo com Chat
- Selecione o canal (WhatsApp, e-mail, Instagram, etc.)
- Informe o caminho do número/contato no body (ex.:
body.user.phone) - O chat é criado ou localizado automaticamente e vinculado ao cliente
- O número/contato do chat é adicionado em
customer_contactsse ainda não existir
Roteamento por Evento
Na aba Eventos configure roteamento condicional baseado em um campo do payload:
- Defina o caminho do evento (ex.:
body.event,body.type) - Adicione casos com valor e label — o valor suporta variáveis
- Cada caso gera um edge de saída independente no nó
- Um edge "else/fallback" é sempre incluído para eventos não mapeados
No construtor de fluxos, as saídas do nó são exibidas como handles coloridos — laranja para cada caso, cinza para o else.
🎯 Benefícios
- ✅ Integração nativa com sistemas externos sem necessidade de código adicional
- ✅ Suporte a HMAC para plataformas que usam assinatura criptográfica (Kiwify, etc.)
- ✅ Lookup de cliente por múltiplos campos simultaneamente (OR) — evita duplicatas
- ✅ Criação automática de clientes e chats com dados vindos do webhook
- ✅ Roteamento de fluxo por tipo de evento recebido
- ✅ Modo "ouvir" para mapear variáveis sem precisar editar manualmente os caminhos
- ✅ Token criptografado no banco — segurança em repouso