Configurar webhooks da wBuy para pedidos novos e alterações de status

Objetivo: fazer a wBuy avisar o CControle quando houver pedido novo ou alteração de status. Resultado esperado: o aviso aciona a busca autenticada do pedido, sem depender apenas da sincronização periódica.

O endereço que a wBuy deve chamar

O endpoint do CControle termina em /wbuy/notifications. A parte inicial precisa ser o domínio público HTTPS configurado pela empresa, por exemplo https://seu-dominio.com.br/wbuy/notifications.

Não use endereço local, IP interno, link de tela ou URL copiada de outro cliente. Se a URL base não estiver visível para você, peça-a ao técnico responsável pela Configuração Super.

1. Crie os dois webhooks na wBuy

1. Na wBuy, acesse Plataforma > API e Webhooks > Novo Webhook.
2. Crie o primeiro com Tipo de notificação: Pedidos (order) e método POST.
3. Cole a URL pública do CControle no campo de endereço a ser notificado.
4. Grave e confira se o webhook ficou ativo.
5. Crie o segundo com Tipo de notificação: Status de pedidos (order_status) e método PUT, usando a mesma URL.

Captura oficial de referência da wBuy, sem URL de cliente: Central de Ajuda wBuy — Bling Nativo. O texto do campo pode citar POST JSON mesmo quando o tipo selecionado já define o método do evento.

2. Confira a configuração antes de sair da wBuy

1. Devem existir duas linhas: uma de order e outra de order_status.
2. As duas devem mostrar o status ativo.
3. Compare a URL completa das duas linhas; domínio, barra e final /wbuy/notifications precisam ser idênticos.
4. Se colou uma URL errada, edite a própria linha. Não crie várias cópias do mesmo evento, pois elas podem disparar consultas duplicadas.

3. Faça uma validação operacional

1. Faça um pedido de teste ou altere o status de um pedido de teste já existente na wBuy.
2. Aguarde alguns instantes e abra Pedidos Externos no CControle.
3. Filtre a origem wBuy, localize o pedido pelo número e confira pedido, itens e status.
4. Se o pedido já estava na lista, confira a data ou o status atualizado; não crie uma venda apenas para testar o webhook.

Se o webhook não atualizar

Confira URL HTTPS, os dois tipos de evento, método correspondente, loja conectada e ID da loja. A wBuy pode desativar o webhook após 5 entregas falhas; depois de corrigir a causa, reative-o e faça uma sincronização manual de confirmação.

• Erro ao gravar: reveja se a URL é pública e começa com https://; localhost e IP da rede interna não funcionam.
• Webhook ativo, mas sem pedido no CControle: confirme primeiro a credencial e faça uma sincronização manual. O webhook só dispara a consulta; ele não substitui o acesso à API.
• Status não muda: confira se o segundo evento é order_status com PUT, não uma cópia do evento order.
• Webhook foi desativado: corrija a URL ou a disponibilidade do domínio, reative a linha e repita um único teste.

Próximo passo

Consulte sincronização lenta, erro 429 e webhook sem atualização quando o pedido não aparecer.

Revisado em: 25/08/2026.