AI Review Pros/Cons Synthesizer – Guía completa

El módulo AI Review Pros/Cons Synthesizer lee las reseñas de los clientes de un producto y genera mediante IA un resumen en forma de insignias de Pros y Contras mostradas directamente en la ficha de producto. Las síntesis se almacenan en caché por producto, idioma y tienda, y se actualizan automáticamente mediante un cron.

Presentación

Cuando una ficha acumula cientos de reseñas, pocos visitantes las leen. El módulo condensa esa señal en unas pocas insignias claras, con una línea de resumen neutral y un contador de menciones. Se admiten tres proveedores de IA: Mistral AI, OpenAI y Anthropic (Claude). Cada síntesis se produce en el idioma de la ficha, lo que conviene a los catálogos multiidioma.

Requisitos

• PrestaShop 8.0 a 9.x (mono o multitienda).
• PHP 7.4 a 8.x con la extensión cURL activada.
• Una fuente de reseñas: el módulo oficial Product Comments o DataFirefly Reviews.
• Una clave API de un proveedor de IA (Mistral, OpenAI o Anthropic).

Instalación

1. En el back office, abra Módulos > Gestor de módulos > Subir un módulo.
2. Seleccione el archivo dfreviewsynth.zip e instálelo.
3. Haga clic en Configurar para acceder a los ajustes.

Configuración

Proveedor de IA y clave API

Elija el proveedor (Mistral, OpenAI o Anthropic), pegue su clave API e indique el modelo deseado:

• Mistral: mistral-small-latest
• OpenAI: gpt-4o-mini
• Anthropic: claude-haiku-4-5

Fuente de reseñas

Seleccione el origen de las reseñas. El adaptador Product Comments lee los comentarios aprobados y no eliminados. El adaptador DataFirefly Reviews lee las reseñas activas; ajuste el nombre de las columnas en la clase de acceso a datos si su esquema difiere.

Posición de visualización

Hay dos posiciones disponibles en la ficha de producto: bajo la descripción corta (información adicional) o en el pie de la ficha.

Umbrales y caché

• Reseñas mínimas: por debajo de este número, no se genera ninguna síntesis.
• Insignias máximas por lado: limita el número de Pros y Contras mostrados.
• Reseñas máximas enviadas a la IA: limita el consumo de tokens (se priorizan las reseñas más recientes).
• TTL de la caché (días): usado por el cron para actualizar las síntesis obsoletas.

Generar las síntesis

Consola de administración

En la página de configuración, la consola permite cargar los productos elegibles (los que alcanzan el umbral mínimo de reseñas) y luego generar las síntesis de una en una o en bloque, con barra de progreso. La generación se ejecuta en el idioma actual del back office.

Cron multiidioma

Para mantener todos los idiomas actualizados automáticamente, programe una llamada periódica a la URL de cron mostrada en la configuración:

/index.php?fc=module&module=dfreviewsynth&controller=cron&token=SU_TOKEN&limit=20

El parámetro limit limita cuántos productos se procesan por ejecución (predeterminado 20, máximo 100). El cron recorre cada idioma activo y solo regenera las síntesis ausentes, en error u obsoletas.

Visualización en la tienda

En la ficha de producto, el módulo muestra un bloque «Lo que dicen los clientes» con dos columnas (Pros en verde, Contras en naranja), una línea de resumen neutral opcional, el número de reseñas tenidas en cuenta y un contador de menciones por insignia. Se puede mostrar un aviso de «resumen generado por IA» para mayor transparencia con los clientes.

Catálogo multiidioma

Cada síntesis se almacena por producto, idioma y tienda. El contenido se genera en el idioma de la ficha, y el cron sincroniza todos los idiomas activos. Una síntesis solo se regenera cuando cambia el contenido de las reseñas (detección por huella) o cuando la caché caduca.

Resolución de problemas

• No se muestran insignias. Compruebe que el producto alcanza el número mínimo de reseñas y que se ha generado una síntesis (consola o cron).
• Estado «error» en la consola. Verifique la clave API, el nombre del modelo y la disponibilidad de cURL; el detalle del último error se conserva en la caché.
• Reseñas no detectadas. Confirme la fuente seleccionada y, para DataFirefly Reviews, la correspondencia de columnas en el adaptador.

Registro de cambios

• 1.0.0 — Primera versión pública: síntesis de Pros / Contras por IA (Mistral, OpenAI, Anthropic), caché multiidioma, consola de administración y cron de actualización.