A conexão com o Magazord usa três dados: o endereço do painel da sua loja e o token e a senha de integração. O endereço é o mesmo em que você entra no Magazord. O token e a senha não ficam no painel: quem fornece é o suporte da Magazord, sob pedido da loja.
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
- Peça ao suporte da Magazord o token e a senha de integração da sua loja, informando que são para a Toca.
- No pedido, diga o que a Toca vai acessar. A Magazord libera o token rota por rota: peça leitura de pedidos, produtos, estoque, preços, clientes, notas fiscais e financeiro, e escrita no que você quer que a Toca altere (por exemplo preço, estoque e situação do pedido). O que ficar de fora do token a Toca não consegue consultar nem alterar.
- Tenha em mãos o endereço do painel da loja, no formato
https://sualoja.painel.magazord.com.br.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Magazord e clique em Conectar.
- Preencha os três campos:
- Endereço do painel — o endereço em que você entra no Magazord, como
https://sualoja.painel.magazord.com.br. - Token de integração — o token que o suporte da Magazord enviou.
- Senha de integração — a senha que veio junto do token.
- Endereço do painel — o endereço em que você entra no Magazord, como
- 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 situação e canal (site, marketplace, manual e PDV), com valores, pagamentos, entregas, rastreio e ocorrências de transporte; os produtos, SKUs, categorias, marcas e características; o estoque por depósito e as movimentações; os preços e as tabelas de preço; os clientes, carrinhos e cupons; as notas fiscais; as contas a pagar e a receber e a tesouraria; as avaliações, os avise-me e os atendimentos; e os anúncios de marketplace ligados à loja.
A Toca também altera: muda preço e estoque; muda a situação e os itens de um pedido e registra conferência, observação e tag; fatura o pedido e cancela nota fiscal; cadastra e edita produtos, SKUs, categorias, marcas, garantias e kits; cria cupons e créditos; cadastra e edita clientes; responde atendimentos; e ajusta páginas, banners, mídias e anúncios de marketplace. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat.
Duas atenções: cancelar um pedido e emitir ou cancelar nota fiscal na SEFAZ não se desfazem, e o pedido de aprovação diz isso; e resposta de atendimento visível ao cliente é mensagem entregue.
Manutenção da conexão
O token e a senha de integração não expiram: a conexão vale até a loja revogar o acesso ou pedir um par novo à Magazord. Nesse caso, abra o card em Configurações → Integrações pelo botão Gerenciar, cole o token e a senha novos e clique em Atualizar. Por segurança, os valores salvos aparecem mascarados.
A Toca não troca a senha de integração por conta própria: a troca derrubaria a conexão. Ela se pede ao suporte da Magazord.
Problemas comuns
- Endereço do painel recusado — a Toca aceita o endereço terminado em
.painel.magazord.com.br. Copie da barra do navegador com o painel aberto. Se a sua loja usa o painel em outro domínio, fale com o suporte da Toca. - Acesso negado em pedidos, estoque ou outra área — o token só abre o que a Magazord liberou para ele. Peça ao suporte da Magazord a permissão que falta para o mesmo token; salvar o mesmo par de novo não resolve.
- Toda consulta falha logo depois de conectar — confira se o token e a senha foram colados sem espaço sobrando e se são do mesmo par. Na dúvida, peça os dois de novo ao suporte da Magazord.
- Conectou a loja errada — use Excluir integração no menu ⋯ do card e conecte de novo, com o endereço do painel da loja certa.