Asistente de recuperación de carritos basado en inteligencia artificial para Magento 2
Recuperación inteligente de carritos abandonados
AI Cart Recovery Assistant for Magento 2 ayuda a las tiendas a recuperar pedidos incompletos de forma más eficaz sin gestionar manualmente campañas de follow-up. El módulo detecta automáticamente los carritos activos que no se han actualizado durante el periodo definido en la configuración y, a continuación, los guarda como potencialmente abandonados.
El siguiente paso es evaluar la intención de compra del cliente. El módulo puede analizar el carrito mediante OpenAI o, si la integración de AI no está activada, utilizar un mecanismo heurístico seguro. Se tienen en cuenta, entre otros factores, el valor del carrito, el número de productos, la fase del checkout y el contexto básico del cliente. Sobre esta base se calcula el intent score, es decir, la probabilidad de finalizar la compra, así como el motivo del abandono, por ejemplo, sensibilidad al precio, fricción en el checkout o comparación de ofertas.
E-mails personalizados para recuperar ventas
Cuando se supera el umbral mínimo de intención, el módulo genera mensajes de e-mail para recuperar el carrito. El contenido puede ser preparado por AI a partir del contenido del carrito y del motivo de abandono detectado, o mediante un mecanismo de fallback basado en mensajes predefinidos. El mensaje incluye un enlace seguro para restaurar el carrito y, opcionalmente, también un enlace al asistente de AI, que puede responder a las preguntas del cliente y ayudarle a completar la compra.
El módulo guarda los logs de envío, gestiona un contador de intentos fallidos y permite controlar el número máximo de errores. Gracias a ello, el proceso está automatizado, pero al mismo tiempo es predecible y fácil de supervisar por el equipo de la tienda.
Cupones de descuento dinámicos
En el caso de carritos con una intención de compra más baja y un valor de pedido adecuado, el módulo puede generar automáticamente un código de descuento de un solo uso. El importe del descuento se calcula en función del valor del carrito y de la evaluación de la intención, mientras que el límite máximo de descuento permanece bajo el control total del administrador. Esto permite proteger mejor el margen y activar el descuento solo cuando tiene un sentido empresarial real.
Asistente de AI para el cliente
Una de las características distintivas del módulo es el asistente de AI integrado y vinculado al carrito abandonado. El cliente puede abrir un enlace dedicado y hacer una pregunta sobre los productos, la elección de una variante o los beneficios de la compra. El módulo transmite al modelo de AI el contexto del carrito, la información de los productos e incluso datos sobre productos relacionados, de up-sell y de cross-sell. Las conversaciones se guardan en el panel de administración, lo que ofrece al equipo visibilidad sobre las objeciones de compra reales de los clientes.
Dashboard, analítica e integración técnica
En el panel de Magento, el administrador obtiene acceso a las secciones Dashboard, Recovery Analytics, Conversations y Email Logs. El módulo marca los carritos recuperados tras realizarse el pedido y presenta métricas básicas, como el número de carritos abandonados, el número de carritos recuperados, los ingresos recuperados, el número de e-mails enviados o el uso de cupones.
Para implementaciones más avanzadas, están disponibles comandos CLI y endpoints REST API. El módulo ejecuta tareas cron para detectar carritos, realizar scoring y enviar e-mails, por lo que encaja bien en la arquitectura estándar de automatización de Magento 2.
Principales beneficios
- detección automática de carritos abandonados
- scoring de carritos mediante AI o lógica heurística
- mensajes de e-mail personalizados para recuperar ventas
- restauración segura del carrito con un solo clic
- generación opcional de cupones de descuento de un solo uso
- asistente de AI que ayuda al cliente a cerrar la compra
- dashboard, analítica, logs de e-mails e historial de conversaciones
- REST API y CLI para integrarse con los procesos de la tienda
- configuración por tienda y compatibilidad con Magento 2
Módulo Magento 2 para recuperar carritos abandonados con funciones de:
- detección de carritos abandonados
- scoring del carrito mediante AI o heurística
- generación de mensajes de e-mail para recuperar el carrito
- generación opcional de cupones
- conversaciones con un asistente de compra de AI
- panel de administración y analítica
- endpoints REST API y comandos CLI
Resumen
El módulo ayuda a recuperar carritos abandonados en Magento 2 mediante la detección de carritos inactivos, la evaluación de la intención de compra y el envío de mensajes de e-mail con un enlace seguro para restaurar el carrito. Según la configuración, puede funcionar en dos modos:
- modo
heuristic, sin AI externo - modo
OpenAI, con análisis de AI, generación de contenido de e-mails y conversaciones con el asistente
Flujo de funcionamiento típico:
- El cliente añade productos al carrito.
- El cliente abandona la tienda sin realizar el pedido.
- Una vez transcurrido el tiempo de inactividad configurado, el carrito se marca como abandonado.
- El módulo asigna un scoring al carrito.
- Si la puntuación es suficientemente alta, se envía un e-mail de recuperación.
- El e-mail puede incluir un cupón de descuento y un enlace a la página del asistente de AI.
- Si el cliente vuelve y realiza el pedido, el carrito se marca como recuperado.
Requisitos
Antes de la instalación, asegúrese de que la tienda cumple los siguientes requisitos:
- Magento 2 con acceso a CLI
- cron de Magento funcionando correctamente
- envío de e-mails transaccionales configurado en Magento
- HTTPS activado en el storefront
- si se utiliza el modo AI: cuenta de OpenAI API con billing activo y clave API
Recomendaciones operativas:
- modo production para la tienda live
- plantilla de e-mail probada y remitente configurado correctamente
- política de privacidad que contemple el uso de servicios de AI, si está activado el modo OpenAI
Instalación
* = en producción, utilice la opción --keep-generated
Tipo: Composer
Añada el repositorio Composer a la configuración:
composer config repositories.ai.abandoned.cart vcs https://github.com/kowalco/ai-abandoned-cartAñada el token de acceso al repositorio privado de GitHub:
composer config --global --auth github-oauth.github.com Instale el módulo mediante Composer:
composer require kowal/module-ai-abandoned-cart
A continuación, ejecute:
bin/magento module:enable Kowal_AiAbandonedCartbin/magento setup:upgradebin/magento setup:di:compilebin/magento cache:flushChecklist posterior a la instalación
Después de la instalación, compruebe:
- si el módulo está activado en Magento
- si el esquema de la base de datos se ha instalado mediante
setup:upgrade - si el cron de Magento funciona correctamente
- si la tienda envía e-mails transaccionales
- si el storefront utiliza direcciones HTTPS correctas
Comandos de verificación útiles:
bin/magento module:status Kowal_AiAbandonedCartbin/magento cron:runbin/magento cache:flushConfiguración
Magento Admin:
Stores -> Configuration -> Kowal -> AI Abandoned Cart
Páginas de administración:
Marketing -> AI Abandoned Cart
Campos de configuración
Ajustes principales:
Enable ModuleActiva o desactiva todo el módulo.Cart Inactivity Threshold (minutes)Define tras cuántos minutos de inactividad un carrito activo debe considerarse abandonado.AI ProviderValores disponibles:Heuristic FallbackOpenAI
OpenAI API KeyRequerido solo cuandoAI Providerestá establecido enOpenAI.Minimum Intent ScoreSolo los carritos con una puntuación igual o superior a este valor cumplen los requisitos para el envío de un e-mail de recuperación.Enable Dynamic CouponsActiva la generación de cupones de un solo uso para los carritos abandonados seleccionados.Maximum Coupon DiscountDefine el límite superior del descuento porcentual generado automáticamente.Maximum Failed Email AttemptsDefine cuántos intentos de envío fallidos se permiten antes de que el módulo deje de reintentar el envío.Email Address for Message CopiesDestinatario BCC opcional para los mensajes de recuperación.Enable AI Assistant LinkSi la opción está activada, el e-mail de recuperación incluirá un enlace seguro a la página del asistente de AI.Conversation Expiration Time (minutes)Define durante cuánto tiempo permanece válido el enlace al asistente de AI.Batch SizeDefine cuántos carritos se procesan en una sola ejecución de detección, scoring y envío de e-mails.Cart Analysis PromptSe utiliza cuando el scoring de AI está activo.Email Generation PromptSe utiliza para generar el contenido de los mensajes de e-mail en modo AI.Conversation PromptLo utiliza el asistente de AI durante la conversación con el cliente.
Configuración inicial recomendada
Para empezar, un conjunto seguro de ajustes es:
Enable Module:YesCart Inactivity Threshold (minutes):30AI Provider:Heuristic FallbackoOpenAIMinimum Intent Score:0.45Enable Dynamic Coupons:YesMaximum Coupon Discount:5Maximum Failed Email Attempts:3Enable AI Assistant Link:YesConversation Expiration Time (minutes):1440Batch Size:100
Modo Heuristic frente a modo OpenAI
Modo Heuristic
Utilice este modo si desea empezar sin integración con AI externo.
En este modo, el módulo:
- detecta carritos abandonados
- calcula el intent score a partir de reglas de negocio integradas
- envía e-mails de recuperación
- puede generar cupones
- puede seguir ofreciendo la página del asistente, pero las respuestas se basarán en la lógica integrada en lugar de OpenAI
Modo OpenAI
Utilice este modo si busca una mayor personalización.
En este modo, el módulo puede además:
- analizar el contexto del carrito mediante OpenAI
- generar contenido de e-mails más personalizado
- gestionar conversaciones con el asistente de AI sobre los productos del carrito
- utilizar descripciones de productos, productos relacionados, up-sell y cross-sell en las respuestas
Configuración de OpenAI
Para activar el modo OpenAI:
- Cree una clave API en la cuenta de OpenAI Platform.
- En Magento Admin, vaya a
Stores -> Configuration -> Kowal -> AI Abandoned Cart. - Establezca
AI ProviderenOpenAI. - Pegue la clave en el campo
OpenAI API Key. - Guarde la configuración.
- Limpie la cache de Magento.
Información importante:
- las suscripciones de ChatGPT y el billing de API son cosas independientes
- el uso de la API lo factura OpenAI de forma independiente
- en modo AI, el prompt y el contexto del carrito se envían a OpenAI
Cron Jobs
El módulo utiliza los crones de Magento para el procesamiento automático.
Tareas cron configuradas:
kowal_ai_abandoned_cart_detectkowal_ai_abandoned_cart_scorekowal_ai_abandoned_cart_email
Su funcionamiento:
detect: busca carritos inactivos que cumplen los requisitos para considerarse abandonadosscore: calcula el intent score y el reason codeemail: envía e-mails de recuperación y guarda logs
Si el cron de Magento no funciona, el módulo no procesará automáticamente los carritos.
Primera prueba tras la configuración
Después de la instalación y la configuración, realice una prueba end-to-end completa:
- Abra el storefront como cliente no registrado.
- Añada uno o varios productos al carrito.
- Inicie el checkout e introduzca la dirección de e-mail.
- Abandone el checkout sin realizar el pedido.
- Espere hasta que transcurra el umbral de inactividad configurado.
- Ejecute el cron o los comandos CLI manualmente.
- Confirme que el carrito ha aparecido en el panel de administración.
- Confirme que se ha enviado el e-mail de recuperación.
- Abra el enlace de restauración del carrito desde el mensaje.
- Si la opción está activada, abra el enlace al asistente de AI y envíe un mensaje de prueba.
Secuencia CLI manual:
bin/magento kowal:ai:cart:detectbin/magento kowal:ai:cart:scorebin/magento kowal:ai:cart:send-emailsPáginas de administración
El módulo añade páginas de administración dedicadas en:
Marketing -> AI Abandoned Cart
Secciones disponibles:
DashboardVista general de los carritos detectados y recuperados.Recovery AnalyticsEstadísticas de eficacia de la recuperación y métricas operativas.ConversationsHistorial de conversaciones con el asistente de AI vinculadas a carritos abandonados.Email LogsRegistro de mensajes de recuperación enviados y fallidos.
Estas páginas son especialmente útiles durante la implementación, ya que permiten comprobar si la detección, el scoring, el envío de e-mails y el seguimiento de los carritos recuperados funcionan correctamente.
Contenido de los e-mails y experiencia del cliente
Cada e-mail de recuperación puede incluir:
- asunto personalizado
- contenido propio del mensaje
- resumen de los productos del carrito
- valor del carrito
- enlace seguro para restaurar el carrito
- cupón de descuento opcional de un solo uso
- enlace opcional al asistente de AI
Ruta del cliente:
- El cliente recibe un e-mail.
- El cliente hace clic en el enlace de restauración y vuelve al carrito guardado.
- El cliente puede abrir opcionalmente la página del asistente desde el mensaje.
- El asistente puede responder preguntas sobre productos, comparar opciones y dirigir al cliente de vuelta al checkout.
Cómo funcionan los cupones
Si los cupones dinámicos están activados, el módulo puede generar un cupón cuando:
- el valor del carrito es suficientemente alto
- el intent score sugiere que un descuento puede ayudar
- el descuento calculado no supera el máximo configurado
Reglas integradas actuales:
- los carritos por debajo de 100 unidades de la moneda de la tienda no reciben cupón
- los carritos con un intent score alto no reciben cupón
- los carritos con menor intención pueden recibir un descuento, normalmente del 3% o 5%, limitado por la configuración
Los cupones generados son:
- de un solo uso
- limitados por cliente
- vinculados a una regla de carrito compartida de Magento para el nivel de descuento y la tienda correspondientes
CLI
Puede ejecutar el módulo manualmente desde CLI, especialmente durante las pruebas y el diagnóstico.
bin/magento kowal:ai:cart:detectbin/magento kowal:ai:cart:scorebin/magento kowal:ai:cart:send-emailsSignificado de los comandos:
kowal:ai:cart:detectDetecta carritos abandonados.kowal:ai:cart:scoreAsigna scoring y reason code a los carritos.kowal:ai:cart:send-emailsEnvía mensajes de recuperación para los carritos que cumplen los requisitos.
Seguridad
Los enlaces para restaurar el carrito y acceder al asistente utilizan tokens firmados.
El payload del token contiene:
quote_idemailstore_idexpires_at
El token se valida mediante:
- verificación de la firma
- comprobación de la fecha de expiración
- verificación de la propiedad del carrito
Gracias a ello, el cliente recibe un enlace seguro vinculado a un carrito concreto y limitado en el tiempo.
Resolución de problemas
Los carritos no se detectan
Compruebe:
- si el quote sigue activo
- si el carrito contiene productos
- si el quote no tiene un pedido completado vinculado
- si se ha capturado la dirección de e-mail del cliente
- si ha transcurrido el umbral de inactividad
- si funciona el cron de Magento
Los carritos se detectan, pero los e-mails no se envían
Compruebe:
- si
Enable Moduleestá activado - si
Minimum Intent Scoreno está configurado demasiado alto - si el envío de e-mails funciona en Magento
- si no se ha alcanzado el límite de
Maximum Failed Email Attempts - si la dirección de e-mail asignada al carrito es correcta
El modo OpenAI está activado, pero no se utiliza el resultado de AI
Compruebe:
- si
AI Providerestá establecido enOpenAI - si
OpenAI API Keyestá completado correctamente - si el servidor permite conexiones salientes con la API de OpenAI
- si la cuenta de OpenAI tiene billing activo
Si la llamada a OpenAI falla, el módulo pasará al comportamiento heurístico integrado.
El enlace al asistente de AI se abre, pero las respuestas son generales
Compruebe:
- si el modo OpenAI está activo
- si el prompt de conversación está configurado correctamente
- si el enlace sigue siendo válido y no ha expirado
Notas para el uso en producción
Antes de lanzarlo en producción, conviene:
- comprobar el contenido de los mensajes de e-mail y el branding
- probar la política de cupones con reglas de negocio reales
- verificar los requisitos de privacidad y compliance
- probar los prompts de AI con el catálogo y el tono de comunicación de la tienda
- supervisar los primeros días de funcionamiento en
Dashboard,ConversationsyEmail Logs
Información necesaria al crear una solicitud de soporte
Al notificar un problema, prepare:
- versión de Magento
- versión de PHP
- modo de la tienda: developer o production
- información sobre si el cron funciona
- información sobre si el problema se produce en modo
heuristicoOpenAI - quote ID de ejemplo o dirección de e-mail del cliente afectado por el problema
- entradas correspondientes de los logs de excepciones o logs del sistema de Magento
En Toursport.pl, los clientes a menudo abandonan el carrito cuando dudan entre la talla, el uso del producto o la temporada: chaqueta para trekking, calzado para una ruta más larga, mochila con la capacidad adecuada. La decisión requiere la certeza de que el producto funcionará en condiciones concretas.
La instalación de Kowal AI Abandoned Cart permite recuperar ese momento de reflexión. El módulo envía un e-mail personalizado, recupera el carrito con un solo enlace y dirige al asistente de IA, que ayuda a comparar variantes y reduce el riesgo de aplazar la compra.
Tandembaits.com vende accesorios especializados y cebos para pescadores de carpas, por lo que un carrito abandonado a menudo no significa falta de interés, sino un momento para comparar el conjunto. El cliente puede estar revisando sabores de boilies, tamaños de anzuelos o la compatibilidad con su equipo.
Tras instalar el módulo Kowal AI Abandoned Cart, la tienda puede detectar automáticamente esos carritos, evaluar la intención de compra y enviar un mensaje con un enlace para volver. El asistente de IA ayuda a precisar la elección, y un cupón puede cerrar la compra sin aplicar un descuento agresivo.
En PCHB.pl, el carrito suele tener un valor elevado y la decisión de compra es más larga. El cliente puede abandonar el pedido porque vuelve al proyecto del baño, consulta el formato de los azulejos con el instalador o compara colecciones italianas y españolas del segmento premium.
Tras la instalación, Kowal AI Abandoned Cart actúa como un recordatorio discreto del vendedor. El módulo identifica el carrito, le asigna una puntuación y envía un mensaje elegante con un enlace seguro para volver. El asistente de IA puede ayudar con preguntas sobre el uso, el estilo y las colecciones alternativas.
En Hobbycenter24.pl, un carrito abandonado suele deberse a la necesidad de ajustar la réplica, los cargadores, la batería, el cargador o la protección ocular. El cliente está interesado en la compra, pero quiere evitar un conjunto incompleto o elementos incompatibles con el modelo elegido.
Tras implementar Kowal AI Abandoned Cart, la tienda puede recordar automáticamente el carrito y sugerir volver a la compra. El mensaje de recuperación lleva al carrito y al asistente de IA, que ayuda a resolver dudas técnicas, y el descuento puede activarse solo para carritos con una puntuación alta.
En Bikechill.pl, el cliente suele abandonar el carrito cuando compara el tipo de bicicleta, la talla del cuadro, los componentes o accesorios adicionales. La compra es técnica y estacional, por lo que un momento de duda puede deberse a la necesidad de confirmar si el modelo elegido se adapta a la ruta, la estatura y el estilo de conducción.
Kowal AI Abandoned Cart ayuda a retomar esa decisión sin presión. El módulo detecta un carrito abandonado, envía un mensaje con un enlace para volver y puede dirigir al cliente al asistente de IA, que responderá a preguntas sobre el ajuste, las variantes y los elementos del conjunto.


















