Como corrigir webhook do WooCommerce que não dispara
O que é o webhook do WooCommerce que não dispara?
Um webhook do WooCommerce é uma notificação automática que a loja envia para uma URL externa quando algo acontece, como um pedido criado ou um produto atualizado. Em vez do sistema externo ficar perguntando, o WooCommerce avisa na hora. Quando ele não dispara, a integração (ERP, automação, marketplace) fica sem receber o evento, e os dois lados saem de sincronia sem nenhum erro visível para o cliente.
Como identificar
- Em WooCommerce > Configurações > Avançado > Webhooks, o webhook aparece com o status “Desativado” sem você ter desativado.
- O log de entregas (Delivery log) do webhook mostra resposta “HTTP 0” ou tempo esgotado, indicando que a URL de destino não respondeu.
- Um novo pedido é criado, mas o sistema externo nunca recebe o payload e nenhuma linha aparece no log de entrega do webhook.
- A entrega registra “signature mismatch” no destino, sinal de que o Secret do webhook não confere com o esperado pela integração.
Como prevenir
- Monitore o Delivery log dos webhooks e reative imediatamente qualquer um que o WooCommerce desativar por falha
- Use um cron real do servidor em vez do WP-Cron padrão para garantir que a fila de entregas sempre roda
- Mantenha a Delivery URL em HTTPS válido e confirme o Secret igual nos dois lados após qualquer mudança na integração
Causa
- Webhook desativado automaticamente pelo WooCommerce após cinco falhas consecutivas de entrega, ficando com status Disabled até ser reativado manualmente.
- URL de destino (Delivery URL) errada, fora do ar ou com certificado SSL inválido, fazendo a entrega falhar e nunca chegar ao sistema externo.
- WP-Cron travado ou desativado: a entrega do webhook é agendada na fila do cron, e sem ele rodando as notificações ficam paradas.
- Secret do webhook diferente do configurado no destino, fazendo a integração rejeitar o payload por assinatura inválida e parecer que não disparou.
- Tópico (Topic) do webhook mal escolhido, escutando um evento que não acontece, ou o pedido sendo criado por um fluxo que não aciona o gancho esperado.
Como resolver
- Reative o webhook e cheque o status: em WooCommerce > Configurações > Avançado > Webhooks, abra o webhook e mude o status de Desativado para Ativo. O WooCommerce desativa o webhook sozinho após cinco falhas seguidas, então isso costuma ser o primeiro ajuste.
- Valide a Delivery URL e o SSL: confirme que a URL de destino está correta, acessível pela internet e com HTTPS válido. Teste a URL fora do site (por curl ou navegador) para garantir que ela responde 200 antes de o WooCommerce tentar entregar.
- Confira o log de entregas: no próprio webhook, abra o Delivery log e leia a última tentativa. Códigos como HTTP 0, timeout ou 401/404 dizem se o problema é rede, SSL, autenticação ou rota inexistente no destino.
- Verifique o WP-Cron: a entrega do webhook depende da fila do WP-Cron. Se o cron está travado ou desativado (define WP_CRON_DISABLE), configure um cron real do servidor chamando wp-cron.php por minuto para destravar a fila de entregas.
- Alinhe o Secret e dispare um teste: garanta que o Secret do webhook é idêntico ao configurado na integração de destino. Depois, crie um pedido de teste e confirme que uma nova linha de sucesso aparece no Delivery log.
// functions.php do tema filho — registra no log do WooCommerce cada entrega de webhook
// (ajuda a ver se o WooCommerce ESTA tentando disparar e qual resposta recebe do destino)
add_action( 'woocommerce_webhook_delivery', function ( $http_args, $response, $duration, $arg, $webhook_id ) {
$code = is_wp_error( $response ) ? $response->get_error_message() : wp_remote_retrieve_response_code( $response );
$logger = wc_get_logger();
$logger->info(
sprintf( 'Webhook #%d entregue em %.2fs — resposta: %s', $webhook_id, $duration, $code ),
array( 'source' => 'webhook-delivery-debug' )
);
}, 10, 5 );
// Veja em WooCommerce > Status > Logs (source: webhook-delivery-debug).
// Se NADA for registrado ao criar um pedido, o webhook nem esta sendo disparado (status/cron).Perguntas frequentes
Por que meu webhook do WooCommerce ficou desativado sozinho
O webhook não dispara ao criar um pedido. Por onde começo
O WP-Cron influencia na entrega do webhook
O que significa HTTP 0 no log de entrega do webhook
Recebo signature mismatch no destino do webhook. Como resolvo
Como faço um teste do webhook sem esperar um pedido real
Como corrigir o filtro de produtos do WooCommerce no JetSmartFilters
O Product Filter do WooCommerce no JetSmartFilters não filtra produtos quando o provedor escolhido em 'This filter for' ou o Query ID do widget de filtro não apontam para a mesma query que monta a grade da loja. Sem esse pareamento, o filtro envia a busca para um lugar diferente do que exibe os produtos, e a vitrine continua igual.
Como corrigir o cálculo de frete errado no WooCommerce
O cálculo de frete errado no WooCommerce acontece quando o valor da entrega no checkout vem maior, menor ou diferente do esperado, ou simplesmente não aparece. Quase sempre vem de zonas de entrega mal configuradas, de produtos sem peso e dimensões, ou de classes de frete e regras de frete grátis conflitando entre si.
Como corrigir erro de pagamento do Tutor LMS com WooCommerce
O erro de pagamento do Tutor LMS com WooCommerce ocorre quando o aluno compra um curso, o pedido entra no WooCommerce, mas a matricula não acontece e ele fica sem acesso. A causa quase sempre e o pedido não atingir o status Concluido, o produto do curso não ser virtual, ou a engine de monetizacao errada nas Configurações.
Como corrigir o produto do WooCommerce com página em branco
O produto do WooCommerce com página em branco acontece quando a página de um produto abre totalmente vazia, sem texto, imagem ou botão de comprar. A causa quase sempre é um erro fatal de PHP silenciado, um template de produto ausente no tema, ou o limite de memória do PHP estourado ao renderizar a página.
Como corrigir o formulário de pagamento Stripe que não processa no WPForms
O pagamento Stripe não processa no WPForms quando o formulário é enviado mas a cobrança no cartão não é criada, o envio trava no botão ou o pedido fica sem confirmação. As causas reais mais comuns são AJAX desativado no formulário, o addon Stripe Pro inativo, o modo Teste ligado em produção e SSL ou webhook mal configurados.
Como corrigir carrinho do WooCommerce que esvazia sozinho
O carrinho do WooCommerce que esvazia sozinho acontece quando os itens adicionados desaparecem antes do checkout, derrubando a conversão. A causa quase sempre é cache servindo a página do carrinho em vez de ignorá-la, ou a sessão/cookie do cliente sendo perdida entre as requisições.
