- Blog de Bruxel.AI
- Caso de uso: sincronizar el contenido con Adobe Commerce sin editar la tienda a mano
Caso de uso: sincronizar el contenido con Adobe Commerce sin editar la tienda a mano
Por Manuel Mattar4 min de lectura
En resumen
Es un escenario de ejemplo. Una tienda en Adobe Commerce instala el módulo Bruxel_Sync, que manda sus productos a Bruxel y recibe de vuelta el contenido publicado en los atributos y las vistas de tienda que mapeó. La tienda sigue siendo dueña del catálogo y Bruxel solo escribe la descripción.
Este caso es un ejemplo, no un cliente: una tienda imaginaria y un catálogo de escenario para mostrar cómo funciona el módulo Bruxel_Sync de principio a fin. Las versiones, los permisos y los frenos son los que dice la guía de la ayuda hoy.
La situación
Una tienda de artículos para el hogar vende 4,000 productos en Adobe Commerce 2.4.8, con dos vistas de tienda: una en español y otra en inglés. Las descripciones las escribe un equipo de dos personas, las pega en el panel de Magento producto por producto y las traduce después. Cuando llega una temporada, el catálogo crece más rápido que el equipo.
La tienda quiere generar el contenido en Bruxel y que llegue solo a la ficha correcta, en el idioma correcto, sin pisar lo que ya funciona.
Qué viaja y en qué dirección
Antes de instalar nada, el equipo entiende la regla del módulo: van y vienen dos cosas, cada una en un sentido.
- De la tienda a Bruxel: los productos —SKU, nombre, categoría y los atributos que elijan—. Es la materia prima para generar. Viajan los habilitados y visibles; las variantes ocultas de un configurable se quedan fuera, para no gastar créditos en fichas que la tienda no muestra.
- De Bruxel a la tienda: el contenido ya publicado, escrito en la ficha del producto, en la vista de tienda de cada idioma.
La tienda es la dueña del catálogo. Si alguien edita en Bruxel un nombre o una categoría, el siguiente envío desde la tienda lo sobrescribe.
Paso 1: la llave y la instalación
Una administradora crea en Canales → Llaves de API una llave con permisos de catálogo, atributos y exportación. Después, el desarrollador de la tienda instala el módulo con Composer. El módulo se instala apagado: nada se mueve hasta que lo habilitan.
En el panel de Magento, en Stores → Configuration → Bruxel → Sincronización, hace los cuatro pasos:
- Pega la llave. «Probar conexión» confirma que responde y a qué cuenta entra.
- Mapea cada idioma a su vista de tienda: español a la vista en español, inglés a la de inglés.
- Elige qué atributos viajan a Bruxel como contexto para generar: material, medidas, color.
- Mapea los campos de contenido: qué campo de Bruxel se escribe en qué atributo de Magento.
Paso 2: generar y publicar en Bruxel
Con los productos ya en Bruxel, el equipo configura su voz de marca y genera por lotes desde el catálogo. En lote, cada producto cuesta 7 créditos por idioma de salida; con dos idiomas, 14. Lo que se publica en Bruxel es lo que el módulo va a escribir; si la organización tiene encendida la aprobación, nada sale sin que un administrador lo apruebe.
Paso 3: el primer sync, sin sustos
La primera escritura sobre un catálogo que ya tiene descripciones es el momento delicado. El módulo trae dos frenos de fábrica, y el equipo los usa:
- El modo de prueba enseña qué cambiaría —producto, campo, vista de tienda, valor actual y nuevo— sin escribir nada.
- Una opción encendida por defecto que no pisa los campos que ya tienen texto y que Bruxel nunca tocó.
Además, antes de escribir un campo por primera vez, el módulo guarda el valor anterior, y un comando de restauración lo devuelve tal cual. Antes del primer sync grande, el desarrollador pone los indexadores en «Update on Schedule», porque cada escritura invalida la caché de esa ficha.
Paso 4: el aviso en tiempo real
Para que la tienda se entere en el momento en que se publica algo, la administradora registra en Canales → Webhooks la dirección del módulo, suscrita al aviso de descripción actualizada. Lo hace después de habilitar el módulo y pegar el secreto: si el endpoint falla varias veces seguidas, Bruxel lo desactiva solo. Aunque el webhook falle, el contenido llega igual, porque el módulo revisa por su cuenta cada hora.
Qué queda resuelto y qué no
Queda resuelto: el equipo ya no copia y pega descripciones en Magento. Escribe solo en los atributos de texto con alcance de vista de tienda que mapeó, nunca cambia la URL del producto y nunca borra: un campo vacío o un producto despublicado dejan la ficha como está.
No queda resuelto todo:
- Las imágenes no viajan a la tienda en esta versión.
- Varios sitios web en la misma tienda piden revisar el mapeo a mano.
- Adobe Commerce as a Cloud Service no está cubierto; sí Adobe Commerce o Magento Open Source 2.4.7, 2.4.8 y 2.4.9.
- Content Staging: una campaña programada que se aplica pisa lo que Bruxel escribió; hay que volver a publicar después.
- Los idiomas que sincroniza son español, inglés, francés y portugués.
La guía de Adobe Commerce y la de webhooks tienen la configuración completa. Las hojas de integraciones, canales y contenido con IA muestran el resto del camino.
Preguntas frecuentes
¿Bruxel entra a mi Magento?
No. El módulo se instala en tu tienda y es él quien llama a Bruxel. Bruxel nunca entra a tu Magento.
¿Qué pasa si edito el nombre del producto en Bruxel?
La tienda es la dueña del catálogo: el siguiente envío desde la tienda sobrescribe el nombre, la marca, la categoría y los atributos. Lo que Bruxel manda a la tienda es el contenido generado, y nada más.
¿El módulo sube las imágenes a la tienda?
No en esta versión. Las imágenes no viajan hacia la tienda; el módulo escribe solo el contenido de texto en los atributos que mapeaste.
Fuentes
Sobre el autor
Manuel Mattar
Fundador de Bruxel.AI
Fundó en 2014 Wolf Sellers, agencia de comercio electrónico en la Ciudad de México, y después Bruxel.AI, el PIM con IA.
Ver todas las notas de Manuel MattarPruébalo con tu catálogo
Crea tu cuenta gratis y prueba Bruxel con tus propios productos usando los créditos de bienvenida.
Sigue leyendo
· 4 min de lectura
Caso de uso: el mismo catálogo en tres marketplaces, con las fotos de cada uno
Un escenario de ejemplo: una marca de calzado publica en Amazon, Mercado Libre y Walmart México. Columnas, fotos por destino y lo que Bruxel todavía no cubre.
· 4 min de lectura
Canales y plantillas de marketplace en Bruxel: un archivo listo por destino
Cómo funcionan los canales de Bruxel: columnas, valores por destino, plantillas de Walmart México y Mercado Libre, qué le falta a cada producto y feeds.
· 4 min de lectura
Imágenes por destino en Bruxel: una foto, el formato de cada marketplace
Cómo prepara Bruxel las fotos de tus productos para cada marketplace: tamaño, fondo, peso y nombre, con un asistente de tres pasos y una cola de revisión.