Pular para o conteúdo

Conectando a Wbuy

Lojas virtuaisConexão: credenciaisAtualizado em

Ver o que a Toca faz com o Wbuy →

Em homologação

Abrir integrações no app

A conexão com a Wbuy usa dois dados de uma chave de API que você cria no próprio painel da loja: o Usuário API e a Senha API. Não são o e-mail e a senha de login do painel. Com eles, a Toca entra na API da sua loja a cada consulta.

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 acesso de administrador ao painel da sua loja na Wbuy e o segundo fator de autenticação à mão (o app autenticador ou o e-mail): o painel pede o código para criar a chave.
  • No painel, vá em Plataforma → API e webhooks, clique em Opções → Integração REST API e depois em Criar chave de API. Dê um nome como Toca.
  • Em Métodos permitidos, marque GET nos módulos que a Toca vai ler (pedidos, produtos, clientes, cupons, trocas e devoluções e os demais) e POST, PUT ou DELETE nos módulos em que você quer que ela altere. O que ficar desmarcado a Wbuy recusa.
  • Deixe IPs permitidos em branco. A Toca chama a Wbuy de servidores sem endereço fixo, e uma lista de IPs bloquearia todas as chamadas.
  • Escolha a Validade da chave e salve. Na lista de chaves aparece o Usuário API; a Senha API aparece em Visualizar, com a senha do painel. Copie os dois.

Passo a passo

  1. Acesse Configurações → Integrações na Toca.
  2. Localize o card Wbuy e clique em Conectar.
  3. Preencha os dois campos:
    • Usuário API — o usuário da chave que você criou.
    • Senha API — a senha da mesma chave.
  4. Clique em Salvar. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê os pedidos por período e por status, com itens, pagamento, cupom, frete, rastreio e histórico de status; os produtos e as variações, com preço por tabela, estoque e fotos; o histórico de movimentação do estoque; as categorias, marcas, cores, variações, tabelas de preço e embalagens; os clientes, os endereços e o crédito de loja de cada um; os cupons; as trocas e devoluções; os pedidos diretos; as avaliações de produtos; os vendedores e afiliados; os contatos da newsletter; os centros de distribuição; e os dados da loja. A senha dos clientes, que a Wbuy guarda cifrada, não chega à Toca.

A Toca também altera: muda o status do pedido, grava frete e rastreio e anexa a nota fiscal já emitida; cria e altera pedidos e pedidos diretos (links de compra); muda o estoque de uma variação ou em lote e o preço por tabela, um a um ou em lote; cadastra, altera e exclui produtos, variações e fotos (por endereço da imagem); cria e altera categorias, marcas, cores, variações e tabelas de preço; cria, altera e exclui cupons; cadastra e altera clientes e endereços e dá ou tira crédito de loja; abre, aprova, recusa e conclui trocas e devoluções e manda mensagem ao cliente; e cuida de avaliações, vendedores, newsletter, scripts da loja e webhooks. 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: cancelar, negar ou devolver um pedido, dar ou tirar crédito de loja, concluir ou recusar uma troca (com crédito ou reembolso), mandar mensagem ao cliente (vai por e-mail), excluir produto, variação, preço, foto, cliente, cupom ou pedido, alterar o produto mandando a lista de atributos vazia (apaga todos), inserir ou trocar script na loja e cadastrar webhook.

Manutenção da conexão

A conexão vale enquanto a chave existir e estiver no prazo. Toda chave da Wbuy tem validade: antes de vencer, a Wbuy avisa por e-mail e nas notificações do painel. Use Renovar na lista de chaves, que mantém o mesmo usuário e a mesma senha, e nada muda na Toca. Se você criar uma chave nova, abra o card em Configurações → Integrações pelo botão Gerenciar, preencha o usuário e a senha novos e clique em Atualizar. Por segurança, a senha salva aparece mascarada.

A Wbuy aceita 100 consultas por minuto por chave e bloqueia a chave por cerca de 2 minutos quando o limite estoura. A Toca faz uma consulta por vez; em lojas grandes, uma leitura longa pode levar alguns minutos. Use a chave da Toca só na Toca, para outro sistema não gastar o mesmo limite.

Problemas comuns

  • A Wbuy responde que não autorizou (401) — confira o Usuário API e a Senha API, sem espaço sobrando (não são o login do painel). O mesmo erro aparece quando a chave venceu (renove na lista de chaves), quando há IP na lista de IPs permitidos (deixe em branco) ou quando o método não está marcado naquele módulo da chave.
  • Uma consulta funciona e outra não — a chave não tem o método marcado no módulo dessa consulta. Edite a chave em Integração REST API e marque o que faltou. Trocas e devoluções são um módulo à parte, que chaves antigas não trazem marcado; sem o recurso no plano da loja, a Wbuy recusa.
  • A Wbuy pede para esperar — a mesma consulta repetida em menos de um minuto, ou mais de 100 consultas no minuto. Espere um pouco e peça de novo.
  • Conectou a loja errada — use Excluir integração no menu ⋯ do card e conecte de novo, com a chave da loja certa.

Outras integrações de lojas virtuais

Abrir integrações no app