PS PrestaShop Principiante

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.

Actualizado Versión del módulo 4.0.0

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.com o api.openai.com.

Instalación y actualización

  1. En Módulos > Gestor de módulos, haga clic en Subir un módulo y seleccione productfaqai-4.0.0.zip.
  2. El módulo crea la tabla ps_product_faq y tres tablas técnicas (ps_productfaqai_job, ps_productfaqai_job_item, ps_productfaqai_usage), registra sus hooks y un controlador de administración oculto.
  3. 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.

Product FAQ AI para PrestaShop: panel con la cobertura de FAQ por idioma y el gasto del mes
Panel con la cobertura de FAQ por idioma y el gasto del mes

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.

Product FAQ AI para PrestaShop: asistente de conexión con prueba de la clave API
Asistente de conexión con prueba de la clave API

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.
Product FAQ AI para PrestaShop: elección del modelo Claude con precio orientativo y coste por 1.000 FAQ
Elección del modelo Claude con precio orientativo y coste por 1.000 FAQ

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».

Product FAQ AI para PrestaShop: ajustes de redacción: número de preguntas, longitud y tono
Ajustes de redacción: número de preguntas, longitud y tono

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.

Product FAQ AI para PrestaShop: lista de productos con el estado de las FAQ por idioma
Lista de productos con el estado de las FAQ por idioma

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.
Product FAQ AI para PrestaShop: editor de FAQ: validar, regenerar una pregunta, reordenar
Editor de FAQ: validar, regenerar una pregunta, reordenar

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.

Product FAQ AI para PrestaShop: borradores por revisar con aviso sobre una cifra y una promesa ausentes de la ficha
Borradores por revisar con aviso sobre una cifra y una promesa ausentes de la ficha

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.

Product FAQ AI para PrestaShop: vista previa de los datos del producto enviados a la IA, sin datos de clientes
Vista previa de los datos del producto enviados a la IA, sin datos de clientes

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.

Product FAQ AI para PrestaShop: generación masiva con estimación del coste antes de iniciar
Generación masiva con estimación del coste antes de iniciar
  • 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.

Product FAQ AI para PrestaShop: cola de generación en modo económico (lote) con progreso y presupuesto
Cola de generación en modo económico (lote) con progreso y presupuesto

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.

Product FAQ AI para PrestaShop: presupuesto, límite mensual y registro de consumo de tokens
Presupuesto, límite mensual y registro de consumo de tokens

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.

Product FAQ AI para PrestaShop: ajustes de visualización: estilos de acordeón, posición y datos estructurados
Ajustes de visualización: estilos de acordeón, posición y datos estructurados

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.

Product FAQ AI para PrestaShop: FAQ en la ficha de producto, estilo minimalista (Hummingbird)
FAQ en la ficha de producto, estilo minimalista (Hummingbird)
Product FAQ AI para PrestaShop: FAQ en la ficha de producto, estilo tarjetas
FAQ en la ficha de producto, estilo tarjetas
Product FAQ AI para PrestaShop: FAQ en la ficha de producto, estilo enmarcado
FAQ en la ficha de producto, estilo enmarcado
Product FAQ AI para PrestaShop: FAQ en la ficha de producto, estilo botones + con color de acento
FAQ en la ficha de producto, estilo botones + con color de acento
Product FAQ AI para PrestaShop: FAQ con todas las respuestas visibles
FAQ con todas las respuestas visibles
Product FAQ AI para PrestaShop: ficha de producto Hummingbird con el bloque de FAQ
Ficha de producto Hummingbird con el bloque de FAQ
Product FAQ AI para PrestaShop: FAQ en móvil, accesible con teclado y sin JavaScript
FAQ en móvil, accesible con teclado y sin JavaScript

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.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte