Guía de integración con Magento
Tajo se conecta a Adobe Commerce (Magento 2) mediante la API REST de Commerce. No hay ninguna extensión de Tajo que instalar en el código de tu Magento: la conexión usa un token de integración, así que el pipeline de despliegue de tu tienda queda intacto.
Hoy Magento es una conexión que se monta durante el onboarding: a diferencia de Shopify y WooCommerce, todavía no es autoservicio, y tu equipo de Tajo configura la sincronización como parte del onboarding. El estado de implementación del conector indica en qué punto está. La preparación en la tienda que verás abajo es todo lo que Magento necesita por tu parte, y funciona con un Magento estándar, sin cambios de código.
Requisitos previos
- Adobe Commerce / Magento Open Source 2.4+
- Acceso de administrador para crear un token de integración
- HTTPS en tu tienda (obligatorio para la autenticación por token)
- Cuenta de Tajo con una suscripción activa
Paso 1: crea un token de integración de Magento
- En el panel de administración de Magento, ve a System → Extensions → Integrations → Add New Integration.
- Ponle el nombre
Tajo, introduce tu contraseña de administrador y, en API, concede acceso de lectura a los recursos Customers, Sales y Catalog. - Guarda, luego activa la integración y copia el Access Token.
Tajo se autentica con Authorization: Bearer <access token> contra la URL base REST de tu tienda (https://yourstore.com/rest/V1/).
Paso 2: entrega la conexión a tu equipo de Tajo
Comparte esto con tu contacto de onboarding en Tajo:
| Campo | Valor |
|---|---|
| URL de la tienda | https://yourstore.com |
| Access token | El token de integración del paso 1 |
La conexión se valida con una petición de solo lectura antes de que empiece cualquier sincronización. Puedes rotar el token en Magento cuando quieras para revocar el acceso.
Qué sincroniza una conexión de Magento
- Clientes, campos de identidad y metadatos de la cuenta para resolver contactos; el consentimiento de marketing nunca se deduce de que exista una cuenta
- Pedidos, historial de compra, totales, moneda, estado y líneas de pedido para segmentar por ciclo de vida y crear automatizaciones de recuperación
- Productos y categorías, la estructura del catálogo para segmentar por interés y crear campañas basadas en productos
La importación histórica se ejecuta primero y, después, la sincronización incremental mantiene Tajo al día consultando los registros modificados. Los eventos de tienda en tiempo real (carritos, pagos en curso) requieren una extensión instalada en la tienda, algo que Magento no tiene hoy. Las automatizaciones basadas en pedidos siguen funcionando por completo a través de la sincronización.
Automatización de marketing
Las automatizaciones (email, SMS, WhatsApp mediante Brevo y otros proveedores) se configuran en Tajo con los datos sincronizados, por ejemplo seguimientos posteriores a la compra en pedidos nuevos, recuperación de clientes inactivos y campañas por interés de producto a partir del historial de categorías.
Resolución de problemas
| Síntoma | Causa y solución |
|---|---|
| 401 desde la tienda | El token de integración se regeneró o la integración se desactivó. Vuelve a activarla y actualiza el token en Tajo |
| Los clientes se sincronizan, pero los pedidos no | A los permisos de la API de la integración les falta el recurso Sales |
| La importación inicial es lenta | Las tiendas grandes se importan por páginas; tu contacto de Tajo puede informarte del progreso en cualquier momento |
Siguientes pasos
- Referencia del conector de Magento, estado de implementación y notas técnicas
- Sincronización de clientes, cómo mapear los clientes de Magento en tu sistema de registro