Integração WooCommerce: gere as chaves e conecte a loja

A integração WooCommerce acontece pela API REST que já vem instalada na sua loja. Você gera duas credenciais dentro do WordPress, a Consumer Key e a Consumer Secret, e cola

Cadastro rápido | Sem necessidade de cartão de crédito
Fotografia editorial relacionada ao post Integração WooCommerce: gere as chaves e conecte a loja, no padrão da identidade visual do blog Emanda.

índice

A integração WooCommerce acontece pela API REST que já vem instalada na sua loja. Você gera duas credenciais dentro do WordPress, a Consumer Key e a Consumer Secret, e cola no painel da ferramenta junto com a URL da loja. Nenhum plugin extra é necessário, ou seja, o seu site não fica mais pesado por causa disso.


O WooCommerce dá liberdade total. Você escolhe hospedagem, tema, gateway e cada detalhe do checkout, e nada disso fica preso a uma plataforma fechada.

Junto com a liberdade, porém, vem o trabalho de montar cada peça. Em geral, a parte de relacionamento com o cliente acaba virando uma pilha de plugins que brigam entre si, duplicam tabela no banco e deixam o admin lento.

Existe um caminho mais leve. Uma ferramenta externa conversa com a sua loja pela API oficial, roda na infraestrutura dela e devolve só o resultado. Dessa forma, o seu WordPress continua com o mesmo peso de antes.

Como funciona a integração WooCommerce?

A conexão usa a API REST nativa do WooCommerce, aquela mesma documentada pela documentação oficial do WooCommerce. Nada de plugin proprietário no meio do caminho.

Na prática, funciona assim. Você cria um par de credenciais dentro do seu painel, autoriza o acesso e revoga quando quiser. O controle continua com você, porque a chave vive no seu WordPress.

Esse desenho tem uma vantagem prática para quem usa WordPress. Como nada roda dentro do site, uma atualização de plugin ou de tema não quebra a conexão. Do mesmo modo, um pico de acesso na loja não fica mais pesado por causa das automações, já que o processamento acontece do lado de fora.

Depois de conectada, a loja passa a disparar mensagem sozinha a partir dos eventos que já acontecem: pedido novo, carrinho largado, cadastro recente, cliente sumido. Quem quiser entender a lógica dos fluxos antes de configurar encontra o panorama em automação de e-mail para ecommerce.

Passo 1: gerar as chaves no WordPress

Diferente das plataformas fechadas, aqui você mesmo emite as credenciais. São dois códigos, uma Consumer Key e uma Consumer Secret.

  1. Entre no painel do seu WordPress.
  2. Vá em WooCommerce → Configurações.
  3. Abra a aba Avançado.
  4. Clique em API REST.
  5. Clique em Adicionar chave.
  6. Preencha a descrição com Emanda, escolha o seu usuário administrador e defina a permissão como Leitura/Escrita.
  7. Clique em Gerar chave de API.

Atenção a um detalhe que derruba muita gente. A Consumer Secret aparece uma única vez na tela. Portanto, copie as duas credenciais antes de sair, porque depois só resta gerar uma chave nova.

Por que a permissão precisa ser Leitura/Escrita: a leitura sozinha resolveria quase tudo. A escrita, no entanto, é o que permite criar os cupons do cashback e das campanhas com desconto dentro da sua loja. Sem ela, o cliente receberia um cupom que não funciona no checkout.

Passo 2: conectar no painel

Com as duas credenciais em mãos, o resto leva menos de um minuto.

  1. Entre no painel da Emanda.
  2. Vá em Configurações → Integrações.
  3. Clique no card do WooCommerce.
  4. Cole a Consumer Key e a Consumer Secret.
  5. Informe a URL da loja, o endereço público que seus clientes acessam.
  6. Salve. A credencial é testada na hora, e o painel avisa caso algo esteja errado.

Vale guardar as duas credenciais em um gerenciador de senhas. Elas dão acesso aos dados da sua loja, portanto merecem o mesmo cuidado de uma senha de administrador. Além disso, se um dia você trocar de ferramenta, basta revogar a chave para encerrar o acesso por completo.

Assim que a conexão fecha, a ferramenta importa produtos, pedidos e clientes. A partir daí, ficam disponíveis as automações de carrinho abandonado, visita abandonada, clientes inativos, pós-compra, aniversário, lembrete de PIX, lembrete de boleto, boas-vindas e newsletter automática.

Problemas comuns na integração WooCommerce

A integração WooCommerce falha quase sempre pelos mesmos cinco motivos. Vale conferir esta lista antes de abrir chamado.

“Chave inválida” ou “não autorizado”
Confira se a permissão ficou como Leitura/Escrita. Além disso, verifique se a chave foi criada em um usuário administrador, e não em um editor ou assinante.

A URL parece certa mas não conecta
Use o endereço exato, com https://, sem barra no final e sem /wp-admin. Se a loja fica em subpasta, como site.com.br/loja, informe a subpasta também.

Plugin de segurança ou firewall bloqueando
Alguns plugins de segurança e certas configurações de WAF barram chamadas na API REST. Nesse caso, libere o acesso à rota /wp-json/wc/ na sua ferramenta de segurança.

Permalinks na opção “Simples”
A API REST exige permalinks amigáveis ativos. Vá em Configurações → Links permanentes e escolha qualquer opção diferente de “Simples”, senão a API não responde.

Perdi a Consumer Secret
Gere uma chave nova na mesma tela. A antiga pode ser revogada ali mesmo, e nada se perde no processo.

A conexão parou de funcionar do nada
Verifique primeiro se a chave continua existindo em WooCommerce → Configurações → Avançado → API REST. Uma chave apagada por engano, ou um usuário administrador removido, encerra o acesso na hora. Nesse caso, gere uma credencial nova e cole de novo no painel.

O que a integração WooCommerce não faz

Marcar os limites evita expectativa errada.

Ela não sincroniza estoque de volta para o seu Woo. O fluxo é de leitura, mais a criação dos cupons de desconto que você configurar no cashback ou nas campanhas.

Ela também não separa cada variação de produto. Hoje o produto entra pelo nível do produto, e não com uma linha para cada combinação de tamanho ou cor.

Por fim, a integração WooCommerce não deixa o site mais lento. Como a ferramenta roda fora do seu WordPress, ela não adiciona consulta ao banco nem script no front da loja.

Perguntas frequentes

Preciso instalar um plugin da Emanda?
Não. A conexão usa a API REST que já vem no WooCommerce por padrão. Você não adiciona código novo ao site, e por isso não existe risco de conflito com os plugins que já estão instalados.

Isso deixa meu site mais lento?
Não. A ferramenta roda na infraestrutura dela e conversa com a sua loja pela API. O visitante continua carregando exatamente as mesmas páginas de antes, sem script extra no front.

Posso revogar o acesso depois?
Sim, apagando a chave na mesma tela onde ela foi criada. A revogação é imediata e a troca de dados para na hora, sem depender de suporte nem de prazo.

Preciso mexer no código do tema?
Para as automações de pedido e cadastro, não. Já as de comportamento de navegação, como visita abandonada, dependem do script de rastreamento ativo. O painel mostra onde colar.

O que fazer amanhã

O caminho todo cabe em uma tarde tranquila. Gere a chave, conecte a loja e ative uma automação só. O carrinho abandonado costuma ser a melhor porta de entrada, porque pega gente com intenção quente.

Depois de duas semanas rodando, avalie o retorno antes de ligar a próxima. Se a sua operação ainda avalia plataforma, vale olhar o comparativo de plataformas de ecommerce. Agora, se a loja já roda em WooCommerce, o passo seguinte é conectar sua loja à Emanda e ativar a primeira automação.

Categorias

Receba toda semana as dicas que fazem seu ecommerce vender mais

Receba toda semana o tipo de conteúdo que faz o cliente abrir, clicar e comprar sem spam.