2.8.1 Integração VTEX — permissões de chave de API necessárias
Quais permissões de chave de API preciso para conectar Fozzels ao VTEX?
Para conectar sua loja VTEX ao Fozzels, você precisa criar uma chave de API em seu admin VTEX e atribuir as permissões corretas. Este artigo explica exatamente quais permissões ativar.
Passo 1 — Crie uma chave de API no VTEX
- Faça login no seu painel de admin VTEX
- Vá para Gerenciamento de conta → Conta → Chaves de aplicativo
- Clique em Gerar nova chave
- Dê um nome (por exemplo Integração Fozzels)
- Copie a chave de aplicativo e o token de aplicativo — você precisará deles no Fozzels
Passo 2 — Atribua permissões à chave de API
Opção A: Use a função de integração pré-construída (recomendado)
VTEX fornece uma função pronta para integrações de catálogo externo:
- Nas configurações de sua chave de aplicativo, vá para Funções
- Procure e adicione a função: IntegrationProfile-externalCatalog
- Salve — esta única função cobre todas as permissões que Fozzels precisa
Opção B: Adicione permissões individuais manualmente
Se você preferir definir permissões mínimas necessárias, adicione os seguintes recursos à sua função de chave de API:
Sistema de catálogo
Recurso
Por que é necessário
Obter lista de canais de vendas
Fozzels usa isso para se conectar à sua loja e detectar suas configurações de localidade
Obter IDs de produto e SKU
Necessário para recuperar a lista completa de produtos do seu catálogo
Obter lista de campos de especificação por categoria
Permite que o Fozzels leia suas definições de atributo de produto
Obter especificações de produto
Lê os valores de atributo atuais em cada produto
Catálogo
Recurso
Por que é necessário
Obter produto por ID
Busca detalhes completos do produto para geração de conteúdo com IA
Atualizar produto
Permissão de escrita. Fozzels usa isso para enviar descrições geradas, títulos e metadescições de volta à sua loja
Obter SKU por ID de produto
Recupera informações no nível de SKU para cada variante de produto
Obter arquivo SKU
Lê imagens de produtos existentes
Adicionar arquivo SKU
Permissão de escrita. Necessário se você usa Fozzels para gerar e enviar imagens de produtos
Criar/atualizar especificação de produto
Permissão de escrita. Permite que o Fozzels escreva conteúdo gerado de volta para campos de atributo de produto
Categoria
Recurso
Por que é necessário
Obter árvore de categoria
Fozzels usa sua estrutura de categoria para organizar seu catálogo de produtos
Passo 3 — Insira as credenciais no Fozzels
- Faça login em sua conta Fozzels
- Vá para Integrações → Adicionar integração → VTEX
- Insira o nome da sua conta (o subdomínio de sua loja VTEX, por exemplo
mystore) - Insira a chave de aplicativo e o token de aplicativo do Passo 1
- Clique em Testar conexão para verificar se tudo funciona
Perguntas frequentes
Preciso dar ao Fozzels acesso a Pedidos ou Pagamentos? Não. O Fozzels funciona apenas com seu catálogo de produtos. Ele não precisa de acesso a pedidos, logística, preços, checkout ou qualquer informação de pagamento.
Tenho uma loja multilíngue / entre fronteiras. Preciso de permissões extras? Para lojas de um único idioma, as permissões acima são suficientes. O write-back multilíngue está em nosso roteiro e pode exigir uma permissão adicional quando lançado. Atualizaremos este artigo nesse momento.
Posso restringir a chave de API a endereços IP específicos? Sim. Entre em contato com nossa equipe de suporte para obter o endereço IP do servidor Fozzels atual para colocar na lista de permissões.