FAQ IA Producto — Guía completa de instalación y configuración
Instalar y configurar Product FAQ AI 4.0.0: conexión con Claude u OpenAI, ajustes de redacción, revisión de borradores, generación masiva con presupuesto, visualización accesible y datos estructurados.
Product FAQ AI redacta con IA (Anthropic Claude u OpenAI) las FAQ de sus fichas de producto de PrestaShop a partir únicamente de los datos de su catálogo. Las respuestas se guardan como borrador: usted las revisa, las corrige si es necesario y las valida antes de que aparezcan en la ficha, en un acordeón accesible con el teclado y sin JavaScript.
Versión 4.0.0. Módulo reescrito: PrestaShop 1.7.8, 8 y 9, PHP 7.1 a 8.5, back-office en 8 idiomas, borradores con revisión, generación masiva con estimación del coste y presupuesto, registro de consumo y 5 estilos de acordeón. La actualización desde la 3.x conserva sus FAQ, su orden, su visibilidad y sus ajustes.
Requisitos previos
- PrestaShop 1.7.8, 8.x o 9.x, tema Classic, Hummingbird o un tema que llame a alguno de los hooks de ficha de producto propuestos.
- PHP 7.1 a 8.5 con las extensiones cURL y OpenSSL (cifrado de la clave API).
- Una cuenta de Anthropic (console.anthropic.com) o de OpenAI (platform.openai.com) con una clave API. El proveedor factura las llamadas en su propia cuenta.
- El servidor debe poder realizar solicitudes HTTPS salientes hacia
api.anthropic.comoapi.openai.com.
Instalación y actualización
- En Módulos > Gestor de módulos, haga clic en Subir un módulo y seleccione
productfaqai-4.0.0.zip. - El módulo crea la tabla
ps_product_faqy tres tablas técnicas (ps_productfaqai_job,ps_productfaqai_job_item,ps_productfaqai_usage), registra sus hooks y un controlador de administración oculto. - Haga clic en Configurar: la pestaña Conexión IA le guía para introducir la clave API.
Actualización desde la 3.x. Suba el zip 4.0.0 sobre la versión anterior. No se elimina nada: una FAQ activa en la 3.x pasa a estar «publicada» y una FAQ inactiva pasa a ser un borrador. La clave API guardada en texto plano se cifra, los identificadores de modelo se sustituyen por modelos actuales (por ejemplo, claude-haiku-4-5-20251001 por claude-haiku-5-5 y gpt-4o-mini por gpt-6-luna), y la posición displayProductFooter, a la que no llaman ni Classic ni Hummingbird, pasa a displayFooterProduct si su tema no la utiliza.
Panel
El panel muestra la proporción de productos activos que tienen una FAQ publicada, el número de fichas con borradores por revisar, el gasto del mes en relación con su límite y el coste orientativo de 1.000 FAQ con el modelo elegido. La cobertura se detalla por idioma: FAQ publicada, solo borradores o sin FAQ.

Conexión con el proveedor de IA
El asistente consta de tres pasos: elegir el proveedor, pegar la clave y elegir el modelo. La clave se prueba primero mediante una llamada gratuita a la API Models del proveedor; solo se guarda si la prueba tiene éxito.

La clave se almacena cifrada (AES-256-GCM) en la base de datos. No vuelve a mostrarse nunca (solo se muestran los 4 últimos caracteres), nunca se envía al navegador y nunca se escribe en los registros. Para sustituirla, pegue una clave nueva.
Elección del modelo
La lista recoge los modelos disponibles en su cuenta, leídos a través de la API Models en el momento de la prueba. Los modelos recomendados muestran su precio público orientativo y el coste estimado para 1.000 FAQ con sus ajustes. Sin prueba, se propone una lista de respaldo.
- Anthropic:
claude-opus-5-5(por defecto, máxima calidad),claude-sonnet-5-5(equilibrado),claude-haiku-5-5(rápido y económico). - OpenAI:
gpt-6.1-sol(por defecto),gpt-6-astra,gpt-6.1-terra,gpt-6-luna,gpt-5.4-mini,gpt-5.4-nano.

El esfuerzo de razonamiento está configurado en «bajo» por defecto: redactar una FAQ a partir de una ficha de producto es una tarea sencilla, y un esfuerzo mayor aumenta el tiempo y el número de tokens.
Ajustes de redacción
Elija el número de preguntas por producto (de 1 a 15), la longitud de las respuestas (corta, media, detallada) y el tono (profesional, cercano, conversacional, técnico, entusiasta o tranquilizador). Puede indicar un público objetivo e instrucciones de estilo, por ejemplo «tratar al cliente de usted».

Las instrucciones de estilo no pueden anular las reglas del módulo: utilizar únicamente los datos de la ficha, no inventar nunca precios, plazos de entrega, garantías, certificaciones ni declaraciones de salud, y escribir en texto plano. Para una información comercial (garantía, devoluciones), escríbala en la descripción del producto o añada la pregunta a mano.
Datos enviados: el nombre, las descripciones corta y larga, las dimensiones y el peso se envían siempre; la categoría principal, la marca, las características y las combinaciones se envían según sus ajustes. Nunca se envía ningún dato de clientes, pedidos o empleados.
Productos nuevos: la opción «Añadir los productos nuevos a la cola de FAQ» no llama a la IA durante el guardado del producto; el panel muestra los productos pendientes y usted inicia la cola cuando lo desee. La publicación sin revisión es una opción independiente, desactivada por defecto.
Productos y editor de FAQ
La pestaña Productos y FAQ enumera los productos de la tienda con, para cada idioma, el número de preguntas publicadas o en borrador y los avisos. Filtre por productos sin FAQ, con borradores o con FAQ publicada.

El editor abre la FAQ de un producto en un idioma:
- Generar la FAQ: sustituye los borradores del idioma; las preguntas ya publicadas se conservan, salvo que usted pida sustituirlas.
- Regenerar una sola pregunta: la nueva versión, distinta de las demás preguntas, se guarda como borrador.
- Reordenar arrastrando y soltando o con las flechas, modificar, eliminar o añadir una pregunta a mano.
- Validar una pregunta, o Validar y publicar todo. Solo las entradas publicadas aparecen en la ficha de producto.

Avisos de verificación
Cada respuesta indica los datos de la ficha en los que se ha basado la IA. El módulo muestra un aviso cuando una cifra no aparece en los datos del producto, cuando la respuesta habla de garantía, entrega, devoluciones, certificación o salud y la ficha no dice nada al respecto, o cuando no se cita ningún dato. Una entrada con aviso nunca se publica automáticamente.

Datos enviados a la IA
El botón Datos enviados a la IA muestra exactamente lo que el módulo transmite para ese producto: las instrucciones (idénticas para todos los productos, lo que permite almacenarlas en caché) y el mensaje del producto, con una estimación de los tokens y del coste.

Generación masiva
Elija los idiomas, los productos (solo los que no tienen FAQ, o todos los productos activos), opcionalmente una lista de ID, y lo que ocurre tras la generación (borradores por revisar, opción recomendada, o publicación de las entradas sin aviso). Haga clic en Estimar el coste: el módulo muestra el número de fichas × idiomas, los tokens estimados y un rango de coste, con y sin caché de las instrucciones, antes de cualquier envío.

- La cola avanza por pasos cortos mientras la página del módulo está abierta: sin solicitudes interminables ni tareas cron.
- Un bloqueo impide que dos pestañas o dos empleados procesen la misma cola; solo hay una cola activa por tienda.
- La cola se detiene al alcanzar el presupuesto de la ejecución y el límite mensual. Puede pausarla, reanudarla, cancelarla o reintentar los errores (3 intentos por ficha).
- Si el proveedor rechaza todas las solicitudes (clave, crédito, modelo), la cola se pone en pausa con un mensaje que indica qué corregir.
Modo económico: las solicitudes se envían a la API Message Batches de Anthropic o a la API Batch de OpenAI, aproximadamente a mitad de precio. Los resultados suelen llegar en unas horas, como máximo en 24 horas, y se recuperan cuando la página del módulo está abierta.

Costes, presupuesto y registro
Configure el presupuesto por defecto de una ejecución masiva, el límite mensual (todas las generaciones incluidas) y el número máximo de tokens por respuesta. El registro enumera cada llamada: operación, producto, idioma, modelo, tokens de entrada, de salida y leídos en caché tal como los devuelve el proveedor, coste orientativo y error, si lo hay.

Los precios utilizados son precios públicos orientativos consultados el 11/11/2026. La estimación cuenta unos 3,5 caracteres por token: es un orden de magnitud. La factura de su proveedor es la referencia.
Visualización en la ficha de producto
En la pestaña Visualización, elija el estilo, el color de acento, la apertura de la primera pregunta, la posición en la página y el título del bloque en cada idioma. Se indica cualquier posición a la que su tema no llame.

Se proponen cinco estilos: minimalista, tarjetas, enmarcado, botones + y todo abierto. El bloque utiliza los elementos HTML nativos <details> y <summary>: funciona con el teclado (Tab, Intro, Espacio) y con los lectores de pantalla, sin ningún archivo JavaScript. El HTML lo genera el servidor, por lo que nada se desplaza al cargar la página, y la hoja de estilos solo se carga en las fichas que muestran una FAQ.







Datos estructurados FAQPage
El módulo puede añadir un marcado schema.org FAQPage (JSON-LD) a las fichas que muestran una FAQ. La opción está desactivada por defecto.
Google limitó los resultados enriquecidos de FAQ a sitios gubernamentales y de salud de referencia en agosto de 2023 y dejó de mostrarlos para todos los sitios el 7 de mayo de 2026. El marcado sigue siendo schema.org válido y no perjudica, pero no genera ningún resultado enriquecido en Google: no espere de él ninguna mejora SEO.
Si activa la opción y el módulo DataFirefly All in One SEO ya muestra un bloque FAQPage en la página, Product FAQ AI no añade un segundo; los ajustes del otro módulo nunca se modifican. El JSON-LD se codifica de forma que siga siendo válido y nunca pueda cerrar la etiqueta script.
Seguridad y confidencialidad
- El texto del producto se coloca en un bloque de datos delimitado y se trata como contenido no fiable: una descripción que contuviera instrucciones («ignora las instrucciones…») sigue siendo un simple dato.
- La respuesta de la IA está restringida por un esquema JSON y después se limpia: solo texto plano, sin HTML, enlaces, direcciones de correo electrónico ni Markdown.
- Las acciones del back-office pasan por un controlador protegido por token; las escrituras exigen una solicitud POST del módulo y el permiso «modificar» en la pestaña Product FAQ AI. Un empleado que solo tiene el permiso «ver» puede consultar, pero no generar ni modificar.
- Multitienda: los ajustes, la clave, las FAQ, la cola y el registro son propios de cada tienda; seleccione una sola tienda para configurar el módulo.
Solución de problemas
- «El proveedor rechazó la clave (401)»: compruebe la clave en la consola del proveedor o cree una nueva y vuelva a pegarla.
- «Modelo desconocido o no disponible (404)»: elija otro modelo; el botón Probar la clave guardada recarga la lista de su cuenta.
- Crédito agotado o límite de facturación: añada crédito en el proveedor y reanude la cola.
- Demasiadas solicitudes (429), servicio saturado: el módulo ya ha reintentado respetando el plazo indicado por el proveedor; espere o utilice el modo económico.
- Respuesta cortada: aumente el número máximo de tokens por respuesta, o pida menos preguntas o respuestas más cortas.
- Rechazo del proveedor: revise el texto del producto o redacte las preguntas a mano.
- La FAQ no se muestra: compruebe que las preguntas están publicadas en el idioma consultado y que su tema llama a la posición elegida (advertencia en la pestaña Visualización).
Desinstalación
La desinstalación elimina todas las FAQ, la cola de generación, el registro de consumo, los ajustes y el controlador de administración. Se solicita una confirmación.