1. A chave no WooCommerce
Em WooCommerce, Configurações, Avançado, API REST, clique em Adicionar chave e escolha permissão de leitura e escrita. O segredo só aparece nessa hora: deixe a tela aberta até terminar.
Guia grátis para lojas WooCommerce
A integração atual não usa plugin: o Bling entra pela API do WooCommerce e cria os webhooks na loja. Ligamos uma conta de verdade numa loja de teste e olhamos o que ele pede, o que grava e por que o cadastro do cliente pode nascer sem CPF, número e bairro.
BW.S1 — Conectar
Em WooCommerce, Configurações, Avançado, API REST, clique em Adicionar chave e escolha permissão de leitura e escrita. O segredo só aparece nessa hora: deixe a tela aberta até terminar.
Na Central de Extensões, em Plataforma de e-commerce, abra WooCommerce Webhook e clique em Conectar. Preencha o endereço da loja, a chave e o segredo. O método de autenticação vem em SSL, e também há OAuth (HTTP), Basic Auth e SSL + User-Agent.
Dê um nome à loja e escolha as regras: importar estoque e imagens dos produtos e como cada situação do pedido no WooCommerce entra no Bling. Por padrão, todas entram como Em aberto, inclusive Cancelado e Falhado: vale revisar.
Passos feitos numa conta real do Bling em 4 de novembro de 2026, com WooCommerce 11.2.1. Os nomes das telas podem mudar: a ajuda do Bling é a referência dele.
BW.S2 — Na loja
O log da loja mostrou o Bling chamando /wp-json/wc/v3/ com a chave e o segredo na própria URL, e sem User-Agent. É por isso que firewall de WordPress costuma barrar: a ajuda do Bling cita o Wordfence, o iThemes Security e o Mod_security da Hostgator.
Produto criado, Pedido criado e Pedido atualizado, todos apontando para o Bling. Cada vez que salvamos a configuração, ele criou mais três iguais: terminamos com nove, e cada pedido novo gerou seis entregas. Ficam em WooCommerce, Configurações, Avançado, Webhooks.
Webhook só vale para venda nova. Para as anteriores, o Bling manda usar Importar pedidos manualmente, no menu de Vendas: na tela Pedidos de lojas virtuais, escolha a loja e clique em Visualizar. Foi por ela que os nossos pedidos entraram.
A loja de teste estava num endereço temporário, com WooCommerce 11.2.1 e sem nenhum plugin do Bling.
BW.S3 — O cadastro
Ela diz que o Brazilian Market é obrigatório, porque é por ele que o Bling captura contato e endereço de entrega. E diz que o plugin do próprio Bling foi descontinuado. Se a sua loja usa o checkout clássico com o Brazilian Market, siga por aí.
CPF, número e bairro ficam no pedido, mas não saem na API do WooCommerce, então o Bling não os recebe. No nosso teste, o cliente entrou no Bling só com nome, rua, CEP, cidade e telefone: CPF, número e bairro em branco.
Sem o Brazilian Market instalado, a API passou a levar os campos, e o cliente de teste entrou no Bling como Pessoa Física, com CPF 111.444.777-35, bairro Santa Helena, número 777 e complemento Apto 402, cada um no seu campo.
Ver o Pro, R$ 197 por ano"billing": { "persontype": "F", "cpf": "111.444.777-35", "number": "777", "neighborhood": "Santa Helena" }
É o trecho do pedido de teste na API do WooCommerce com o Pro ativo. Para conferir a sua loja, abra /wp-json/wc/v3/orders/ID com a chave e procure esses campos dentro de billing. O checkout em blocos com o Brazilian Market 4.0.2 é outro caso: o pedido nem grava o CPF.
BW.S4 — Limites
Não testamos. Medimos o caminho do pedido e do cadastro do cliente. Atualizar estoque, devolver o rastreio à loja e emitir nota fiscal dependem de produto vinculado e de plano ativo no Bling.
A conta usada estava com o período de testes vencido. Os webhooks responderam com sucesso, mas os pedidos novos não apareceram sozinhos nas vendas em mais de 5 minutos: entraram pela importação. Não sabemos se é o plano vencido. Confira na sua conta.
Não medimos o Bling com tema, firewall ou hospedagem de terceiros. Antes de vender, faça um pedido de teste e abra o cadastro do cliente no Bling.
BW.S5 — Perguntas
No WooCommerce, gere uma chave em Configurações, Avançado, API REST, com permissão de leitura e escrita. No Bling, abra a Central de Extensões, procure WooCommerce Webhook em Plataforma de e-commerce, clique em Conectar e preencha o endereço da loja, a chave e o segredo. Depois é dar um nome à loja e escolher as regras de produtos e pedidos.
Não mais. A ajuda do Bling diz que o plugin dele foi descontinuado e manda desativar quem ainda tem. A integração atual não instala nada: ela usa a chave da API REST do WooCommerce e os webhooks que o próprio Bling cria na loja.
A ajuda do Bling diz que ele é obrigatório, porque é por ele que o Bling captura contato e endereço de entrega. Na nossa loja de teste, sem o Brazilian Market instalado, o que fez o cadastro chegar completo foi o WooCommerce entregar os campos na API: com o Brasa Checkout Brasil Pro, o cliente entrou com CPF, número e bairro.
Porque o WooCommerce sozinho não tem CPF, número nem bairro, e o Bling lê a API dele. Se o campo não sai na API, o cadastro nasce sem ele. Abra um pedido em /wp-json/wc/v3/orders/ID com a sua chave e procure cpf, number e neighborhood dentro de billing: se não estiverem lá, o Bling também não recebe.
Não. Medimos: ele grava CPF, número e bairro no pedido, mas esses campos não saem na API do WooCommerce, e o Bling lê a API. Quem manda para a API é o Pro, por R$ 197 por ano, ou o Brazilian Market, se a sua loja usa o checkout clássico.
Os webhooks só valem para vendas feitas depois de conectar. Para as anteriores, o Bling manda usar Importar pedidos manualmente, no menu de Vendas. A tela se chama Pedidos de lojas virtuais: escolha a loja, clique em Visualizar e importe as que quiser.
A ajuda do Bling cita o Wordfence, que barra POST sem User-Agent, o módulo Banned Users do iThemes Security e o Mod_security da Hostgator. O log da nossa loja mostrou que o Bling chama mesmo sem User-Agent. Confira também se a chave tem permissão de leitura e escrita e se o site responde em HTTPS.
Vale olhar. Na nossa loja, cada vez que salvamos a configuração o Bling criou mais três webhooks iguais, e terminamos com nove. Cada pedido novo gerou seis entregas, todas respondidas com sucesso. Eles ficam em WooCommerce, Configurações, Avançado, Webhooks. Não apagamos os repetidos na loja de teste, então não medimos o efeito.
BW.S6 — Suporte
Chame no WhatsApp com o link da loja e o que apareceu no Bling. Você fala com quem escreveu o plugin.