Integración con VTEX
Conecte su tienda VTEX con FashionAI para enriquecer automáticamente su catálogo de productos con descripciones y atributos impulsados por IA.
Lo que Necesitará
Antes de comenzar, asegúrese de tener:
- Acceso de administrador a su tienda VTEX
- Acceso a la configuración de la plataforma FashionAI
Configuración Paso a Paso
Paso 1: Habilitar Vision Enrichment
Primero, active la función Vision Enrichment en FashionAI:
- Haga clic en Settings en el menú derecho
- Vaya a General Settings
- Active el interruptor Vision Enrichment
Esto permite que nuestra IA analice las imágenes de sus productos y genere automáticamente descripciones y atributos.
Paso 2: Obtener su Token API de VTEX
Necesitará un token API de VTEX con permisos específicos. Contacte a su administrador de VTEX para crear un token con estos permisos:
| Product | Category | Resource |
|---|---|---|
| Catalog | Content | Product and SKU Management |
| Catalog | Content | Category Management |
| Catalog | Content | Category |
| Catalog | Content | SKUs |
| OMS | OMS Access | List Orders |
| OMS | OMS Access | View Order |
| Checkout | Checkout Resources | Full Order Access |
Paso 3: Configurar VTEX en FashionAI
-
En FashionAI, vaya a Settings
-
Haga clic en la pestaña VTEX Settings
-
Ingrese sus credenciales API de VTEX:
- Store Name: El nombre de su tienda VTEX
- API Key: El token del Paso 2
- API Token: Su token de aplicación VTEX
-
Haga clic en Save
Paso 4: Crear un Afiliado
Esto permite que FashionAI reciba actualizaciones de su catálogo VTEX automáticamente.
- En su administrador de VTEX, vaya a Order Management
- Haga clic en Settings → pestaña Affiliates
- Haga clic en New Affiliate
- Complete la siguiente información:
| Field | What to Enter |
|---|---|
| Name | FashionAI |
| ID | FFF |
| Trade Policy | 1 |
| Follow-up Email | vtex@generativecrm.com |
| Search Endpoint | Click "Generate Link" |
| Search Endpoint Version | 1.x.x |
| Use my payment method | Leave unchecked |
- Haga clic en Save
Cómo Funciona
Una vez que la integración está activa:
- Los nuevos productos agregados a VTEX se detectan automáticamente
- FashionAI analiza las imágenes de los productos usando visión computacional
- La IA genera descripciones, etiquetas y atributos
- Los datos enriquecidos se sincronizan de vuelta a su catálogo VTEX
- Sus productos tienen mejores descripciones y descubribilidad
Verificar el Estado de la Integración
Para verificar que todo está funcionando:
- Vaya a Settings → Integrations en FashionAI
- Revise el estado de la integración VTEX:
- ✅ Active: Todo está funcionando correctamente
- ⏳ Syncing: Actualización en progreso
- ❌ Error: Algo necesita atención
Problemas Comunes
Los Productos No se Sincronizan
Solución:
- Verifique que su token API tenga todos los permisos requeridos
- Compruebe que el afiliado esté configurado correctamente
- Asegúrese de que la Trade Policy incluya los productos que desea sincronizar
Errores de Conexión
Solución:
- Verifique nuevamente sus credenciales de VTEX en Settings
- Confirme que el token API sigue siendo válido
- Pruebe la conexión usando el botón "Test Connection"
Productos sin Enriquecimiento
Solución:
- Asegúrese de que Vision Enrichment esté habilitado
- Verifique que las imágenes de los productos sean de alta calidad y accesibles
- Compruebe que los productos estén publicados en la Trade Policy correcta
¿Necesita Ayuda?
Si encuentra algún problema:
- Email: vtex@generativecrm.com
- Incluya: El nombre de su tienda y una descripción del problema
Próximos Pasos
Después de completar su integración: