Integração Shopify
Guia completo para integrar o FashionAI com sua loja Shopify para enriquecimento automatizado de produtos e gerenciamento de catálogo.
Configuração Inicial
Para integrar sua loja Shopify com nossa plataforma, você precisará criar um aplicativo personalizado no admin do Shopify e gerar credenciais da API. Essas credenciais permitirão que nosso sistema se conecte de forma segura com sua loja e acesse os dados necessários.
Passo 1: Acessar o Admin do Shopify
- Faça login no Shopify como administrador
- No menu lateral, clique em Configurações
- Vá para Aplicativos e canais de vendas
Passo 2: Criar um Aplicativo Personalizado
- Clique em Desenvolver aplicativos
- Clique em Criar um aplicativo
- Dê um nome ao aplicativo, ex.: Integração FashionAI API
- Clique em Criar aplicativo
Passo 3: Configurar Permissões da API
Na aplicação criada, vá para a aba Credenciais da API.
- Clique em Configurar escopos da Admin API
- Selecione as seguintes permissões:
| Permissão | Descrição |
|---|---|
| read_products | Para ler produtos |
| write_products | Para editar produtos (incluindo imagens) |
| read_publications | Para ler publicações |
| read_inventory | Para ler inventário |
| read_customers | Para ler clientes |
| read_orders | Para ler pedidos |
| read_marketplace_orders | Para ler pedidos feitos através de marketplaces |
| read_buyer_membership_orders | Para ler pedidos relacionados a membros compradores |
- Clique em Salvar
Passo 4: Gerar a Chave da API e Token de Acesso
Ainda na aba Credenciais da API:
- Clique em Instalar aplicativo
- Confirme a instalação
- O Shopify gerará as seguintes credenciais:
- Token de Acesso da Admin API (Este token é mostrado apenas uma vez! Salve-o imediatamente)
Credenciais Necessárias
Após completar a configuração, você terá:
- Store URL:
https://sua-loja.myshopify.com - Admin API Access Token: Token gerado no passo 4
Configuração na Plataforma FashionAI
1. Habilitar Vision Enrichment
- No menu direito da plataforma, clique em Configurações
- Em Configurações Gerais, habilite o botão Vision Enrichment
2. Configurar Credenciais Shopify
- Vá para a aba Configurações Shopify
- Insira suas credenciais da API Shopify para sincronização de dados:
- Store URL: Sua URL da loja Shopify
- Access Token: O token gerado anteriormente
3. Configuração Adicional
Você pode deixar qualquer campo em branco se quiser ignorar essa regra.
Canais de Venda (IDs de Publicação)
Digite os IDs separados por vírgula, ex.: 123,456
Estes são os IDs de publicação (canais de venda) onde o produto estará disponível. Se você precisar configurar mais de um, separe-os com vírgula.
Fornecedores Excluídos
Digite nomes de fornecedores separados por vírgula, ex.: Nike,Adidas,Puma
Estes são os fornecedores (marcas) que serão excluídos do processamento. Se você precisar adicionar múltiplos fornecedores, separe-os com vírgula.
Origem do Pedido (Plataforma de Venda)
Digite o nome da origem do pedido, ex.: web,pos,api
Isso define a origem dos pedidos baseado na plataforma de venda. Use o nome da origem (por exemplo: web para loja online, pos para Ponto de Venda, api para pedidos da API). Se múltiplas origens se aplicam, separe-as com vírgula.
Próximos Passos
Após completar a configuração:
- Testar a conexão - Verificar se o FashionAI pode acessar seu catálogo
- Configurar regras de enriquecimento - Definir quais produtos devem ser processados
- Monitorar sincronização - Verificar o status da integração na plataforma
Solução de Problemas
Problemas Comuns
- Erros de autenticação: Verifique as credenciais da API e permissões
- Falhas de sincronização: Verifique a configuração das credenciais e endpoints
- Produtos ausentes: Certifique-se de que todos os produtos desejados estão publicados
Suporte
Para suporte técnico com a integração Shopify, entre em contato com nossa equipe em shopify@generativecrm.com
Observações Importantes
- O Token de Acesso da Admin API é mostrado apenas uma vez durante a criação. Certifique-se de salvá-lo em local seguro
- Mantenha suas credenciais seguras e não as compartilhe publicamente
- Revisite periodicamente as permissões para garantir que estão atualizadas conforme suas necessidades