Pré-lançamento. Ainda não publicado no WordPress.org e sem download disponível. Nada está à venda. A versão premium está em avaliação.
Plugin gratuito para WordPress · pré-lançamento

Saiba quando o WooCommerce desativa um webhook em silêncio

Quando as entregas de um webhook falham repetidamente, o WooCommerce muda o status para Desativado e para de enviar eventos ao seu ERP, logística, CRM ou ferramenta de automação. Ninguém recebe e-mail. Este plugin registra o evento, mostra um aviso no painel e tenta enviar ao administrador uma notificação por episódio.

Ver a situação do pré-lançamento   Leia as limitações antes

Ainda sem download. Sem conta, sem pagamento, sem pré-venda.

O problema

Muitas lojas enviam pedidos, produtos ou clientes a outros sistemas pelos webhooks nativos do WooCommerce. Se o sistema que recebe fica fora do ar, devolve erro ou demora demais, a loja continua vendendo e o outro sistema para de receber. Ninguém é avisado: você descobre quando estoque, notas ou envios saem de sincronia.

O que o WooCommerce faz quando um webhook falha repetidamente

O que o plugin monitora

A desativação

Escuta a ação do próprio WooCommerce woocommerce_webhook_disabled_due_delivery_failures e registra um episódio por desativação.

Uma tentativa de notificação por episódio

O plugin tenta enviar uma notificação por episódio. Sinais repetidos do mesmo episódio são contados no painel e não geram nova tentativa. A deduplicação usa chave única no banco (testada com dois processos simultâneos em SQLite e MariaDB).

Orientação para restaurar

Uma página no painel lista cada episódio com tópico, número de falhas, último código de resposta, diagnóstico em linguagem simples e os passos manuais para restaurar a entrega.

Como o administrador é avisado

O plugin mostra um aviso no painel e tenta enviar um e-mail de notificação por episódio ao endereço de administrador do site, via wp_mail() do WordPress. Chegar à caixa de entrada depende da configuração de e-mail do seu site. O e-mail identifica o webhook só por ID e tópico, porque o nome é texto livre e pode conter dados sensíveis. Exemplo do formato da v0.3.1 (valores ilustrativos; o e-mail do plugin é em inglês e traduzível; linhas finais abreviadas):

Subject: [Your Store] WooCommerce disabled webhook #12 (order.created) after repeated delivery failures

WooCommerce automatically disabled a webhook because its deliveries kept failing.
No further events for this topic will be sent until it is reactivated.

Webhook ID: 12 (the name is not included in this e-mail; see WooCommerce > Settings > Advanced > Webhooks)
Topic: order.created
Delivery endpoint (scheme, host and port only; host may be redacted): https://[host redacted]
Failure count: 6 (threshold 5)
Last response: 503 (illustrative)
Disabled at (UTC): 2026-11-11 02:04:16

Diagnosis: ...
How to restore delivery: 1. Fix the receiving endpoint first ...
4. Events that happened while the webhook was disabled were not delivered and are not queued. ...

This plugin attempts at most one notification per disable episode. Further failed-delivery signals for the same episode are counted on the details page and do not trigger another attempt. If processing stops before the mail attempt completes, the status may remain Pending. Notifications are not automatically retried.
(other lines abbreviated)

Status do e-mail no painel (rótulos em inglês no plugin)

StatusSignificado
Accepted by WordPress (aceito pelo WordPress)wp_mail() retornou sucesso: a mensagem foi repassada ao sistema de e-mail do seu site. Isso não confirma a chegada à caixa de entrada.
Failed (falhou)wp_mail() retornou falso ou registrou erro. Fica só um código genérico (ex.: wp_mail_failed), nunca o texto do erro, que pode conter endereços.
Pending (pendente)O episódio foi registrado, mas a tentativa não terminou, ou o PHP parou no meio. Não há nova tentativa.
Captured locally (not sent) (capturado localmente)Só em ambiente de teste, com a constante WDMFW_CAPTURE_MAIL definida. Nada foi enviado.
Not sent: no valid recipient (sem destinatário válido)Não havia endereço de destinatário válido, então nenhum e-mail foi tentado.

Nenhum status significa "entregue". O plugin não recebe confirmação de nenhum provedor de e-mail.

O que o plugin não faz

Se você precisa de novas tentativas automáticas, log com payloads ou replay, use um plugin de camada de entrega ou um gateway de webhooks hospedado. Este plugin é somente leitura de propósito.

O que é armazenado e o que pode continuar visível

Armazenado pelo plugin (no banco do seu próprio WordPress)Não armazenado pelo plugin
ID do webhook, tópico, número de falhas, limite, último código de resposta, datas, estado do episódio, status do e-mail e um código genérico de falha.
O endpoint reduzido a esquema://host:porta, em que o host pode aparecer como [host redacted].
O nome do webhook (não é armazenado, exibido nem enviado por e-mail; o plugin usa Webhook #ID e o tópico). Dados de pedidos ou clientes e payloads. Caminho, query string, fragmento, usuário e senha da URL: são descartados antes de qualquer gravação.

Como o host é tratado

O plugin não tenta detectar segredos, e nenhuma regra reconhece todos os segredos. Ele usa uma lista de permissão. O host só é mantido se for:

Todo o resto, incluindo outros subdomínios e qualquer IP público, vira [host redacted]. A porta é mantida.

O que pode continuar visível

Nada é enviado para nós nem para terceiros. A única mensagem que sai é o e-mail de notificação enviado pelo seu próprio site via wp_mail().

Limitações atuais

A versão premium está em avaliação

O plugin acima será gratuito. Estamos avaliando se um complemento pago seria útil o bastante para ser construído. Nada está à venda: não há checkout nem pré-venda. Veja as ideias de preço em avaliação (em inglês).

Ver o que existe hoje (pré-lançamento)