Saltar al contenido principal

2.8.2 Configuración completa de integración con VTEX

Esta guía proporciona instrucciones paso a paso para integrar tu tienda VTEX con Fozzels. El proceso implica dos etapas principales: generar las claves API requeridas dentro de tu panel de administración de VTEX, y completar la configuración dentro de Fozzels.

Parte 1. Configuración en el lado de VTEX​

Para permitir que Fozzels lea la estructura de tu catálogo y escriba contenido generado de vuelta a tu tienda, necesitas crear un rol dedicado con permisos específicos y generar una Clave de aplicación y un Token de aplicación.

Paso 1. Crear un rol con permisos requeridos​

  1. Inicia sesión en tu panel VTEX Admin.

  2. Ve a Configuración de cuenta → Gestión de usuarios → Roles.

  3. Haz clic en Nuevo rol.

  4. Asigna un nombre claro al rol (por ejemplo, Integración de Fozzels).

  5. En la lista de permisos, añade acceso para los siguientes recursos:

  • Catálogo (Gestor de licencias):

  • Categoría — Lectura / Escritura

  • Marca — Lectura / Escritura

  • Producto — Lectura / Escritura

  • SKU — Lectura / Escritura

  • Especificación / Atributos — Lectura / Escritura

  • CMS (si se usa para medios/imágenes):

  • Acceso de Lectura / Escritura

  1. Guarda el nuevo rol.

Paso 2. Generar clave de aplicación y token de aplicación​

  1. En el menú Configuración de cuenta, ve a Gestión de cuenta → Claves de aplicación.

  2. Haz clic en Gestionar claves o Generar clave.

  3. Introduce una etiqueta reconocible (por ejemplo, Conector de Fozzels).

  4. Asigna el rol creado en el paso 1 (Integración de Fozzels) a esta clave.

  5. El sistema generará dos credenciales:

  • Clave de aplicación (permanece visible en tu lista).

  • Token de aplicación (mostrado solo una vez al crear).

  1. Importante: ¡Copia y almacena el Token de aplicación en un lugar seguro inmediatamente! ¡Una vez que cierres la ventana modal, no se puede recuperar de nuevo!

Los usuarios también pueden consultar la base de conocimientos oficial de VTEX para obtener instrucciones detalladas sobre cómo crear claves de aplicación y tokens:

Parte 2. Configuración en el lado de Fozzels

Una vez que tus credenciales de API estén listas, configura la conexión dentro de Fozzels.

Paso 1. Crear una nueva integración​

  1. Inicia sesión en Fozzels y abre Integraciones desde el menú de navegación superior.

  2. Haz clic en el botón verde + Crear.

  3. Selecciona VTEX de la lista de plataformas de integración disponibles.

Paso 2. Introduce detalles de configuración (Pestaña 1: Configuración)​

Rellena el formulario de conexión:

  • Nombre: Introduce un nombre para esta integración (por ejemplo, Tienda principal de VTEX).

  • URL: Introduce la URL/dominio de tu tienda VTEX.

  • Clave de aplicación: Pega la clave de aplicación generada en VTEX.

  • Token de aplicación: Pega el token de aplicación generado en VTEX.

  • Entorno (opcional): Por defecto es vtexcommercestable. Solo modifica esto si VTEX te indicó que uses un entorno personalizado.

  • Configuraciones regionales de traducción (opcional): Para cuentas transfronterizas, especifica configuraciones regionales de VTEX separadas por comas (por ejemplo, es-AR, en-US). Déjalo vacío para tiendas monolingües.

  • Horario de extracción global (opcional): Establece un horario de extracción automatizado personalizado o deja la configuración predeterminada.

  • Limitación de extracción / Retrasos de API (opcional):

  • Retraso entre páginas: Establece una duración de pausa después de cada página de resultados obtenida durante una extracción (100–15.000 ms). Déjalo vacío para usar el valor predeterminado de la plataforma.

  • Retraso entre solicitudes: Establece una duración de pausa entre llamadas de API individuales durante una extracción (100–15.000 ms). Déjalo vacío para usar el valor predeterminado de la plataforma.

  • ⚠️ Nota: Establecer estos valores por debajo de los valores predeterminados de la plataforma puede activar la limitación de velocidad de VTEX y causar que las extracciones de catálogo fallen.

Haz clic en Guardar en la esquina inferior izquierda.

Paso 3. Verificar estado y obtener tiendas (Pestaña 2: Sitios web y tiendas)​

  1. Verifica que todos los indicadores de estado en la esquina superior derecha estén activos:

  • Activo — Habilitado (interruptor verde).

  • Autorizado — Marca de verificación verde.

    • API REST conectada — Marca de verificación verde.

  1. Haz clic en el botón EXTRAER SITIOS WEB Y TIENDAS en la esquina inferior izquierda.

  2. Tus sitios web y configuraciones regionales de tiendas aparecerán en la tabla. Cambia los interruptores de Estado a activo para los sitios web y tiendas que planeas procesar.

Paso 4. Extraer datos del catálogo (Extraer productos)​

  1. Localiza tu tienda en la tabla y haz clic en Extraer productos (o haz clic en la flecha desplegable junto a ella).

  2. Puedes activar la sincronización de datos para entidades específicas o ejecutarlas secuencialmente:

  • Atributo de producto

  • Atributo de categoría

  • Atributo de marca

  • Categoría

  • Marca

    • Producto

  1. Espera a que se complete la sincronización. El estado de cada entidad se volverá verde mostrando 100%.

  2. Haz clic en el icono del ojo (Ver) junto a cualquier bloque de entidad para inspeccionar los datos extraídos.

¡Felicidades! Tu integración de VTEX ahora está completamente configurada y lista para usarse. Fozzels ahora sincronizará sin problemas tus datos de catálogo, permitiéndote generar descripciones de productos con IA de alta calidad, contenido localizado y metadatos con facilidad. Si necesitas hacer ajustes más tarde, siempre puedes volver a la página de Configuración de integración.

¡Feliz automatización!