A loja da ShopBase roda WooCommerce, e a Toca conversa com ela pelo próprio endereço da loja. A conexão tem três jeitos, no mesmo card. O principal é Conectar com a ShopBase: você digita o endereço da loja, entra no painel dela e aprova o acesso da Toca; a loja gera a chave sozinha e entrega à Toca, sem você copiar nada. Os outros dois são colar uma chave da API REST (Consumer Key e Consumer Secret) ou uma senha de aplicativo do painel.
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
- Tenha o endereço da sua loja e o acesso ao painel dela (
seusite.com.br/gerente), com o usuário e a senha que a ShopBase enviou. O usuário precisa ser administrador ou gerente da loja; se a aprovação ou a chave der erro de permissão, peça esse acesso ao suporte da ShopBase. - Para a chave da API REST:
- No painel, abra WooCommerce → Configurações → Avançado → REST API e clique em Adicionar chave.
- Dê o nome
Toca, escolha o seu usuário e a permissão Ler/Escrever, e clique em Gerar chave de API. - Copie a Consumer Key (começa com
ck_) e a Consumer Secret (começa comcs_) na hora: a Consumer Secret não aparece de novo.
- Para a senha de aplicativo:
- No painel, abra Usuários → Perfil → Senhas de aplicativo, dê o nome
Tocae clique em Adicionar nova senha de aplicativo. - Copie a senha que aparece (24 letras e números, em blocos). Ela não é a senha de entrar no painel, e pode ser revogada ali quando quiser.
- No painel, abra Usuários → Perfil → Senhas de aplicativo, dê o nome
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card ShopBase e clique em Conectar.
- Em Domínio da loja, digite o endereço da loja como ele abre no navegador, por exemplo
minhaloja.com.br(sem o/gerente). - Escolha um caminho:
- Conectar com a ShopBase (recomendado): clique no botão. O painel da loja abre em outra janela: entre com o usuário do painel e clique em Aprovar. Você volta à Toca com a loja conectada.
- Chave da API REST: abaixo de “ou use uma chave da API REST”, cole a Consumer Key e a Consumer Secret e clique em Salvar chave.
- Senha de aplicativo: abaixo de “ou use uma senha de aplicativo”, preencha o Usuário do painel e a Senha de aplicativo e clique em Salvar senha de aplicativo.
- A Toca confere o acesso na loja antes de salvar. O card fica marcado como conectado e mostra a loja e o jeito da conexão.
O que a Toca acessa
Com a conexão ativa, a Toca lê os pedidos por período e por status, com itens, valores, forma de pagamento, frete, cupom e notas; o faturamento e as devoluções do período, e o relatório de vendas e de mais vendidos da loja; os produtos e as variações, com preço, preço promocional, SKU e estoque; as marcas, categorias, tags e atributos; os clientes; os cupons; as avaliações; as zonas e os métodos de frete; os impostos; e os ajustes da loja.
A Toca também altera: muda preço, promoção e estoque de produto e de variação; cadastra e altera produtos, variações, marcas, categorias e cupons; muda o status do pedido, escreve nota no pedido (interna ou visível ao cliente) e registra reembolso; cadastra e altera clientes; e ajusta frete, impostos, meios de pagamento e ajustes da loja. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat.
Algumas alterações não se desfazem, e o pedido de aprovação diz isso: reembolsar pelo meio de pagamento, mudar o status do pedido (o cliente recebe e-mail), mandar nota visível ao cliente, desativar um meio de pagamento ou de frete e excluir de vez qualquer cadastro.
O WooCommerce não tem campo próprio de rastreio. Para marcar um pedido como enviado, a Toca muda o status para Concluído e escreve uma nota visível ao cliente com o código de rastreio.
Por segurança, a Toca não cria nem altera webhooks (eles mandam os dados da loja para outro endereço), não muda o destinatário dos e-mails da loja e não lê as chaves dos meios de pagamento nem o endereço secreto dos webhooks.
Manutenção da conexão
A chave e a senha de aplicativo não vencem com o tempo. Elas param de funcionar se forem revogadas no painel da loja, se o usuário dono delas for apagado ou perder o acesso de gerente. Nesses casos, abra o card em Configurações → Integrações pelo botão Gerenciar e use Conectar com a ShopBase de novo, ou cole uma chave nova.
Para trocar de jeito: conectar de novo por qualquer dos três caminhos substitui a conexão anterior por inteiro. Por segurança, a chave e a senha salvas não aparecem no card.
Para tirar o acesso da Toca pelo lado da loja, revogue a chave em WooCommerce → Configurações → Avançado → REST API ou a senha em Usuários → Perfil → Senhas de aplicativo.
Problemas comuns
- A autorização foi negada no painel da loja — clique de novo em Conectar com a ShopBase e aprove o acesso da Toca.
- A loja recusa a chave ou a senha — confira se copiou sem espaço sobrando e se o usuário é administrador ou gerente da loja. A chave precisa ter a permissão Ler/Escrever.
- A senha de aplicativo não funciona, mas a chave sim — algumas hospedagens não repassam esse tipo de login. Use a chave da API REST.
- Endereço inválido ou a loja não responde — use o domínio como a loja abre no navegador, com ou sem
www, sem/gerenteno fim. - A Toca diz que a conexão é só de leitura — a chave foi criada com permissão “Ler”. Conecte de novo com Conectar com a ShopBase ou com uma chave Ler/Escrever.
- Conectou a loja errada — use Excluir integração no menu ⋯ do card e conecte de novo, com a loja certa.