A WooCommerce é o plugin de loja virtual do WordPress. Com a integração, a Bestfy acessa os produtos da sua loja, mantém tudo sincronizado sozinha, e o plugin Bestfy Checkout leva os seus compradores para o Checkout Transparente da Bestfy na hora de finalizar a compra.
Neste artigo você vê o caminho completo, nas duas pontas: o que fazer no painel da Bestfy e o que fazer no painel do WordPress. Cada etapa tem um GIF gravado numa loja de testes de verdade, então é só seguir os passos na ordem.
Antes de começar
Confira estes pontos no painel do WordPress. Eles evitam quase todos os erros de conexão:
O plugin WooCommerce está instalado e ativo, e a loja abre com https:// num endereço público.
Você entra no WordPress com um usuário Administrador (ou Gerente de loja).
Anote o Endereço do site (URL) de Configurações → Geral. É esse endereço que você vai informar na Bestfy (com a subpasta, se o WordPress estiver numa, como em https://minhaloja.com.br/wp).
A moeda da loja é Real brasileiro (R$), em WooCommerce → Configurações → Geral → Opções de moeda. Lojas em outra moeda não sincronizam.
Os links permanentes não estão como "Padrão" (simples), em Configurações → Links permanentes. Qualquer outra opção serve.
Se a loja usa firewall da hospedagem ou plugin de segurança (Wordfence, iThemes, Cloudflare etc.), libere os endereços /wp-json/ e /wc-auth/. São eles que a Bestfy usa para falar com a loja.
Passo 1: Conectar a loja
No painel da Bestfy, clique em Apps no menu lateral e, em E-commerce, clique em Configurar ao lado de WooCommerce.
Em Conectar loja, cole o endereço da loja no campo URL da loja e clique em Conectar com WooCommerce. Deixe o painel do WordPress logado neste mesmo navegador antes de clicar.
Abre uma tela da própria WooCommerce pedindo permissão para a Bestfy, com acesso de Ler/Escrever. Se ela pedir login, entre com o administrador. Clique em Aprovar.
Você volta para a Bestfy com a mensagem "Loja WooCommerce conectada com sucesso!", e o card passa a mostrar Loja conectada. Não precisa copiar chave nenhuma: a WooCommerce entrega a chave direto para a Bestfy.
Alternativa: Conectar colando as chaves de API
Use este caminho só se a aprovação acima não funcionar, por exemplo quando um plugin de segurança bloqueia a tela de aprovação.
No WordPress, vá em WooCommerce → Configurações → Avançado → Chaves de API REST e clique em Adicionar chave.
Em Descrição, escreva Bestfy. Em Usuário, escolha um administrador. Em Permissões, escolha Ler/Escrever. Clique em Gerar uma chave de API.
Copie a Consumer key (começa com ck_) e o Consumer secret (começa com cs_). O secret só aparece uma vez: se fechar a página, gere outra chave. Não compartilhe essas chaves nem o QR code da tela com ninguém.
Na Bestfy, ligue Conectar com chaves de API, preencha a URL da loja, a Consumer key e o Consumer secret e clique em Salvar e conectar.
Passo 2: Sincronizar os produtos
Com a loja conectada, clique no ícone de sincronizar do card Produto, na lateral. Na primeira vez, a Bestfy pergunta qual embalagem usar nos produtos (ela entra no cálculo do frete): escolha uma e clique em Confirmar, ou use Sincronizar sem embalagem. A sincronização roda em segundo plano, e o card mostra Sincronizado no fim.
Os produtos aparecem em Produtos na Bestfy com a etiqueta Woo. Para ver só eles, use Filtros → Woo.
Daqui para frente, a sincronização é automática
Esse primeiro clique é o único manual. Tudo o que você criar, editar, excluir ou restaurar na WooCommerce chega sozinho na Bestfy em poucos segundos, e uma conferência completa roda todo dia de madrugada. Você pode clicar em sincronizar de novo quando quiser.
Passo 3: Conferir os webhooks
Você não precisa criar webhook nenhum. No primeiro sincronismo, a Bestfy cria quatro webhooks na sua loja, e são eles que avisam a Bestfy quando um produto muda. Para conferir, vá no WordPress em WooCommerce → Configurações → Avançado → Webhooks. Devem aparecer, todos com status Ativo: Bestfy - product.created, Bestfy - product.updated, Bestfy - product.deleted e Bestfy - product.restored.
Não edite nem apague esses webhooks. Se a loja ficar fora do ar por um tempo, a WooCommerce pode desativá-los; a Bestfy reativa sozinha na conferência diária, ou na hora, se você clicar em sincronizar os produtos.
Passo 4: Instalar o plugin de checkout
Na Bestfy, no card Plugin de checkout, clique em Baixar plugin. Vai baixar o arquivo bestfy-checkout.zip. Não descompacte.
No WordPress, vá em Plugins → Adicionar plugin e clique em Enviar plugin.
Escolha o arquivo bestfy-checkout.zip e clique em Instalar agora.
Clique em Ativar plugin. Não há nada para configurar: com a loja conectada, a Bestfy configura o plugin sozinha.
Passo 5: Fazer uma compra de teste
Abra a sua loja numa janela anônima, coloque um produto no carrinho e clique em Finalizar compra. O plugin leva o comprador para o checkout da Bestfy, já com os produtos do carrinho. Depois do pagamento:
na WooCommerce, o pedido aparece em Pedidos. Pago no cartão, ele já chega como Processando; no Pix e no boleto, ele fica Aguardando (segurando o estoque) até o pagamento, e vai para Cancelado se o pagamento não acontecer;
na Bestfy, a venda aparece em Vendas → Pedidos.
Feito isso, a integração está concluída.
Cupons da WooCommerce
Os cupons que você já cria na WooCommerce continuam valendo. O comprador aplica o cupom no carrinho da loja, e ao finalizar a compra o cupom vai junto para o checkout da Bestfy, com o desconto calculado pela própria loja (com as mesmas regras de valor mínimo, validade e limite de uso). Com mais de um cupom no carrinho, vai o primeiro que o comprador aplicou. Se o carrinho tiver um desconto sem cupom, abre o checkout da sua loja.
Como funciona no dia a dia
Segurança da venda: se a Bestfy não responder, o checkout da sua loja abre normalmente, para você não perder a venda.
Ver o checkout da loja: logado como administrador, abra o checkout da loja com ?bestfy_native=1 no fim do endereço. O checkout da loja fica liberado naquele navegador até você abrir o endereço com ?bestfy_native=0. Para os compradores, nada muda.
Pausar a integração: use a chave Integração ativa no card Integração WooCommerce.
Atualizar o plugin: baixe o plugin de novo na Bestfy e envie pelo mesmo caminho do Passo 4. Quando o WordPress perguntar, escolha Substituir a atual pela enviada.
Desconectar: clique em Desconectar loja na Bestfy. Os produtos sincronizados da loja saem da Bestfy. A chave continua na loja: apague-a em WooCommerce → Configurações → Avançado → Chaves de API REST.
Deu erro? Veja o que fazer
"Não encontramos uma loja WooCommerce nesse endereço": confira se a URL é a mesma de Configurações → Geral → Endereço do site, se o plugin WooCommerce está ativo e se os links permanentes não estão como "Padrão".
"Não conseguimos acessar a loja": confira se a loja abre no navegador, com https, e tente de novo em alguns minutos.
"A loja bloqueou o acesso da Bestfy": libere /wp-json/ e /wc-auth/ no firewall da hospedagem ou no plugin de segurança, ou conecte colando as chaves de API.
"Aprove o acesso com um usuário administrador ou gerente da loja": saia do WordPress, entre com um administrador e conecte de novo.
"A autorização foi iniciada em outro navegador ou em outra aba" ou "expirou": clique em conectar de novo e faça a aprovação no mesmo navegador, sem fechar a aba.
"A loja não vende em real (BRL)": altere a moeda em WooCommerce → Configurações → Geral e sincronize de novo.
"A chave da loja deixou de funcionar": a chave foi apagada ou o usuário dono dela perdeu a permissão. Clique em Reconectar.
"Essa loja já está conectada a outra conta da Bestfy": desconecte a loja na outra conta ou fale com o suporte.
O checkout da loja abre em vez do da Bestfy: confira se o plugin Bestfy Checkout está ativo, se a chave Integração ativa está ligada e clique em sincronizar os produtos (isso reenvia a configuração ao plugin).
Se precisar de ajuda, chama a gente no chat de suporte da Bestfy.A WooCommerce é o plugin de loja virtual do WordPress. Com a integração, a Bestfy acessa os produtos da sua loja e o plugin Bestfy Checkout leva os seus compradores para o Checkout Transparente da Bestfy na hora de finalizar a compra.