Integración con Magento
Conecta tu tienda Magento 2 mediante la extensión Joryio Connect. Sincroniza productos, pedidos, clientes y carritos, registra el comportamiento de la tienda y recupera carritos abandonados.
Funciones
- Extensión instalada con Composer: módulo nativo de Magento 2; no requiere OAuth.
- Sincronización automática: productos, pedidos, clientes y carritos llegan a Joryio cada minuto.
- Importación histórica: al conectar se importan productos, clientes y pedidos existentes - los últimos 90 días de forma predeterminada - .
- Recuperación de carritos abandonados: detecta carritos abandonados y envía enlaces que los restauran.
- Seguimiento de la tienda: vistas de página, vistas de producto, añadido al carrito y eventos de checkout.
- Captura de identidad: identifica clientes automáticamente desde inicio de sesión, suscripción al boletín y checkout.
- Atribución de ingresos: los pedidos se atribuyen a la campaña o recorrido que los generó.
- Disparadores de catálogo: los cambios de inventario y precio activan los disparadores de vuelta a stock y bajada de precio.
Requisitos previos
- Magento Open Source o Adobe Commerce 2.4.x.
- Acceso por línea de comandos a tu servidor Magento con Composer.
- Cron de Magento configurado y en ejecución: la extensión entrega eventos mediante cron, por lo que es imprescindible.
- Acceso HTTPS saliente desde el servidor Magento a Joryio.
Pasos de configuración
Paso 1: obtener la URL del servidor y la clave API
- En Joryio, ve a Configuración → Integraciones → Magento.
- Copia la URL del servidor.
- Haz clic en Generar clave API y cópiala; empieza por
jry_mg_.
Paso 2: instalar la extensión
Descarga el archivo ZIP de la extensión (joryio-connect-magento2.zip) mediante Descargar extensión en la página de integración de Magento del panel. Extráelo y ejecuta estos comandos desde la raíz de Magento:
composer config repositories.joryio path /path/to/joryio-connect
composer require joryio/module-connect
bin/magento module:enable Joryio_Connect
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
Como alternativa, sin Composer, extrae el ZIP en app/code/Joryio/Connect y ejecuta los mismos comandos bin/magento.
Paso 3: conectar
- En la administración de Magento, ve a Tiendas → Configuración → Joryio.
- Pega la URL del servidor y la clave API del paso 1.
- Haz clic en Conectar.
La extensión crea automáticamente un token de acceso de integración de Magento y lo comparte de forma segura con Joryio. No necesitas crear tokens manualmente. Joryio valida la conexión e inicia de inmediato una sincronización histórica completa: primero productos, después clientes y, por último, pedidos - los últimos 90 días de forma predeterminada - .
Al terminar, el estado aparece como Conectada tanto en la administración de Magento como en el panel de Joryio.
Qué se sincroniza
| Datos | Cómo | Cuándo |
|---|---|---|
| Productos | Importación histórica y actualizaciones en tiempo real, incluidos inventario y precio | Al conectar y después continuamente |
| Clientes | Importación histórica y actualizaciones en tiempo real | Al conectar y después continuamente |
| Pedidos | Importación histórica - últimos 90 días por defecto - y actualizaciones en tiempo real | Al conectar y después continuamente |
| Carritos | Seguimiento en tiempo real y detección de abandono | Continuamente |
| Identidad | Inicio de sesión, boletín y email del checkout | Continuamente |
Las actualizaciones en tiempo real se ponen en cola localmente en la tienda y un cron que se ejecuta una vez por minuto las entrega a Joryio. Por eso es esencial que el cron de Magento funcione correctamente. Las actualizaciones de inventario y precio también alimentan los disparadores de catálogo: vuelta a stock y bajada de precio.
Seguimiento de la tienda
La extensión añade un pequeño fragmento de seguimiento a tu tienda - activado de forma predeterminada; puedes desactivarlo en Tiendas → Configuración → Joryio - . Registra:
| Evento | Descripción |
|---|---|
| Vista de página | Cada visita a una página |
| Producto visto | Cuando se consulta una página de producto |
| Añadir al carrito | Artículos añadidos al carrito |
| Checkout iniciado | Cuando comienza el checkout |
| Identificar | Captura de email |
El fragmento también captura parámetros UTM e ID de clic de Joryio de los enlaces de campaña, para atribuir los pedidos a la campaña o recorrido que generó la venta. Consulta Atribución de ingresos.
Recuperación de carrito abandonado
- La extensión registra los carritos mientras compran los clientes.
- Tras 60 minutos de inactividad - configurable - , el carrito se marca como abandonado.
- Joryio recibe el carrito con una URL de recuperación.
- Usa un recorrido para enviar mensajes de recuperación con el enlace de restauración.
Cuando un cliente selecciona el enlace de recuperación (https://tu-tienda.com/joryio/cart/restore?token=...), su carrito se restaura con todos los artículos y puede ir al checkout de inmediato.
Solución de problemas
Los eventos se quedan atascados o no llega nada a Joryio
Casi siempre se debe a que el cron de Magento no se está ejecutando. La extensión pone los eventos en cola localmente y un cron por minuto los entrega; sin cron no se envía nada.
- Comprueba que el cron esté configurado:
bin/magento cron:installo revisa tu crontab. - Ejecútalo manualmente para probarlo:
bin/magento cron:run. - Revisa
var/log/joryio.logen la raíz de Magento para ver errores de entrega.
«Clave API no válida» o claves que no coinciden
- La clave debe empezar por
jry_mg_y coincidir con la que se muestra en Configuración → Integraciones → Magento en Joryio. - Generar una clave nueva invalida la anterior. Vuelve a pegar la clave más reciente en la administración de Magento y haz clic en Conectar.
- Comprueba que copiaste exactamente la URL del servidor.
Faltan datos históricos
- Los pedidos anteriores a la ventana de sincronización - 90 días de forma predeterminada - no se importan.
- La sincronización histórica se ejecuta en orden: productos, clientes y pedidos. Una tienda grande puede tardar en terminar.
El seguimiento no funciona
- Comprueba que el interruptor del fragmento de seguimiento esté activado en Tiendas → Configuración → Joryio.
- Ejecuta
bin/magento cache:flushdespués de cambiar el interruptor; la caché de página completa puede servir páginas antiguas. - Comprueba en las herramientas de desarrollo del navegador que se cargue el fragmento.