Módulo Magento 2 – Consulta sobre el producto

Kowal_ZapytajOProdukt es un módulo avanzado de Magento 2 para la comunicación con el cliente en la ficha de producto. Combina un formulario clásico de preguntas, una FAQ ordenada y un Asistente AI en una solución única y coherente.

En la práctica, esto significa que la ficha de producto deja de ser solo un lugar para presentar la descripción y los parámetros técnicos, y se convierte en un punto activo de atención a las preguntas del cliente. El usuario puede:

• hacer una pregunta clásica sobre el producto,
• consultar respuestas ya publicadas en la FAQ,
• hablar con el Asistente AI, que responde en el contexto del producto que se está visualizando.

El módulo se ha diseñado para resolver dos problemas al mismo tiempo:

• operativo, es decir, reducir el número de preguntas repetitivas que llegan al equipo de la tienda,
• de producto, es decir, crear una base de conocimiento creciente y ordenada que, con el tiempo, mejora la calidad de las respuestas.

Objetivo de negocio

En muchas tiendas online, una parte importante de las preguntas de los clientes se repite:

• si el producto es compatible con una versión concreta de Magento,
• si funciona sin un módulo adicional,
• cómo se realiza la instalación,
• si admite varios idiomas,
• si requiere cambios no estándar en la plantilla,
• cómo se comportará en un escenario de negocio concreto.

Sin una herramienta de atención dedicada, este tipo de preguntas:

• sobrecargan el soporte,
• ralentizan las decisiones de compra,
• dispersan el conocimiento entre buzones de e-mail, tickets y conversaciones comerciales,
• no vuelven a la tienda en forma de una FAQ ordenada.

Este módulo organiza ese proceso. Primero recopila preguntas y respuestas, después las ordena en una FAQ y, en una fase posterior, las utiliza como contexto para el Asistente AI y la capa de retrieval basada en OpenAI Vector Store.

Idea principal de la solución

El módulo funciona por capas.

Capa 1. Preguntas clásicas sobre el producto

En la ficha de producto se puede activar un mecanismo estándar para hacer preguntas. El cliente envía una consulta y el administrador o el equipo de la tienda la recibe para gestionarla. Es la forma de contacto más sencilla y predecible.

Capa 2. FAQ

Las preguntas y respuestas repetitivas pueden guardarse y publicarse como FAQ del producto. La FAQ puede mostrarse como una pestaña o como una sección independiente en la página de producto. De este modo, los siguientes usuarios obtienen la respuesta sin necesidad de enviar una nueva pregunta.

Capa 3. Asistente AI

Encima o debajo de la FAQ estándar aparece un componente ligero de conversación con AI. El usuario puede:

• hacer clic en una de las preguntas populares,
• escribir su propia pregunta en el campo Zapytaj Asystenta o ten produkt.,
• ver la respuesta en la misma zona de conversación.

El asistente no funciona como un chatbot general de la tienda. Se ha diseñado como asistente de producto, lo que significa que la respuesta debe basarse principalmente en:

• los datos del producto actual,
• las FAQ publicadas,
• el historial de la conversación actual,
• opcionalmente, los resultados de retrieval de OpenAI Vector Store.

Alcance funcional del módulo

1. Formulario Zapytaj o produkt

El módulo proporciona un mecanismo clásico de contacto con el cliente.

Elementos más importantes:

• botón o formulario Zapytaj o produkt en la página de producto,
• gestión AJAX en el frontend,
• guardado de la pregunta en la base de datos,
• posibilidad de enviar una notificación por e-mail,
• opción de activar el módulo globalmente o solo para productos seleccionados.

Esta solución sigue teniendo sentido incluso cuando la tienda ya utiliza el Asistente AI. No todas las preguntas deben gestionarse automáticamente. Algunos casos requieren una respuesta comercial, una valoración individual o confirmación por parte del equipo técnico.

2. FAQ en la ficha de producto

La FAQ en este módulo no es un complemento de marketing, sino una capa ordenada de conocimiento sobre el producto.

El administrador puede:

• revisar las preguntas guardadas,
• añadir respuestas,
• publicar registros seleccionados,
• mostrarlos en la página de producto.

La FAQ puede mostrarse:

• como una pestaña,
• como una sección independiente en la ficha de producto.

Lo importante es que la FAQ no sirve solo al frontend. Las preguntas y respuestas publicadas también se utilizan como uno de los elementos de contexto más importantes para el Asistente AI.

3. Asistente AI en la página de producto

El Asistente AI es el elemento central de la ampliación del módulo.

El componente está incrustado en la ficha de producto, por defecto debajo de la galería, y se ha preparado para:

• funcionar de forma ligera en el frontend,
• no cargar innecesariamente el primer renderizado de la página,
• ser legible en desktop y mobile,
• estar preparado para futuras ampliaciones.

El usuario ve:

• el título de la sección,
• un texto introductorio,
• un único campo de texto para plantear la pregunta,
• una lista de las preguntas más populares,
• un área de conversación que se desarrolla con las siguientes preguntas y respuestas.

En la versión actual, el formulario también admite:

• historial de conversación dentro de la sesión,
• preguntas populares clicables,
• feedback para las respuestas de AI,
• dos variantes de color: clara y oscura.

4. Preguntas populares

Debajo del campo de texto pueden mostrarse las preguntas más populares sobre el producto.

Esta solución cumple varias funciones a la vez:

• acelera el inicio de la conversación,
• sugiere al cliente qué preguntan con más frecuencia otros usuarios,
• permite aprovechar respuestas FAQ ya preparadas sin coste de consulta al modelo AI,
• mejora la UX y reduce el número de interacciones vacías.

La popularidad de las preguntas ya no se basa solo en un orden manual. El módulo recopila datos sobre clics, preguntas realizadas y feedback, y luego clasifica la FAQ en función de ellos.

5. Contexto de la respuesta AI

La premisa de diseño más importante fue que la AI no respondiera desconectada del producto.

La respuesta puede construirse a partir de varias fuentes:

• datos básicos del producto,
• short description,
• full description,
• atributos de producto seleccionados,
• FAQ publicadas,
• historial de conversación.

Además, el módulo permite limitar qué atributos llegan al modelo, lo que ayuda a evitar:

• sobrecargar el prompt,
• enviar datos innecesarios,
• un coste de tokens demasiado alto,
• la transmisión accidental de contenidos que no son útiles para el cliente.

6. Integración con OpenAI Responses API y Vector Store

Uno de los elementos clave de la ampliación es la integración con OpenAI Responses API.

En escenarios más sencillos, el módulo puede funcionar en modo de contexto local del producto y de la FAQ. En implementaciones más avanzadas, admite:

• file_search,
• vector_store_ids,
• filtrado por sku,
• filtrado por product_sku,
• filtrado por store_code,
• filtrado por content_type,
• limitación del número de resultados de retrieval,
• modo hybrid,
• modo retrieval-first.

Esto significa que la respuesta AI puede basarse no solo en los datos enviados directamente desde Magento en una request concreta, sino también en documentos ya cargados previamente en Vector Store.

En la práctica, esto aporta dos ventajas:

• menor coste, porque no es necesario enviar cada vez todo el conjunto de datos al modelo,
• mejor escalabilidad, porque el retrieval puede gestionar una base de conocimiento mayor que un prompt simple con JSON local.

7. Integración con Kowal_AiProductFeed

El módulo se ha preparado para trabajar con Kowal_AiProductFeed.

Esta integración permite:

• sincronizar datos de producto con OpenAI Vector Store,
• utilizar documentos de tipo product.core, product.faq, product.docs y otros,
• resincronizar un producto seleccionado antes de la conversación,
• limitar el retrieval a tipos de contenido concretos.

Este enfoque es especialmente útil cuando:

• las descripciones de producto son largas,
• la FAQ es extensa,
• la tienda gestiona muchos productos técnicos,
• los datos de producto se desarrollan de forma continua.

8. Analítica y feedback

El módulo no termina en la simple generación de la respuesta.

También guarda datos que permiten evaluar si la solución funciona:

• número de clics en la FAQ,
• número de preguntas realizadas,
• valoraciones útil / no útil,
• historial de conversaciones,
• metadatos técnicos de la respuesta AI,
• usage de tokens,
• payload de la request y de la respuesta, si activas el registro diagnóstico.

Esto hace que la implementación no sea una caja negra. El equipo puede analizar:

• qué preguntas aparecen con más frecuencia,
• si la AI utiliza retrieval,
• si las respuestas son acertadas,
• qué registros merece la pena consolidar como FAQ,
• cómo cambian el coste y la calidad tras modificar el prompt o la configuración.

9. Candidatos FAQ y workflow administrativo

Una de las ventajas más importantes del módulo es la posibilidad de convertir conversaciones en nuevas FAQ.

El proceso es el siguiente:

1. Los clientes hacen preguntas.
2. El módulo guarda las conversaciones.
3. El mecanismo de análisis identifica candidatos FAQ.
4. El administrador revisa los candidatos en el panel.
5. Tras la aceptación, el candidato pasa a la FAQ estándar del producto.

Es un modelo de trabajo muy práctico, porque el conocimiento no se pierde en el historial de conversaciones. Con cada iteración, la tienda crea una mejor capa de respuestas:

• para los clientes,
• para la FAQ,
• para el Asistente AI,
• para el retrieval futuro.

10. Seguridad y control

El módulo se ha preparado para que su funcionamiento pueda controlarse.

La configuración incluye, entre otros:

• restricciones de acceso para invitados,
• TTL de conversaciones,
• límites de consultas,
• sanitización de datos de entrada,
• opciones de registro diagnóstico,
• configuración de reCAPTCHA,
• alcance controlado de los datos enviados al modelo.

Esto es importante porque implementar AI en la página de producto no debería significar perder el control sobre:

• el coste,
• los datos,
• la calidad de las respuestas,
• la carga del frontend.

11. Para quién es este módulo

El módulo encaja especialmente bien en proyectos donde:

• el catálogo es mayor que unos pocos productos simples,
• los clientes preguntan con frecuencia por compatibilidad, configuración o implementación,
• el equipo quiere combinar una FAQ clásica con una capa AI moderna,
• la empresa desarrolla documentación de producto y quiere utilizarla en retrieval,
• es importante controlar qué sabe la AI y de dónde toma las respuestas.

Encaja especialmente bien en tiendas que venden:

• módulos Magento,
• productos técnicos,
• soluciones B2B,
• herramientas que requieren implementación o configuración,
• productos para los que el cliente espera una respuesta rápida y precisa antes de comprar.

12. Resumen

Kowal_ZapytajOProdukt ya no es solo un módulo para un formulario de contacto sencillo en la ficha de producto.

Es una capa completa de comunicación de producto que:

• recopila preguntas,
• publica FAQ,
• responde mediante AI,
• utiliza Vector Store,
• analiza conversaciones,
• y las convierte en una base de conocimiento de la tienda cada vez mejor.

Gracias a ello, la ficha de producto se convierte en un espacio real de conversación con el cliente, y no solo en una página estática con descripción y precio.