Webhook de Entrada (universal)
O que é o Webhook Universal?
O Webhook Universal é uma funcionalidade da Zaia que permite conectar qualquer serviço ou plataforma externa ao seu Agente IA, utilizando a conexão de WhatsApp já configurada na Zaia para disparar mensagens automaticamente.
Na prática, quando um evento acontece em uma plataforma externa — como uma compra na Hotmart, um lead capturado no RD Station, um formulário preenchido, ou qualquer outro gatilho de uma ferramenta de automação como Make ou n8n — a Zaia recebe esse sinal via webhook e envia uma mensagem diretamente para o WhatsApp do usuário, sem precisar de nenhuma integração adicional.
Para que serve?
O Webhook Universal é ideal para casos de uso como:
Recuperação de carrinho abandonado — notificar o lead via WhatsApp quando ele deixar de finalizar uma compra
Confirmação de compra ou acesso — enviar mensagens automáticas após uma transação ser concluída
Nutrição de leads — disparar mensagens personalizadas a partir de eventos capturados em ferramentas de CRM ou automação
Integração com Make, n8n, Zapier — conectar qualquer fluxo de automação ao WhatsApp via Zaia
Qualquer plataforma que suporte envio de webhooks — Hotmart, Kiwify, Eduzz, HubSpot, e muitas outras
Importante: Para que o disparo funcione, o WhatsApp conectado ao agente precisa estar com a sessão ativa no momento em que o webhook for chamado.
Como configurar o Webhook Universal
Passo 1 — Acesse o menu de Webhooks
No menu lateral da plataforma, clique em Webhooks e, em seguida, em Entrada.
Passo 2 — Adicione um novo Webhook
Na tela de Webhooks de Entrada, clique em "+ Adicionar Webhook".
Passo 3 — Escolha a ação
No campo Ação, selecione o que deverá acontecer quando o webhook for acionado. As opções disponíveis são:
Enviar mensagem no WhatsApp → requer WhatsApp padrão com sessão ativa
Enviar mensagem no WhatsApp API Cloud → requer WhatsApp API Cloud com sessão ativa
Passo 4 — Nomeie o Webhook
Preencha o campo "Nome do Webhook" com um nome que identifique facilmente a origem ou finalidade desse webhook (ex.: Webhook Hotmart, Carrinho Abandonado, Lead RD Station).
Passo 5 — Defina a mensagem
No campo Mensagem, escreva o texto que será enviado ao usuário quando o webhook for disparado.
Você pode — e deve — usar variáveis dinâmicas com a sintaxe {{nomeDaVariavel}} para personalizar a mensagem com os dados recebidos da plataforma de origem. Os nomes das variáveis devem corresponder aos campos enviados pelo serviço externo.
Exemplo de mensagem com variáveis:
Passo 6 — Selecione a localização dos usuários
No campo "Localização dos usuários", escolha o país onde a maioria dos seus contatos se encontra. Isso garante que o código de país seja aplicado corretamente ao número recebido via webhook.
Passo 7 — Gere o Webhook
Clique em "Gerar Webhook". A URL única do seu webhook será gerada e exibida no campo "Copie a URL do webhook abaixo".
Passo 8 — Copie a URL e use na plataforma de origem
Clique em "Copiar" para copiar a URL gerada. Cole essa URL no campo de webhook da plataforma externa que irá disparar os eventos (Hotmart, Make, n8n, etc.).
Passo 9 — Acompanhe o status na aba de Informações
Após a criação, clique na aba "2. Informações do Webhook Universal" para visualizar os detalhes do webhook criado, incluindo:
Análise de saúde — indicador de funcionamento e índice de sucesso dos disparos
Nome do Webhook — o nome definido na criação
URL do Webhook — para copiar novamente se necessário
Histórico de eventos — registro de cada vez que o webhook foi chamado, com status e data
Status — indica se o webhook está ATIVO ou FUNCIONAL
Gerenciando seu Webhook
Após a criação, você pode gerenciar o webhook diretamente na aba de Informações:
Desativar — use o toggle "Desativar Webhook" para pausar o webhook sem excluí-lo. Ele pode ser reativado a qualquer momento.
Excluir — clique no ícone de lixeira para iniciar a exclusão. Uma confirmação será exibida antes de concluir a ação. Atenção: ao deletar, todas as configurações serão perdidas permanentemente.
Atualizado