Webhooks do WooCommerce

O Plugin Asaas utiliza Webhooks para manter os pedidos da sua loja sincronizados com os eventos de pagamento do Asaas.

Sempre que uma cobrança é criada, paga, vencida, estornada ou sofre qualquer alteração relevante, o Asaas envia automaticamente um evento para o WooCommerce, permitindo que o status do pedido seja atualizado sem necessidade de consultas periódicas (polling).

📘

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 verificar o status dos Webhooks

Após configurar a integração, você pode acompanhar a saúde da comunicação entre o WooCommerce e o Asaas diretamente pelo painel administrativo da loja.

Existem dois locais onde o status da fila de Webhooks pode ser consultado.

WooCommerce > Status

Acesse WooCommerce > Status e localize a seção Meio de Pagamentos Asaas.

Nessa área são exibidas informações como:

  • status da conexão com o Asaas;
  • status da fila de Webhooks;
  • disponibilidade do botão Reabilitar fila de webhooks, quando necessário.

Quando a fila estiver funcionando normalmente, a conexão com o Asaas e a sincronização dos Webhooks serão exibidas como ativas.

Caso seja identificada uma interrupção, o status da fila será alterado e o botão Reabilitar fila de webhooks ficará disponível para solicitar a retomada da sincronização.

Configurações da forma de pagamento

As mesmas informações também podem ser consultadas nas configurações de qualquer forma de pagamento disponibilizada pelo Plugin Asaas.

Além do status da fila, essa tela permite configurar um e-mail para alertas, utilizado para receber notificações caso a sincronização dos Webhooks seja interrompida.


📧

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.

Quando a fila estiver interrompida

Caso ocorra algum problema de comunicação entre o WooCommerce e o Asaas, o Plugin identificará automaticamente a interrupção da fila de Webhooks.

Nessa situação:

  • o status da fila será exibido como interrompido nas páginas de acompanhamento;
  • o botão Reabilitar fila de webhooks ficará disponível;
  • um aviso será apresentado na tela de Pedidos do WooCommerce informando que a sincronização foi interrompida.

Além disso, a própria seção Webhook das configurações da forma de pagamento também exibirá a interrupção da fila e permitirá solicitar sua reativação.

Após clicar em Reabilitar fila de webhooks, o Plugin solicitará automaticamente ao Asaas a retomada da sincronização.

Caso a fila permaneça interrompida após a reativação, consulte os Logs de Webhooks da sua conta Asaas para identificar a causa do problema antes de entrar em contato com o suporte.

Boas práticas

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.

Conteúdos relacionados

📚

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