Integración Shopify
Guía completa para integrar FashionAI con tu tienda Shopify para enriquecimiento automatizado de productos y gestión de catálogo.
Configuración Inicial
Para integrar tu tienda Shopify con nuestra plataforma, necesitarás crear una aplicación personalizada en el admin de Shopify y generar credenciales de API. Estas credenciales permitirán que nuestro sistema se conecte de forma segura con tu tienda y acceda a los datos necesarios.
Paso 1: Acceder al Admin de Shopify
- Inicia sesión en Shopify como administrador
- En el menú lateral, haz clic en Configuraciones
- Ve a Aplicaciones y canales de venta
Paso 2: Crear una Aplicación Personalizada
- Haz clic en Desarrollar aplicaciones
- Haz clic en Crear una aplicación
- Dale un nombre a la aplicación, ej.: Integración FashionAI API
- Haz clic en Crear aplicación
Paso 3: Configurar Permisos de API
En la aplicación creada, ve a la pestaña Credenciales de API.
- Haz clic en Configurar alcances de Admin API
- Selecciona los siguientes permisos:
| Permiso | Descripción |
|---|---|
| read_products | Para leer productos |
| write_products | Para editar productos (incluyendo imágenes) |
| read_publications | Para leer publicaciones |
| read_inventory | Para leer inventario |
| read_customers | Para leer clientes |
| read_orders | Para leer pedidos |
| read_marketplace_orders | Para leer pedidos realizados a través de marketplaces |
| read_buyer_membership_orders | Para leer pedidos relacionados con membresías de compradores |
- Haz clic en Guardar
Paso 4: Generar la Clave de API y Token de Acceso
Aún en la pestaña Credenciales de API:
- Haz clic en Instalar aplicación
- Confirma la instalación
- Shopify generará las siguientes credenciales:
- Token de Acceso de Admin API (¡Este token se muestra solo una vez! Guárdalo inmediatamente)
Credenciales Necesarias
Después de completar la configuración, tendrás:
- Store URL:
https://tu-tienda.myshopify.com - Admin API Access Token: Token generado en el paso 4
Configuración en la Plataforma FashionAI
1. Habilitar Vision Enrichment
- En el menú derecho de la plataforma, haz clic en Configuraciones
- En Configuraciones Generales, habilita el botón Vision Enrichment
2. Configurar Credenciales Shopify
- Ve a la pestaña Configuraciones Shopify
- Inserta tus credenciales de API Shopify para sincronización de datos:
- Store URL: Tu URL de tienda Shopify
- Access Token: El token generado anteriormente
Próximos Pasos
Después de completar la configuración:
- Probar la conexión - Verificar que FashionAI pueda acceder a tu catálogo
- Configurar reglas de enriquecimiento - Definir qué productos deben ser procesados
- Monitorear sincronización - Verificar el estado de la integración en la plataforma
Solución de Problemas
Problemas Comunes
- Errores de autenticación: Verifica las credenciales de API y permisos
- Fallas de sincronización: Verifica la configuración de credenciales y endpoints
- Productos ausentes: Asegúrate de que todos los productos deseados estén publicados
Soporte
Para soporte técnico con la integración Shopify, contacta a nuestro equipo en shopify@generativecrm.com
Observaciones Importantes
- El Token de Acceso de Admin API se muestra solo una vez durante la creación. Asegúrate de guardarlo en un lugar seguro
- Mantén tus credenciales seguras y no las compartas públicamente
- Revisa periódicamente los permisos para garantizar que estén actualizados según tus necesidades