C Controle | Ajuda — wBuy: sincronização demora, erro 429 e webhook sem atualização

Objetivo: diferenciar espera normal, limite da API e falha de webhook. Resultado esperado: a equipe para de repetir ações, identifica a causa provável e sabe quando reconectar ou pedir análise técnica.

Antes de começar

Perfil ou permissão: Operador de integração ou técnico da empresa.

Caminho: Vínculo e Integração > wBuy > indicadores da última execução

Horário aproximado da tentativa.
ID/código do pedido que deveria aparecer.
Print do estado da integração sem dados de credencial.

Limites que explicam a demora

A wBuy permite até 100 requisições por minuto por credencial, somando todas as rotas. O CControle trabalha com margem e controla esse ritmo. Por isso, loja matriz e filial que usam o mesmo usuário de API compartilham o mesmo limite.

Além do teto, a wBuy pode bloquear consultas idênticas feitas em sequência: pedidos têm uma janela curta de repetição e produtos/clientes têm janela maior. É por isso que clicar várias vezes em Sincronizar agora piora o tempo de resposta.

Print real do local de validação da conexão wBuy no CControle — Print real do CControle: antes de repetir uma sincronização, abra o cartão wBuy e confira se a conexão ainda está válida. Erros 401 e 403 exigem atualizar a credencial, não tentar novamente.

Como agir em cada situação

Sinal	O que fazer
Sincronizando / em andamento	Aguarde e atualize a lista depois. Não inicie outra execução.
Erro 429	Espere a janela do limite passar. Não repita imediatamente a mesma ação.
Falha com 401 ou 403	Reconecte a credencial; espera não resolve senha recusada.
Pedido novo não apareceu	Confira origem, período, loja, webhook e uma sincronização manual única.
Webhook sem atualização	Verifique URL HTTPS, eventos order/order_status, status ativo e ID de loja correspondente.

Print real da página Pedidos Externos no CControle — Print real do CControle: depois de aguardar, abra Pedidos Externos e filtre a origem wBuy no período correto para verificar se o pedido foi atualizado.

Checklist do webhook

O endereço termina em /wbuy/notifications e usa HTTPS público.
Existem os eventos Pedidos (order) e Status de pedidos (order_status).
Os dois webhooks estão ativos na mesma loja cujas credenciais estão no CControle.
O cartão mostra o último webhook ou a equipe consegue identificar o evento no pedido depois da sincronização.

Importante: após 5 entregas falhas, a wBuy pode desativar o webhook. Corrija a URL ou a disponibilidade do servidor antes de reativá-lo; reativar sem corrigir só repetirá a falha.

Próximo passo

Quando precisar envolver suporte, siga quais evidências enviar sem expor a senha.

Revisado em: 24/08/2026.

Esse artigo foi útil?

Obrigado pelo retorno!

Sem problemas — fale direto com o nosso suporte que a gente resolve com você:

Chamar no WhatsApp ou ligue (32) 3721-6702