Módulo Magento 2 – Pregunta sobre el producto

MAGENTO 2 · PREGUNTAS · FAQ · ASISTENTE AI

Kowal Zapytaj o Produkt

Combina un formulario de contacto, FAQ publicadas y un asistente AI opcional. Utiliza los datos del producto y la base de conocimiento, y convierte las conversaciones repetitivas en respuestas disponibles para los siguientes clientes.

Formulario y FAQ · Contexto del producto · Conversaciones y feedback

CÓMO FUNCIONA EN LA PRÁCTICA

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, FAQ estructuradas 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,
• usar respuestas preparadas publicadas en las FAQ,
• hablar con el Asistente AI, que responde en el contexto del producto que se está viendo.

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

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

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, estas preguntas:

• sobrecargan el soporte,
• ralentizan las decisiones de compra,
• dispersan el conocimiento entre correos electrónicos, tickets y conversaciones comerciales,
• no vuelven a la tienda en forma de FAQ estructuradas.

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

El módulo funciona por capas.

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.

Las preguntas y respuestas repetitivas pueden guardarse y publicarse como FAQ del producto. Las FAQ pueden mostrarse como pestaña o como sección independiente en la página de producto. De este modo, las siguientes personas reciben la respuesta sin tener que enviar una nueva pregunta.

Encima o debajo de las 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 área 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.

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

Elementos principales:

• botón o formulario Zapytaj o produkt en la página de producto,
• gestión AJAX en el frontend,
• registro 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 asuntos requieren una respuesta comercial, una valoración individual o la confirmación del equipo técnico.

Las FAQ de este módulo no son un añadido de marketing, sino una capa estructurada de conocimiento sobre el producto.

El administrador puede:

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

Las FAQ pueden mostrarse:

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

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

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

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

• funcionar de forma ligera en el frontend,
• no sobrecargar innecesariamente el primer renderizado de la página,
• ser claro 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 formular la pregunta,
• una lista de las preguntas más populares,
• un área de conversación que se expande 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 sobre las respuestas AI,
• dos variantes de color: clara y oscura.

Bajo el 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 utilizar respuestas FAQ 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 después clasifica las FAQ en función de esa información.

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 se envían al modelo, lo que permite evitar:

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

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 de producto y 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 transmitidos directamente desde Magento en una request determinada, 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 todo el conjunto de datos al modelo cada vez,
• mejor escalabilidad, porque retrieval puede gestionar una base de conocimiento más grande que un prompt simple con JSON local.

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 retrieval a tipos de contenido concretos.

Este enfoque resulta especialmente útil cuando:

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

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

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

• número de clics en las 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 pertinentes,
• qué registros conviene consolidar como FAQ,
• cómo cambian el coste y la calidad tras modificar el prompt o la configuración.

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 para FAQ.
4. El administrador revisa los candidatos en el panel.
5. Tras la aceptación, el candidato pasa a las 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 nueva iteración, la tienda construye una mejor capa de respuestas:

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

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 las conversaciones,
• límites de consultas,
• sanitización de datos de entrada,
• opciones de registro diagnóstico,
• configuración de reCAPTCHA,
• control del alcance 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.

El módulo funcionará 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 FAQ clásicas 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 obtiene sus 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 en los que el cliente espera una respuesta rápida y precisa incluso antes de comprar.

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 cada vez mejor para la tienda.

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.

En Stores → Configuration → Zapytaj o produkt puedes empezar con el formulario y las FAQ, además de una dirección de e-mail adicional. Las funciones AI se activan por separado: configuras el provider, la clave API, el modelo, el alcance del contexto y las opciones de Vector Store. La integración con Kowal_AiProductFeed es opcional.

La AI requiere acceso a la API y su facturación independiente. La calidad de las respuestas y el coste dependen del contexto, del modelo y de la configuración. Las preguntas que requieren confirmación individual pueden llegar al equipo de la tienda mediante el formulario clásico.

El paquete incluye el Kowal_ZapytajOProduktHyva opcional para el formulario, las FAQ y el asistente AI. El adaptador está desactivado por defecto. Para Hyvä, lo activas adicionalmente y compruebas la ubicación de los componentes en el tema utilizado. La tienda Luma utiliza el módulo base.

Paquete kowal/module-zapytajoprodukt, módulo Kowal_ZapytajOProdukt. Tras configurar el acceso al repositorio Kowal, instala el paquete, activa el módulo, actualiza Magento y limpia la caché. En producción, incluye la compilación y el despliegue de contenido estático según el proceso de la tienda.

1. Configuras la comunicación
Activas el formulario, las FAQ y, opcionalmente, el asistente AI.

2. El cliente hace una pregunta
Utiliza preguntas preparadas o escribe la suya.

3. Desarrollas la base de conocimiento
Revisas las conversaciones y apruebas candidatos para FAQ.

El cliente pregunta por la compatibilidad del producto. El equipo responde mediante el formulario, y la pregunta repetitiva puede publicarse en las FAQ.

El asistente AI opcional utiliza los datos del producto, las FAQ y el Vector Store configurado. El administrador comprueba la calidad de las conversaciones y las propuestas de nuevas FAQ.