1. Creación de Rol de Usuario
El primer paso es crear un Rol de usuario específico para WoowUp.
Pasos:
Desde el panel de Magento, ingresar a System > Permissions > User Roles.
Clickear Add New Role.
En Role Information:
En Role Name, asignar un nombre descriptivo, por ejemplo:
WoowUp.En Your Password, ingresar la contraseña del administrador de Magento.
Ir a Role Resources.
En Resource Access, seleccionar All.
Guardar con Save Role.
Recomendación: otorgar acceso completo evita errores de permisos durante la integración y futuras ampliaciones del alcance.
2. Creación de Usuario
Una vez creado el rol, se debe crear un Usuario asociado a ese rol.
Pasos:
Ir a System > Permissions > All Users.
Clickear Add New User.
Completar los datos requeridos.
User Name y Password: serán las credenciales utilizadas por WoowUp (guardar esta información).
En Your Password, ingresar la contraseña de administrador de Magento.
En el menú izquierdo, ingresar a User Role.
Seleccionar el rol creado previamente (
WoowUp).Guardar con Save User.
Importante:
Una vez completados estos pasos, enviar al equipo de WoowUp la siguiente información:
Usuario
Contraseña
URL del panel de administración de Magento
El envío debe realizarse a: [email protected].
3. Estados de Venta en Magento
¿Dónde se visualizan?
En el panel de Magento, ir a Stores > Settings > Order Status.
Allí se listan los distintos estados disponibles.
¿Qué estados recomendamos?
WoowUp toma el estado desde el campo
STATEde Magento.Recomendamos descargar únicamente ventas que ya hayan sido facturadas, siendo
Completeel estado más habitual.Es posible que cada Magento tenga estados personalizados. En esos casos, se deben incluir solo aquellos que representen ventas cerradas y válidas.
No recomendamos incluir estados como Pending, Canceled o equivalentes, ya que pueden distorsionar métricas y automatizaciones.
4. Configuración de Magento 2 en WoowUp
Para ingresar las credenciales en WoowUp:
Ingresar a Configuración desde la barra superior.
En la sección Integraciones, seleccionar Magento.
Completar los siguientes campos:
Versión: 2
URL de la tienda Magento
Nombre de Usuario
Contraseña
Estados de venta a descargar
ID de tienda (solo si existen múltiples tiendas)
Tipo de productos a descargar
Descarga de categorías (opcional)
Extensión de carrito abandonado (opcional)
Guardar la configuración sin activar el switch de integración.
El switch de activación se enciende únicamente cuando el equipo de WoowUp valida que toda la configuración y los datos sean correctos.
5. Consideraciones sobre Requests y Servidor
Es importante asegurarse de que el servidor donde está alojado Magento pueda soportar las requests necesarias para la integración.
WoowUp realiza múltiples solicitudes para clientes, ventas, productos y carritos.
Ante infraestructuras con restricciones (ej. firewalls o límites de tráfico), se debe validar previamente la capacidad del servidor.
Este punto será revisado junto al equipo técnico del cliente durante el Onboarding.
6. Casos con Seguridad Avanzada (Token / Doble Factor)
En algunas cuentas Magento puede requerir:
Token fijo
Validación adicional de seguridad
[En proceso]
7. Endpoints Necesarios
El usuario creado debe tener acceso a los siguientes endpoints:
Clientes
Productos
Categorías
Tiendas
Carritos abandonados
Atributos
Stock (MSI)
8. Feed de productos y categorías
¿Por qué usamos un feed XML? Las categorías de Magento pueden estar desordenadas o no ser óptimas para marketing. Por eso, utilizamos un feed XML (Meta) como fuente alternativa.
El feed contiene productos y categorías.
Se utiliza principalmente para normalizar categorías.
Magento sigue siendo la fuente principal de productos, stock, precio lista y precio oferta.
Funcionamiento del feed
El cliente comparte un link único al feed XML.
Ese link se mantiene actualizado por el cliente.
WoowUp consume la información automáticamente desde la integración.
No es necesario forzar actualizaciones manuales.
Estructura del XML
[En proceso]
11. Activación de la Integración
Una vez:
Validadas las credenciales
Revisados los estados de venta
Confirmado el correcto acceso a los endpoints
El equipo de WoowUp activará la integración y comenzará el procesamiento de datos.
Ante cualquier duda o caso particular, el equipo de WoowUp acompaña la configuración durante todo el proceso de Onboarding para asegurar una integración exitosa.
Configuración para el recupero de carritos en Magento 2 (recomendado)
En Magento 2, el comportamiento nativo del recupero de carritos está basado en la sesión del navegador. Esto significa que el enlace de recupero enviado al cliente solo funciona correctamente si se abre desde el mismo dispositivo y navegador en el que se abandonó la compra.
Este comportamiento genera una limitación importante para los flujos de recupero de carritos vía WhatsApp o SMS, ya que en la mayoría de los casos el cliente abre el enlace desde su teléfono móvil, aun cuando el carrito fue abandonado desde una computadora. Como resultado, el cliente accede a un checkout vacío y la campaña pierde efectividad.
Por este motivo, recomendamos realizar esta configuración antes de activar campañas de recupero de carritos.
Para resolver este punto, existe un plugin gratuito para Magento 2 que permite que el contenido del carrito quede codificado directamente en la URL de recupero, en lugar de depender de la sesión del navegador.
Con este plugin instalado:
El carrito queda asociado al enlace.
El cliente puede abrir el link desde cualquier dispositivo o navegador.
Los productos se mantienen exactamente como fueron abandonados.