Como conectar a VTEX

Assim como nas demais integrações, conectar sua conta da VTEX é essencial para liberar os dashboards dentro do V4MOS.AI. A integração permite importar dados de pedidos da sua loja, com atualizações diárias e visualizações no Painel e em Análises. Este guia explica todo o processo passo a passo.

1. Acessando a área de conexões

Entre na organização em que deseja ver os dados. Em seguida:

  • No menu lateral esquerdo, abra a seção Gestão dos dados

  • Clique em Contas conectadas

Essa página mostra todas as integrações já existentes na sua organização.

2. Iniciando a conexão com a VTEX

Em Contas conectadas, clique em + Nova conexão.

Você será direcionado à página "Conecte com suas ferramentas", onde é possível filtrar por categoria (Todas, Mídia, Analytics, CRM, E-commerce, Landing Page).

Localize o card VTEX e clique em Conectar para começar o processo.

3. Criando um aplicativo de integração na VTEX

Você precisa criar uma chave de aplicação com perfil OMS na sua conta VTEX. No passo 1 de 4:

  • Faça login na VTEX

  • Acesse seu perfil, clique em Configurações da conta e, em seguida, em Chaves de aplicação

  • Clique em Gerenciar minhas chaves e depois em Gerar chave

  • Dê o nome v4mos-minhaloja ao rótulo, substituindo "minhaloja" pelo nome da sua loja na VTEX

  • Clique em Adicionar perfis e adicione dois perfis: OMS - Full Access Selecione cada um e clique em Adicionar perfil

  • Por fim, clique em Gerar. Guarde o Rótulo, a Chave de aplicação e o Token — você vai precisar deles no próximo passo

Após concluir, clique em Avançar.

4. Informando suas credenciais

No passo 2 de 4, cole as informações geradas pela VTEX nos campos abaixo. Essas credenciais ficam armazenadas com segurança e são usadas apenas para sincronizar os dados da sua loja.

  • Nome da loja: é o subdomínio da sua loja na VTEX — o trecho antes de ".vtexcommercestable.com.br"

  • Chave de aplicação: cole a chave gerada no passo anterior

  • Token da aplicação: cole o token gerado no passo anterior

Após preencher, clique em Avançar.

5. Período de importação de dados

No passo 3 de 4, defina a partir de quando os dados serão importados:

  • Selecione a data ou período no campo Escolha uma data ou período

  • A partir dessa data, o V4MOS.AI começará a importar os pedidos da sua loja VTEX

  • As atualizações ocorrem diariamente entre 02h e 10h

Após configurar, clique em Avançar.

6. Resumo e conclusão

No passo 4 de 4, revise os dados da sua conta antes de concluir a conexão:

  • Loja: nome da loja VTEX conectada

  • Data de início da importação: data selecionada no passo anterior

A partir dessa data, o V4MOS.AI começará a importar os pedidos da sua loja VTEX. As atualizações ocorrem diariamente entre 02h e 10h.

Confira tudo e clique em Concluir.

7. Acompanhando o status da integração

Após concluir, você será direcionado de volta para Contas conectadas, onde poderá acompanhar o status da importação.

  • A conexão inicial pode levar entre 15 e 60 minutos (ou alguns minutos, conforme o volume)

  • O status aparecerá na própria listagem

  • Você receberá uma notificação por e-mail quando a integração estiver pronta

  • Após isso, os dados passam a aparecer no Painel e em Análises

Conclusão

Conectar sua loja VTEX envolve a criação de uma chave de aplicação com os perfis corretos (OMS - Full Access e Feed v3 and Hook Admin) e a cópia das credenciais geradas — iniciando por Gestão dos dados → Contas conectadas → + Nova conexão e o assistente de conexão com a VTEX em 4 passos.