Conectar a VTEX

A VTEX é uma plataforma de e-commerce e comércio digital. Conectada à Sofik, os agentes conseguem ler e gerenciar pedidos, catálogo (produtos, SKUs, categorias e marcas), estoque e clientes da sua loja.

A VTEX não usa OAuth: a forma oficial de integrar é com uma Chave de aplicação (um par App Key + App Token) que você gera no admin da loja. São esses dois valores — mais o nome da conta — que você cola na Sofik.

O que você vai precisar

• Acesso de administrador ao admin da sua loja VTEX, com permissão para Gerenciamento de aplicações.
• O nome da sua conta VTEX — é o subdomínio que aparece na URL do admin (ex.: em minhaloja.myvtex.com, a conta é minhaloja).

Passo a passo

1. Entre no admin da sua loja (ex.: https://minhaloja.myvtex.com/admin).

2. No menu, vá em Configurações da conta › Gerenciamento de aplicações (em algumas contas: Conta › Chaves de aplicação).

3. Clique em Gerar nova chave (ou + Nova chave de aplicação) e dê um nome que ajude a identificar — ex.: Sofik.

4. A VTEX mostra a App Key e a App Token. Copie os dois agora.

5. Atribua à chave os perfis de acesso (roles) com as permissões que você quer liberar — por exemplo OMS - Full access (pedidos), Catalog Owner (catálogo) e Logistics (estoque). Sem um perfil, a chave não consegue ler aquele recurso.

O App Token só aparece uma vez

A VTEX mostra o App Token apenas no momento em que a chave é criada. Copie na hora. Se perder, gere uma nova chave. Esses valores são como uma senha — se vazarem, revogue a chave no mesmo painel e crie outra.

O que colar na Sofik

Na Loja da Sofik, abra o card VTEX e preencha:

Campo na Sofik	Valor da VTEX
Account Name (subdomínio da loja)	o nome da conta (ex.: minhaloja)
App Key	a App Key gerada
App Token	o App Token gerado

Salve. A conexão fica ativa imediatamente.

Quanto a chave pode fazer, você decide

O que os agentes conseguem fazer na VTEX depende dos perfis de acesso que você deu à chave. Quer só leitura? Atribua perfis de leitura. Precisa criar produtos ou ajustar estoque? Inclua os perfis de escrita correspondentes.

Suas chaves estão seguras

A App Key e o App Token ficam cifrados no cofre da sua empresa, são write-only (a Sofik nunca os mostra de volta) e nunca chegam aos agentes de IA — são usados apenas no servidor, no momento da chamada.