Conectar tu tienda Adobe Commerce
El módulo Bruxel_Sync mantiene tu catálogo de Adobe Commerce y tu contenido de Bruxel en la misma página: la tienda manda los productos, Bruxel devuelve las descripciones.
Transcripción del video
En este video conectas una tienda Adobe Commerce con Bruxel, con el módulo que se instala en tu Magento.
Primero, una llave de API para la tienda. La crea alguien con rol de administrador.
Lleva cinco permisos: leer y escribir el catálogo, leer y escribir atributos, y exportar.
La llave se muestra una sola vez: cópiala y pégala en tu Magento.
En el panel de Magento, el módulo Bruxel_Sync se instala apagado. Con la llave pegada, lo habilitas.
«Probar conexión» confirma que la llave responde y a qué cuenta de Bruxel está entrando.
Cada idioma se mapea a sus vistas de tienda: aquí, el español a la vista en español.
Y eliges qué campo de Bruxel se escribe en qué atributo de Magento: la descripción, la corta y los metadatos.
La tienda manda sus productos: SKU, nombre, categoría y los atributos que elijas. Aquí llegaron tres.
Tu tienda es la dueña del catálogo; Bruxel solo devuelve el contenido generado.
En Bruxel generas la descripción como siempre.
En cuanto se publica, queda lista para regresar a la tienda.
El módulo baja lo publicado: con el aviso en tiempo real o con su revisión de cada hora. Aquí se ve lo que escribió.
Para el primer sync trae frenos: un modo de prueba y no pisar los campos que ya tienen texto.
Y en la tienda, la ficha ya trae la descripción de Bruxel, en su vista de idioma.
En el siguiente video, los webhooks: el aviso en tiempo real que tu sistema recibe de Bruxel.
Cómo funciona
Se instala un módulo en tu tienda. Él llama a Bruxel; Bruxel nunca entra a tu Magento. Van y vienen dos cosas, cada una en un sentido:
- De tu tienda a Bruxel: los productos — SKU, nombre, categoría y los atributos que elijas. Es la materia prima para generar.
- De Bruxel a tu tienda: el contenido ya publicado, escrito en la ficha del producto, en la vista de tienda que corresponde a cada idioma.
Tu tienda es la dueña del catálogo. Lo que ella manda (nombre, marca, categoría, atributos) pisa lo que haya en Bruxel; si editas esos campos en Bruxel, el siguiente envío desde la tienda los sobrescribe. Lo que Bruxel manda es el contenido generado, y nada más.
Qué hace falta
- Adobe Commerce o Magento Open Source 2.4.7, 2.4.8 o 2.4.9 — Cloud PaaS o servidor propio.
- Una llave de API de Bruxel (Cuenta → Llaves de API) con permisos de catálogo, atributos y exportación. La crea alguien con rol admin o propietario.
- Alguien con acceso técnico a la tienda: el módulo se instala con Composer y se configura desde el panel de administración de Magento.
- Los idiomas que Bruxel sincroniza son español, inglés, francés y portugués.
Los cuatro pasos de configuración
Todo se hace en el panel de Magento, en Stores → Configuration → Bruxel → Sincronización. El módulo se instala apagado: nada se mueve hasta que lo habilitas.
- Pega la llave de API. El botón «Probar conexión» confirma que responde y te dice a qué cuenta está entrando.
- Mapea cada idioma a sus vistas de tienda. Un idioma sin vistas mapeadas simplemente no se escribe: no es un error, es una decisión.
- Elige qué atributos de tu catálogo viajan a Bruxel como contexto para generar.
- Mapea los campos de contenido: qué campo de Bruxel se escribe en qué atributo de Magento. Los nombres de los campos son los de tu propia configuración de generación.
El aviso en tiempo real
Para que la tienda se entere en el momento en que publicas contenido, se registra un webhook en Bruxel (Cuenta → Webhooks) apuntando a la dirección del módulo, suscrito al aviso de descripción actualizada. Ese registro es manual en esta versión.
El primer sync, sin sustos
La primera vez que Bruxel escribe en un catálogo que ya tiene descripciones es el momento delicado. El módulo trae dos frenos puestos de fábrica:
- Un modo de prueba que enseña exactamente 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ó. Se apaga cuando ya revisaste el diff y decidiste.
Además, antes de escribir un campo por primera vez, el módulo guarda el valor que había. Hay un comando de restauración que lo devuelve, exactamente como estaba.
Qué productos viajan
Los que están habilitados y visibles en el catálogo. Con eso quedan fuera, a propósito, las variantes ocultas de un producto configurable: generarles contenido gastaría créditos en fichas que tu tienda no muestra. El configurable padre sí viaja, y una variante que sea visible por su cuenta también, indicando cuál es su padre.
Qué escribe en tu tienda, y qué no
- Escribe solo los atributos que mapeaste, y solo si son de texto y su alcance es «vista de tienda» — un atributo global no puede tener un valor por idioma.
- Nunca escribe la URL del producto. Cambiarla desde aquí dejaría la dirección anterior sin redirección, y esa es una forma silenciosa de perder tráfico.
- Nunca borra. Un campo que llega vacío, un producto sin contenido publicado o uno despublicado en Bruxel dejan tu ficha como está.
Lo que esta versión no cubre
- Tiendas con varios sitios web: el módulo escribe por vista de tienda, así que ese mapeo hay que revisarlo a mano.
- Adobe Commerce as a Cloud Service (la versión SaaS).
- Las imágenes no viajan hacia la tienda.
Cuando algo no cuadra
El módulo trae dos pantallas de diagnóstico en Magento, bajo System, y su propio archivo de registro. Casi todo se explica ahí:
| Lo que ves | Qué suele ser | Qué hacer |
|---|---|---|
| No llega nada a Bruxel | El módulo está deshabilitado, o el cron de Magento no corre | Revisa el interruptor y que el cron esté activo |
| La cola se llena y nada avanza | La llave dejó de servir y el módulo se pausó solo | Corrige la llave, pruébala y reanuda con el comando de la cola |
| Una fila falla y las demás siguen | Ese idioma no tiene vistas de tienda mapeadas | Mapéalo, o ignóralo si no vendes en ese idioma |
| Todas las filas fallan con el mismo error | El mapeo de campos tiene un atributo que no existe, no es de texto o no es por vista de tienda | El mensaje dice qué línea y qué cambiar |
| El contenido llega pero no se ve en la tienda | Falta reindexar o limpiar la caché | Espera al cron de indexadores o córrelo a mano |
| Dejaron de llegar avisos hace días | Bruxel desactivó el webhook tras varios fallos | Reactívalo en Cuenta → Webhooks; el módulo te lo advierte en su pantalla de cola |