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
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Wbuy e clique em Conectar.
- Preencha os dois campos:
- Usuário API — o usuário da chave que você criou.
- Senha API — a senha da mesma chave.
- 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.