Como diagnosticar por que webhook não dispara corretamente Print

Como diagnosticar por que seu webhook não dispara corretamente

Olá, querido(a) cliente! 👋 Seu webhook não está funcionando como esperado? Não se preocupe — isso é mais comum do que parece, e com um passo a passo tranquilo, vamos descobrir o que está acontecendo. Sou a Sensei da GeHost, e estou aqui para te ajudar com calma, paciência e um toque de carinho. Vamos juntos?

Entenda o que é um webhook

Um webhook é como um convite automático que seu site envia para outro serviço (como uma plataforma de pagamento, um sistema de envio de e-mail ou um chatbot) sempre que algo importante acontece — por exemplo, quando um cliente faz um pedido.

Dica da Sensei: Se o convite não chega, o serviço não sabe que algo aconteceu. É como se você tivesse dado um telefonema, mas o número estava errado.

Passo a passo: diagnóstico simples e eficaz

1. Verifique o URL do webhook

   Confira se o endereço (URL) que você colocou no sistema de origem está 100% correto. Pequenos erros como http em vez de https, ou um caractere a mais, impedem o disparo.

   💡 Dica: Copie e cole o URL em um editor de texto para verificar se está exatamente como deveria.

2. Teste o endpoint com ferramentas online

   Use um site como webhook.site para testar se o seu webhook realmente consegue chegar a um destino.

   1. Vá até webhook.site e copie o URL gerado.
   2. Use esse URL como destino do seu webhook.
   3. Dispare um evento (como um novo pedido).
   4. Se o site mostrar a requisição, o problema não está no seu servidor — é no sistema que envia.

3. Verifique se o serviço de envio está ativo

   Alguns sistemas (como plataformas de e-commerce) exigem que você ativar manualmente o webhook no painel de configuração. Não basta colocar o URL — ele precisa estar "ligado".

   🔍 Dica: Procure por palavras como ativar, habilitar, status ou testar no painel da sua plataforma.

4. Confira se o servidor está bloqueando requisições

   Às vezes, o servidor bloqueia requisições externas por segurança. Isso pode acontecer se o IP do serviço que envia o webhook for bloqueado.

   Para verificar isso, acesse o cPanel e verifique os logs de acesso (em Logs de Acesso ou Access Logs). Se não aparecer nenhuma requisição do serviço, o problema está no envio.

   
5. Verifique se o arquivo do webhook está acessível

   Se o webhook aponta para um arquivo PHP no seu site (ex: https://seusite.com/webhook.php), certifique-se de que:

   • O arquivo existe na pasta public_html;
   • Tem permissão de leitura (geralmente 644);
   • Está escrito corretamente (sem erros de sintaxe).

   Para ver o arquivo, acesse o Gerenciador de Arquivos no cPanel.

   
6. Verifique se há erros no código do webhook

   Se o arquivo do webhook tem um erro de programação (como um PHP Parse error), ele pode falhar silenciosamente.

   Para isso, veja os logs de erros no cPanel — geralmente em Logs de Erros ou Error Logs. Lá você verá mensagens como Parse error: syntax error ou Call to undefined function.

   💡 Dica: Se não vir logs, talvez o arquivo não esteja sendo acessado — volte ao passo 5.

7. Teste com um webhook simples

   Para isolar o problema, crie um arquivo simples chamado test-webhook.php com este conteúdo:

   <?php
   file_put_contents('webhook-test.log', date('Y-m-d H:i:s') . " - Webhook recebido!\n", FILE_APPEND);
   echo "OK";
   ?>

   Coloque esse arquivo em public_html e envie uma requisição para ele (ex: via webhook.site). Se o arquivo for acessado e o log for criado, o problema está no seu código original.

Quando procurar ajuda

Se mesmo após todos esses passos o webhook ainda não dispara, pode ser algo mais profundo — como configuração de firewall, restrição de IP ou problema no sistema de origem.

✨ Nesse caso, entre em contato com o suporte da GeHost com os seguintes dados:

• O URL do webhook;
• Se você testou com webhook.site;
• Uma cópia do código do arquivo (sem dados sensíveis);
• Se houve mensagens de erro nos logs.

Nós vamos te ajudar com todo o carinho do mundo. 🤗

Resumo da Sensei

Regras de ouro:
✅ URL correta e com HTTPS
✅ Serviço de envio ativado
✅ Arquivo acessível e sem erros
✅ Logs mostrando requisições
✅ Teste com um arquivo simples primeiro

Se você seguir esse guia, com certeza vai encontrar o problema. E quando encontrar, vai sentir aquela alegria de quem resolveu um mistério! 🎉

Até a próxima, com amor e código limpo,
Sensei da GeHost 💚