Pular para o conteúdo

Conectando a ShopBase

Lojas virtuaisConexão: híbridoAtualizado em

Ver o que a Toca faz com o ShopBase →

Em homologação

Abrir integrações no app

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 com cs_) 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 Toca e 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.

Passo a passo

  1. Acesse Configurações → Integrações na Toca.
  2. Localize o card ShopBase e clique em Conectar.
  3. Em Domínio da loja, digite o endereço da loja como ele abre no navegador, por exemplo minhaloja.com.br (sem o /gerente).
  4. 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.
  5. 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 /gerente no 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.

Outras integrações de lojas virtuais

Abrir integrações no app