A conexão com a Vtex é feita por credenciais de aplicação (app key e app token), geradas 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 Vtex.
• Saiba o nome da conta da loja (ex.: minhaloja) — é o nome que aparece no endereço do admin, não a URL completa.
• Gere um par de credenciais no admin da Vtex: Configurações da conta → Gerenciamento de aplicações, criando uma chave de aplicação com acesso de leitura aos módulos de pedidos (OMS), catálogo, logística e clientes.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Vtex e clique no botão de conexão.
3. Preencha os três campos:
   • account — o nome da conta (ex.: minhaloja), sem https:// e sem .myvtex.com.
   • app_key — a chave de aplicação gerada no Gerenciamento de aplicações.
   • app_token — o token correspondente à chave.
4. Salve. O card fica marcado como conectado e a Toca já consegue consultar a loja.

O que a Toca acessa

Com a conexão ativa, a Toca lê vendas, pedidos e faturamento (OMS), produtos e catálogo, clientes e estoque da loja. Alterações — como atualizar preço, estoque, dados de SKU e criar ou arquivar cupons — só acontecem mediante sua aprovação explícita, pedido a pedido, dentro do chat.

Manutenção da conexão

As credenciais de aplicação da Vtex não expiram sozinhas: a conexão permanece ativa até você revogar a chave no admin da loja ou desconectar a integração na Toca. Se a chave for revogada na Vtex, o card em Configurações → Integrações passa a indicar que a conexão precisa ser refeita.

Problemas comuns

• Erro de autenticação logo após conectar — confira se app_key e app_token foram colados sem espaços extras e se pertencem à mesma chave de aplicação.
• Consultas retornam vazio ou acesso negado — a chave de aplicação precisa de perfil de acesso com leitura nos módulos consultados (OMS, Catalog, Logistics, Master Data). Revise o perfil associado à chave no Gerenciamento de aplicações.
• Conta não encontrada — o campo account deve conter apenas o nome da conta (ex.: minhaloja), nunca a URL da loja.