VTEX
Pré-requisito
Apenas o usuário Master da loja (cujo e-mail aparece em Account management > Accounts > Contact) pode criar e administrar as chaves de API (appKeys e appTokens).
Passo 1: Gerar credenciais
O usuário Master deve:
- Ir até Account management > Accounts, seção Security.
- Selecionar “Generate access key and secret”.
- Atribuir um nome identificável, por exemplo: “Integração - Wivo”.
- Pressionar “Generate new secret”.
Importante: O appToken (secret) é mostrado uma única vez ao ser criado. Copia e guarda em um lugar seguro.
Passo 2: Obter credenciais
- O appKey (Access Key) está disponível no campo correspondente da seção Security.
- Vais precisar tanto do appKey quanto do appToken para o formulário de integração na Wivo.
Passo 3: Criar um papel personalizado
Vai até Account settings > Account management > Roles e cria um novo papel:
- Em “Choose role”, seleciona “Custom”.
- Atribui um nome, por exemplo: “Integração Wivo”.
- Concede as seguintes permissões:
| Categoria | Recurso |
|---|---|
| Catalog | Product Form, Brands, Categories, SKUs |
| Checkout | Shopping Cart Full Access, Orders Full Access |
| PCI Gateway | Payment-View Data |
| Pricing | Price List - Read Prices |
| VTEX Fulfillment | Orders Detail |
| OMS | View Orders, List Orders, View store sales stats |
| Logistics | Logistics viewer, inventory/shipping read-only |
Passo 4: Associar o papel à API
- Copia o appKey da seção Security.
- Vai até Account Management > Users e clica em “New User”.
- Cola o appKey como e-mail do novo usuário.
- Seleciona o papel “Integração Wivo” criado no passo anterior.
- Clica em “Save”.
Tens problemas com a integração? Escreve para contacto@wivoanalytics.com ou pelo chat do app.