A conexão com o Adobe Commerce (Magento) é feita por um token de integração gerado no próprio admin da sua loja. Nenhuma senha de usuário é usada.

Antes de começar

• Tenha acesso de administrador ao admin da sua loja Adobe Commerce.
• Saiba a URL da loja (ex.: https://minhaloja.com) — a URL completa, com https://.
• Gere o token no admin da loja: System → Integrations, crie uma nova integração com All Permissions, salve, ative a integração e copie o Access Token.
• Anote o Store ID da loja (na maioria das instalações é 1; lojas com múltiplas store views podem ter outros valores).

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Adobe Commerce e clique no botão de conexão.
3. Preencha os três campos:
   • storeUrl — a URL completa da loja (ex.: https://minhaloja.com).
   • accessToken — o Access Token copiado da integração criada em System → Integrations.
   • storeId — o identificador da store view (ex.: 1).
4. Salve. As credenciais passam por uma validação contra a própria loja: se o token for inválido ou a URL estiver incorreta, a conexão é recusada com o erro correspondente. Com tudo certo, o card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê vendas, pedidos, cupons e devoluções da loja, além de produtos, estoque, clientes e carrinhos abandonados. Alterações — como criar, atualizar ou excluir produto, ajustar estoque, criar regra de desconto e cupom ou excluir cupom — só acontecem mediante sua aprovação explícita, pedido a pedido, dentro do chat.

Manutenção da conexão

O token de integração do Adobe Commerce é estático e não expira sozinho: a conexão permanece ativa até você revogar ou desativar a integração no admin da loja, ou desconectar a integração na Toca. Se o token for revogado no Adobe Commerce, o card em Configurações → Integrações passa a indicar que a conexão precisa ser refeita.

Problemas comuns

• "Token inválido ou URL da loja incorreta" ao conectar — confira se o token foi colado sem espaços extras e se a integração criada em System → Integrations está ativada (não basta salvar; é preciso ativar).
• Consultas retornam acesso negado — a integração precisa ter sido criada com All Permissions (ou, no mínimo, permissões de leitura em pedidos, catálogo, estoque e clientes). Revise o escopo da integração no admin.
• Números diferentes do painel — verifique o campo storeId: com o identificador de outra store view, as consultas retornam os dados dessa outra vitrine.
• URL não aceita — o campo storeUrl exige a URL completa, com https://, sem o caminho /rest/V1 no final.