O webhook da GoZAP envia os dados de cada mensagem recebida para uma URL do n8n em tempo real. Com isso você pode criar qualquer automação — resposta automática, roteamento, CRM, IA — sem precisar ficar consultando a API. Esta página mostra exatamente o que fazer, tela por tela.
"Webhook é o coração da integração: a GoZAP chama o n8n, e o n8n faz o que você quiser."
Passo a passo
1
No n8n
Criar o nó Webhook e copiar a URL
Abra seu n8n, crie um novo workflow e adicione o nó Webhook. Configure o método como POST. O n8n vai gerar automaticamente uma URL de teste — é ela que você vai usar agora. Depois de salvar e ativar o workflow, a URL de produção também aparece no mesmo lugar.
n8n — Nó Webhook
① Clique em + e busque por "Webhook"② Configure o nó: HTTP Method: POST Path: gozap-incoming(ou qualquer nome) Respond: Immediately③ Copie a URL gerada:https://seu-n8n.com/webhook-test/gozap-incoming④ Clique em "Listen for test event" para aguardar
✓A URL de teste começa com /webhook-test/ — use ela agora
✓Depois de ativar o workflow, a URL de produção muda para /webhook/
2
No painel GoZAP
Configurar o webhook da instância
No painel da GoZAP, acesse sua instância e clique em Webhook. Você vai ver a tela abaixo. Cole a URL do n8n no campo URL de destino, marque as opções certas e salve.
WebhookWebhook da instância
URL de destino
https://seu-n8n.com/webhook-test/gozap-incoming
Eventos
Filtros de mensagem
Recomendado incluir "Enviadas pela API" para evitar loops em automações.
O que marcar para começar:
✓Webhook ativo — liga o envio de eventos para a URL
✓Mensagens — envia um evento para cada mensagem recebida na instância
✓Conexão — opcional, avisa quando a instância conecta ou desconecta
✓Enviadas pela API em Filtros — evita que suas próprias mensagens de bot criem loops
!Deixe os demais filtros desmarcados por enquanto — adicione só quando precisar de um caso específico
3
No WhatsApp
Enviar uma mensagem de teste
Com o n8n aguardando no modo de teste e o webhook salvo na GoZAP, envie qualquer mensagem para o número da sua instância. Em segundos, o n8n vai capturar o evento e mostrar o payload completo no painel de execução.
n8n — Payload recebido
# Exemplo do que chega no n8n ao receber "Olá"{"event": "messages.upsert","instance": "gozap-demo","data": {"key": {"remoteJid": "[email protected]","fromMe": false },"message": {"conversation": "Olá" },"messageTimestamp": 1724952300 }} ✓event — tipo do evento (messages.upsert = nova mensagem)
✓data.message.conversation — texto da mensagem
✓data.key.fromMe — true se você enviou, false se veio de outra pessoa
4
No n8n
Ativar o workflow para produção
Depois de confirmar que o payload chega corretamente, ative o workflow com o toggle no topo do n8n. A URL muda de /webhook-test/ para /webhook/ — você precisa atualizar essa URL no painel GoZAP.
Trocar URL de teste para produção
# URL de teste (só funciona com n8n aberto)https://seu-n8n.com/webhook-test/gozap-incoming# URL de produção (funciona sempre que o workflow estiver ativo)https://seu-n8n.com/webhook/gozap-incoming① Ative o workflow no n8n → toggle no topo direito② Copie a URL de produção③ No painel GoZAP → Webhook → cole a nova URL → Salvar──────────────────────────────────────────────────✔ Integração ativa — mensagens chegando em tempo real
Próximos passos
O que construir em cima disso?
Com o webhook funcionando, você tem dados em tempo real de cada mensagem no n8n. A partir daqui você pode adicionar um nó IF para filtrar por palavra-chave, conectar ao ChatGPT para respostas automáticas, salvar em um CRM ou acionar qualquer outro serviço — tudo dentro do mesmo workflow.