Webhook Não Funciona? Diagnóstico Passo a Passo

Configurou um webhook na Marketek mas os dados não estão chegando — ou não estão sendo enviados — como esperado? Antes de entrar em pânico, saiba que a maiória dos problemas com webhooks tem causas simples e soluções rápidas. O segredo é seguir um diagnóstico estruturado.

Veja abaixo os pontos mais comuns de falha e como investigar cada um deles.

Problema: Dados Não Chegam ou Não São Enviados

Quando um webhook parece não funcionar, o problema pode estar em qualquer ponto da cadeia: na URL, no formato dos dados, na autenticação ou no workflow associado. Siga esta sequência de diagnóstico para encontrar a causa.

Diagnóstico Passo a Passo

1. Verifique se a URL está correta

Parece óbvio, mas é a causa número um de falhas. Copie a URL do webhook diretamente da Marketek e compare com a URL configurada no sistema externo. Preste atenção a:

• Espaços extras no início ou final da URL
• Caracteres especiais que podem ter sido codificados incorretamente
• Protocolo correto (deve ser https://)

2. Confirme o método HTTP

Webhooks na Marketek utilizam o método POST. Se o sistema externo estiver enviando via GET, PUT ou outro método, os dados não serão processados. Verifique a configuração do sistema de origem.

3. Valide o formato do payload

O payload deve ser enviado em formato JSON com o header Content-Type: application/json. Erros comuns:

• Enviar dados como application/x-www-form-urlencoded em vez de JSON
• JSON malformado (vírgula extra, chave sem aspas, colchete não fechado)
• Payload vazio

4. Confira os headers de autenticação

Se você configurou headers de autenticação no webhook, o sistema externo precisa incluir exatamente os mesmos headers e valores na requisição. Verifique:

• Nome do header (case-sensitive em muitos servidores)
• Valor do token ou chave
• Se o header está sendo enviado corretamente

5. Teste com Postman ou curl

Isolar o problema é fundamental. Use o Postman ou curl para enviar uma requisição diretamente para a URL do webhook:

curl -X POST https://sua-url-webhook.marketek.digital/webhook/abc123   -H "Content-Type: application/json"   -H "X-Webhook-Token: seu-token-aqui"   -d '{"nome":"Teste","email":"teste@email.com"}'

Se funcionar via curl mas não pelo sistema externo, o problema está na configuração do sistema de origem.

6. Verifique o workflow associado

Para webhooks de entrada, os dados chegam mas nada acontece? Verifique:

• O workflow com gatilho de webhook está ativo
• O webhook correto está selecionado no gatilho
• Não há condições ou filtros bloqueando a execução
• Acesse Automações > Histórico de Execuções para ver se o workflow foi disparado

7. Consulte os logs do webhook

A Marketek registra as últimas requisições recebidas e enviadas em cada webhook. Acesse Configurações > Integrações > Webhooks, clique no webhook desejado e confira a aba Logs. Procure por:

• Requisições com status de erro
• Timestamps para confirmar se a requisição chegou
• Conteúdo do payload recebido

8. Interprete os códigos de erro HTTP

Quando Procurar Suporte

Se depois de seguir todos os passos acima o webhook ainda não funcionar, entre em contato com o suporte da Marketek informando:

• Nome e URL do webhook
• Print dos logs do webhook
• Exemplo do payload enviado
• Código de erro recebido (se houver)
• Ferramenta utilizada para teste e resultado obtido

Quanto mais informações você fornecer, mais rápido a equipe de suporte conseguirá identificar o problema.

Artigos Relacionados:
– Guia Completo: Webhooks de Entrada e Saída na Marketek
– Como Receber Dados de Formulários Externos via Webhook