Webhooks do WooCommerce

Monitore os Webhooks do WooCommerce

O Plugin Asaas utiliza Webhooks para manter os pedidos do WooCommerce sincronizados com as alterações das cobranças no Asaas.

Use essa sincronização para atualizar os pedidos sem consultas periódicas à API.

📘
Configuração automática
A partir da versão 2.5 do Plugin Asaas, nenhuma configuração manual é necessária.
Ao informar uma API Key válida nas configurações do plugin, o Webhook é criado e configurado automaticamente na sua conta Asaas.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Cobrança é atualizada no Asaas"] --> B["Asaas envia o Webhook"]
    B --> C["Plugin recebe o evento"]
    C --> D["Atualizar o pedido no WooCommerce"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C validacao
    class D sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

Se um pedido não for atualizado após uma alteração na cobrança, verifique primeiro a fila de Webhooks.

Verifique o status da fila

Pelo status do WooCommerce

Acesse:

WooCommerce > Status

Localize a seção Meio de Pagamentos Asaas.

Nessa área você pode verificar:

o status da conexão com o Asaas;
o status da fila de Webhooks;
a opção Reabilitar fila de webhooks, quando a fila estiver interrompida.

Quando a sincronização estiver funcionando, a conexão e a fila serão exibidas como ativas.

Pela forma de pagamento

O status também pode ser consultado na seção Webhook das configurações de qualquer forma de pagamento do Plugin Asaas.

Nessa configuração, informe também um e-mail para receber alertas relacionados à interrupção da fila.

📧
E-mail para alertas
Recomendamos informar um endereço de e-mail monitorado pela equipe responsável pela operação da loja.
Caso a fila de Webhooks seja interrompida devido a algum erro, esse endereço será utilizado para o envio de notificações automáticas.

Recupere uma fila interrompida

Quando a sincronização for interrompida:

o status da fila será exibido como interrompido;
a opção Reabilitar fila de webhooks ficará disponível;
um aviso será apresentado na tela de Pedidos do WooCommerce;
a seção Webhook das formas de pagamento também indicará a interrupção.

Antes de reativar a fila:

Acesse os Logs de Webhooks.
Identifique o código HTTP, a mensagem de erro e as tentativas de entrega.
Corrija a causa da falha.
Volte ao WooCommerce e clique em Reabilitar fila de webhooks.
Confirme se a fila voltou ao estado ativo.

Se a fila permanecer interrompida, revise novamente os logs e consulte Erros comuns.

Resultado esperado

Após a correção e a reativação:

a fila deve voltar ao estado ativo;
a opção Reabilitar fila de webhooks deve deixar de ser exibida;
novos eventos devem voltar a atualizar os pedidos no WooCommerce.

✅
Recomendações

mantenha uma API Key válida configurada;

informe um e-mail para recebimento de alertas;

acompanhe periodicamente o status da conexão em WooCommerce > Status;

reabilite a fila sempre que houver uma interrupção;

consulte os Logs de Webhooks caso a fila continue interrompida após a reativação;

mantenha o Plugin Asaas sempre atualizado para utilizar as melhorias e correções mais recentes.

📚
Continue a configuração
Após compreender o funcionamento dos Webhooks, consulte também:

Configurações iniciais

Forma de pagamento

Erros comuns

Como visualizar Logs de Webhooks

Próximos passos

Updated 20 days ago

Did this page help you?