A conexão com o WooCommerce é autorizada na sua própria loja: você informa o endereço na Toca, aprova o acesso numa tela do próprio WooCommerce e a loja envia as chaves de API diretamente para a Toca, de servidor para servidor. Você não copia nem cola chave nenhuma.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

• A loja precisa estar acessível publicamente na internet, em HTTPS — é por esse canal que ela entrega a chave de API. Loja em ambiente local ou sem certificado não conclui a autorização.
• Tenha acesso de administrador ao WordPress da loja.
• A API usada (wc/v3) requer WooCommerce 3.5 ou mais recente.
• Saiba o endereço da loja, incluindo a subpasta quando o WordPress não está na raiz do domínio (ex.: minhaloja.com.br ou minhaloja.com.br/loja).

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card WooCommerce e clique em Conectar.
3. Digite o endereço da loja (ex.: minhaloja.com.br) e clique em Autorizar.
4. Você será levado à tela de autorização da própria loja. Entre como administrador, se necessário, e aprove o acesso de leitura solicitado pela Toca.
5. A loja emite o par de chaves e o envia diretamente para a Toca, de servidor para servidor. Você volta para a Toca com o card marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê pedidos com itens, valores, status, frete e cupom; faturamento e devoluções; produtos e variações com preço, SKU e estoque; clientes; cupons; e os relatórios de vendas e de mais vendidos que a própria loja soma. A autorização pede apenas o escopo de leitura: a Toca não altera nada na sua loja WooCommerce.

Manutenção da conexão

As chaves emitidas pela loja não expiram: valem até serem revogadas. Para revogar, acesse WooCommerce → Configurações → Avançado → REST API no painel da loja e remova a chave da Toca. Com a chave revogada, o card em Configurações → Integrações volta a pedir conexão — refazer o fluxo emite um par novo, e o endereço da loja já vem preenchido.

Problemas comuns

• A tela de autorização não abre — confira o endereço digitado e se a loja está no ar, acessível publicamente e em HTTPS. Sem esses três pontos o fluxo não começa.
• Neguei o acesso na tela da loja — a loja devolve você para a Toca sem emitir chave e o card continua desconectado. Refaça o fluxo e aprove o acesso.
• Erro de autenticação em todas as consultas depois de conectar — a chave foi revogada no painel da loja ou a hospedagem interfere no cabeçalho de autenticação. Refaça a conexão para emitir uma chave nova; se persistir, confirme na documentação oficial do WooCommerce as recomendações para a sua hospedagem.
• Erro rest_no_route — a versão do WooCommerce é anterior à 3.5 e não expõe a API wc/v3. Atualize o WooCommerce da loja para conectar.