- Blog de Bruxel.AI
- Integraciones de Bruxel: API pública, webhooks, Adobe Commerce y dominio propio
Integraciones de Bruxel: API pública, webhooks, Adobe Commerce y dominio propio
Por Manuel Mattar4 min de lectura
En resumen
Bruxel se conecta con tus sistemas por cuatro vías: una API REST con llaves por permisos, webhooks firmados que avisan cuando algo cambia, un módulo para Adobe Commerce que recibe el contenido publicado y la opción de entrar desde un subdominio de tu empresa. Cada llamada y cada aviso quedan registrados.
El problema: el PIM que nadie ve
Un catálogo bien trabajado sirve de poco si llega tarde a la tienda, si alguien tiene que entrar a revisar si ya terminó un lote o si el ERP se entera de los cambios por un archivo que se manda el viernes. Integrar no es lujo: es lo que hace que el trabajo del equipo llegue a donde se vende.
El módulo Integraciones de Bruxel reúne las piezas para eso, en el menú Canales: Sistemas conectados, Webhooks, Llaves de API y Dominio propio.
Cómo funciona en Bruxel, paso a paso
1. La API pública
La API es REST y vive documentada en el portal de desarrolladores, con referencia, ejemplos en curl, Python y JavaScript y un registro de cambios. Con ella tu sistema puede empujar productos, leer y escribir atributos, generar descripciones —una a una o en lotes asíncronos con llave de idempotencia—, exportar el catálogo en CSV por idioma, leer los canales y saber si un producto sale completo en cada uno.
Cada llamada lleva una llave de API como Bearer token. Las llaves se crean en Canales → Llaves de API, las crea un administrador o el propietario, se muestran una sola vez y cada una lleva solo los permisos (scopes) que necesita: leer el catálogo, escribirlo, generar, exportar, leer canales. Sin el permiso, la API responde 403. En cada llave, «Ver llamadas» enseña lo que pidió o escribió sobre cada producto.
2. Webhooks
Un webhook es una dirección tuya a la que Bruxel avisa cuando pasa algo: una descripción quedó lista, una ficha cambió. Al registrarlo eliges qué eventos escuchar, y cada aviso va firmado con un secreto que se muestra una sola vez; si se pierde, se rota y el anterior deja de servir.
Si tu dirección no responde, Bruxel reintenta, y cada webhook muestra su último éxito, su último error y cuántos fallos lleva seguidos. «Ver entregas» enseña cada intento: qué se mandó, qué contestó tu dirección y cuánto tardó, con lo que parece una credencial tapado antes de guardar. «Reenviar» manda otra vez el mismo aviso. La guía de webhooks tiene el detalle.
3. Sistemas conectados
En «Sistemas conectados» registras los sistemas de tu operación —tu tienda, tu ERP, tu almacén— con la llave con la que llaman y el endpoint al que Bruxel les avisa. La pantalla dice cuándo llamó cada uno por última vez, cuántos avisos tiene por entregar y si su canal está sano. Los flujos de Bruxel los reconocen por su clave. La ve un operador para arriba, y es una función que se activa por cuenta.
4. Adobe Commerce con Bruxel_Sync
Si tu tienda es Adobe Commerce o Magento Open Source 2.4.7, 2.4.8 o 2.4.9, el módulo Bruxel_Sync se instala con Composer y se configura en el panel de Magento. El módulo llama a Bruxel; Bruxel nunca entra a tu tienda. La tienda manda SKU, nombre, categoría y los atributos que elijas; Bruxel devuelve el contenido ya publicado, en la vista de tienda de cada idioma.
El primer sync es el momento delicado, y por eso el módulo trae dos frenos de fábrica: un modo de prueba que enseña qué cambiaría sin escribir nada, y una opción que no pisa los campos con texto que Bruxel nunca tocó. Antes de escribir un campo por primera vez guarda el valor anterior, y un comando lo restaura. La guía de Adobe Commerce cuenta los cuatro pasos de configuración.
5. Dominio propio
Tu equipo y tus proveedores pueden entrar desde un subdominio de tu empresa, como pim.tuempresa.com, con tu logo en la entrada y los enlaces de los correos apuntando ahí. Se pide al equipo de Bruxel desde el centro de ayuda; luego creas dos registros de DNS (un CNAME y un TXT) y pulsas «Verificar ahora». Cuesta 100 créditos al mes por dominio. La guía de dominio propio explica cada registro.
Para quién es
Un ejemplo hipotético: una distribuidora con su tienda en Adobe Commerce y un ERP propio. La tienda recibe las descripciones en cuanto se publican por Bruxel_Sync, el ERP escucha un webhook y relee la ficha cuando cambia, y los proveedores entran por el subdominio de la distribuidora.
Sirve a equipos que ya tienen sistemas y alguien técnico que pueda conectarlos.
Qué necesitas para empezar
- Alguien con rol de administrador o propietario para crear llaves y registrar webhooks.
- Una persona técnica del lado de tu sistema: para la API, para recibir avisos o para instalar el módulo en Magento.
- Para el dominio propio, acceso al DNS de tu empresa y saldo de créditos.
Límites honestos
- Las llaves de API no se acotan por marca ni por categoría: autorizan por permisos. Una llave con permiso de escribir atributos escribe en todo el catálogo.
- Un webhook se apaga solo tras varios fallos seguidos; hay que reactivarlo.
- Bruxel_Sync no cubre tiendas con varios sitios web sin revisar el mapeo a mano, ni Adobe Commerce as a Cloud Service. Las imágenes no viajan a la tienda, y el webhook del módulo se registra a mano en esta versión.
- Si usas Content Staging, una campaña programada pisa lo que Bruxel escribió; hay que volver a publicar después.
- El dominio propio lo da de alta el equipo de Bruxel por ahora, y la API pública y las páginas públicas se quedan en bruxel.ai.
Para ver el módulo completo, abre la hoja de Integraciones.
Preguntas frecuentes
¿Quién puede crear una llave de API?
Un administrador o el propietario de la organización. La llave se muestra una sola vez al crearla; Bruxel guarda solo su hash, así que si se pierde se revoca y se crea otra.
¿Qué pasa si mi sistema no contesta un webhook?
Bruxel reintenta. Tras varios fallos seguidos el webhook se apaga solo, y se vuelve a activar desde la misma pantalla cuando el destino ya responde.
¿El módulo de Adobe Commerce puede borrar mis descripciones?
No. Nunca borra ni escribe la URL del producto, y de fábrica no pisa los campos que ya tienen texto. Además trae un modo de prueba que muestra qué cambiaría sin escribir nada.
¿Puedo usar mi dominio raíz como dominio propio?
No. Funciona con un subdominio, como pim.tuempresa.com. Un dominio raíz a secas no se puede usar.
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
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.
· 4 min de lectura
Contenido con IA en Bruxel: voz de marca, generar y traducir
Cómo genera Bruxel las fichas de producto: la voz de marca que configuras, qué cuesta generar uno o en lote, cómo corregir un dato y cómo se traduce.