Configurar e testar um webhook
Configurar webhook exige URL pública, seleção de eventos e teste antes de ir para produção.
Onde acessar
Plataforma > Configurações > Webhooks > Novo webhookOu por loja: Loja > Configurações > Webhooks > Novo webhook
Pré-requisitos
Antes de criar um webhook, você precisa de:
- URL receptora pública — a evob precisa conseguir acessar a URL via internet; localhost ou IPs internos não funcionam
- Serviço configurado no receptor — o sistema que vai receber (Zapier, seu servidor, Make) precisa estar pronto para aceitar POST em JSON
- Conhecimento dos eventos — saber quais eventos você precisa ouvir (veja Eventos disponíveis)
Passo a passo — criar webhook
- Acesse Configurações > Webhooks > Novo webhook
- Preencha:
- URL: endpoint que receberá as notificações - Eventos: selecione os eventos que devem disparar (ex: `purchase.completed`) - Status: Ativo
- Salve
- Clique em Enviar teste para verificar se a URL está respondendo
Testar o webhook
O botão Enviar teste envia um payload de exemplo para a URL configurada. O payload de teste tem flag `"test": true` para o receptor ignorar se necessário.
Verificar se o teste funcionou:- Status HTTP retornado deve ser 200 — qualquer outro código (4xx, 5xx) indica problema no receptor
- O log de envio mostra o status da resposta e o tempo de resposta
Ferramentas para construir e testar receptores
| Ferramenta | Para que serve | |---|---| | Zapier | Conectar evob a 5.000+ apps sem código | | Make (ex-Integromat) | Automações visuais mais complexas | | webhook.site | Inspecionar o payload recebido antes de configurar o receptor real | | n8n | Automação open-source auto-hospedada | | Seu próprio servidor | Integração direta com sistemas internos |
Dica: use `webhook.site` para inspecionar o payload antes de conectar o receptor real. Cole a URL do webhook.site na configuração, dispare o teste e veja o payload completo em tempo real.Boas práticas
✅ Faça
- Nomeie o webhook de forma que identifique o sistema receptor e o propósito — "LeadLovers — nova venda" é melhor que "Webhook 1"
- Teste o webhook em ambiente de staging antes de ativar em produção — use uma URL de teste (webhook.site ou ambiente de homologação do receptor) para validar o payload sem afetar dados reais
- Monitore o log de envios nas primeiras 48h após ativar — problemas de conectividade e timeouts aparecem logo no início
❌ Não faça
- Criar webhooks para eventos sem receptor configurado — webhook ativo sem receptor gera falhas contínuas no log e pode afetar a performance de envio
- Usar a mesma URL para múltiplos ambientes (teste e produção) — payloads de teste contaminarão dados reais no receptor
- Ativar o webhook e não testar — o teste é o único jeito de confirmar que o receptor está configurado corretamente antes de depender do webhook em produção
Erros comuns
"O teste retorna 200 mas a URL não recebe nada"
Verifique se a URL do receptor está exatamente correta (com ou sem `/` final, com protocolo `https://`). Algumas ferramentas (Zapier, Make) geram URLs específicas por cenário — confirme que está usando a URL correta do trigger configurado.
"O receptor recebe o payload mas retorna 500"
O erro está no processamento do receptor (código do servidor, lógica do Zapier, etc.), não na evob. O payload chegou corretamente — o receptor falhou ao processar. Analise os logs do receptor.
"O webhook funcionou no teste mas não dispara em produção"
Confirme que o evento que ocorreu em produção é o mesmo que está configurado no webhook. Ex: matrícula manual não dispara `purchase.completed` — dispara `enrollment.created`. Verifique o log de eventos para confirmar qual evento foi gerado.
"Quero que o webhook só dispare para uma loja específica"
Webhooks configurados em Loja > Configurações > Webhooks disparam apenas para eventos dessa loja. Webhooks em Plataforma > Configurações > Webhooks disparam para todas as lojas. Configure no nível correto.
Próximos passos
- 📖 Eventos disponíveis para webhooks
- 📖 Retry e depuração de webhooks
- 📖 Segurança e autenticação de webhooks (HMAC)
- 📖 Conectar LeadLovers via webhook
Foi útil este artigo? 👍 👎 Falar com CS (em produção) · Pergunte ao Vob 🤖 (em produção) Última atualização: 2026-05-07