PS PrestaShop PrestaShop Principiante

FAQ IA Producto — Guía completa de instalación y configuración

Instalar y configurar el módulo FAQ IA Producto: proveedor de IA (OpenAI o Claude), personalización del prompt, generación masiva, editor FAQ y rich snippets FAQPage.

Actualizado Versión del módulo 3.0.0

Presentación

DataFirefly FAQ IA Producto genera automáticamente FAQs contextuales para tus fichas de producto PrestaShop 8 mediante OpenAI o Anthropic Claude, inyectando rich snippets Schema.org FAQPage en el head para los resultados enriquecidos de Google. Las FAQ se almacenan en la base de datos (tabla ps_product_faq) — no se realiza ninguna llamada API en el front-office.

  • Compatibilidad: PrestaShop 8.0 → 8.99, PHP 7.2 → 8.3
  • Multilingüe: FAQ generadas y almacenadas por idioma
  • Multitienda: configuración independiente por subtienda

Instalación

  1. En tu back-office, ve a Módulos → Gestor de módulos → Subir un módulo.
  2. Sube productfaqai-3.0.0.zip.
  3. Haz clic en Instalar, luego en Configurar.

Actualización desde la v2.x (módulo Sash): la actualización no es destructiva. El esquema de la tabla ps_product_faq no cambia — tus FAQ existentes se conservan. Simplemente instala la v3.0.0 encima y reconfigura tu clave API en la nueva interfaz.

1. Proveedor de IA y modelo

Primer formulario de la página de configuración.

  • Proveedor de IA: OpenAI o Anthropic Claude. El módulo cambia automáticamente a la API correcta.
  • Clave API OpenAI: desde platform.openai.com (empieza por sk-).
  • Clave API Anthropic: desde console.anthropic.com (empieza por sk-ant-).
  • Modelo: para OpenAI, se recomienda gpt-4o-mini (el más económico). Para Anthropic, se recomienda claude-haiku-4-5.
  • Número de preguntas: 1 a 15 (por defecto: 5).
  • Temperatura: 0 = determinista, 2 = muy creativo. Recomendado: 0,7.
  • Max tokens: longitud máxima de la respuesta (por defecto: 2000). Auméntalo si generas más de 8 preguntas.
  • Auto-generación: genera automáticamente la FAQ (idioma por defecto) en cada creación de producto.

Coste indicativo: una generación de 5 preguntas cuesta ~0,0005 $ con gpt-4o-mini y ~0,001 $ con claude-haiku-4-5. 200 productos × 3 idiomas ≈ 0,30 a 0,60 $ en total.

2. Prompt y directrices de contenido

Segundo formulario — controla la calidad y el estilo de las FAQ generadas.

  • Tono de voz: profesional, amigable, informal, técnico, entusiasta o tranquilizador.
  • Audiencia objetivo (opcional): texto libre, ej. «profesionales médicos B2B», «compradores primerizos». La IA adapta el vocabulario y el nivel de detalle.
  • Prompt de sistema personalizado (opcional): sustituye por completo las instrucciones por defecto. Déjalo vacío para usar el prompt integrado.
  • Directrices adicionales (opcional): instrucciones añadidas al prompt, ej. «mencionar siempre la garantía de 2 años», «evitar la jerga».
  • Incluir categoría / fabricante / características: tres interruptores que enriquecen el contexto enviado a la IA. Activa «características» para productos técnicos — la precisión de las respuestas mejora notablemente.

3. Visualización y SEO

  • Posición de visualización (hook): elige entre 5 ubicaciones:
    • displayProductFooter — debajo de toda la ficha (por defecto, funciona en todos los temas)
    • displayFooterProduct — variante según el tema
    • displayProductAdditionalInfo — debajo del botón de compra (más visible)
    • displayReassurance — bloque de garantías
    • displayAfterProductThumbs — debajo de las miniaturas
  • Título FAQ: un campo por idioma de la tienda. Valores por defecto en FR/EN/ES/DE/IT/PT/NL.
  • Modo acordeón: activado = preguntas plegables (primera abierta). Desactivado = todas las respuestas visibles.
  • Rich snippets JSON-LD: inyecta el marcado Schema.org FAQPage en el head. Recomendado: activado.
  • Categorías excluidas: IDs separados por comas (ej. 12,45,78). Los productos de estas categorías se omiten en la generación masiva.

El módulo registra los 5 hooks en la instalación pero solo muestra el bloque en el hook configurado. Si un hook no existe en tu tema, el bloque simplemente no se mostrará — prueba primero con el hook por defecto.

Generar FAQs

Generación individual

En el panel «Generar FAQs para los productos», cada fila de producto muestra un botón Generar. Selecciona primero el idioma objetivo en el desplegable en la parte superior de la tabla. Se muestra el número de FAQ existentes por idioma para cada producto.

Generación masiva

  • Generar para todos los productos (idioma actual): procesa todos los productos sin FAQ en el idioma activo.
  • Generar para todos los productos (todos los idiomas): procesa todos los idiomas activos de la tienda.
  • Forzar regeneración: marca esta casilla para sobrescribir las FAQ existentes — útil tras cambiar el prompt, el tono o el proveedor.

Duración: calcula ~1 producto/segundo por idioma (latencia API variable). 100 productos × 3 idiomas ≈ 5 minutos. No cierres la pestaña durante el procesamiento. Los productos de las categorías excluidas se omiten automáticamente.

Auto-generación

Si está activada en el primer formulario, cada nuevo producto (hook actionProductAdd) recibe automáticamente una FAQ en el idioma por defecto de la tienda.

Editor FAQ por producto

Haz clic en Modificar FAQs en una fila de producto para abrir el editor:

  • Selector de idioma en la parte superior — cambio instantáneo entre idiomas.
  • Posición: peso numérico, orden de visualización ascendente.
  • Pregunta / Respuesta: edición directa del texto.
  • Estado: activar/desactivar una entrada sin eliminarla (una entrada inactiva no aparece ni en la ficha ni en el JSON-LD).
  • Eliminar: eliminación definitiva de una entrada.
  • Añadir una FAQ: añadir manualmente una pregunta/respuesta.

Haz clic en Guardar para confirmar todos los cambios de la página.

Rich snippets FAQPage

Cuando la opción JSON-LD está activa, el módulo inyecta en el head de cada ficha de producto con al menos una FAQ activa un bloque application/ld+json conforme a Schema.org FAQPage:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "…",
      "acceptedAnswer": { "@type": "Answer", "text": "…" }
    }
  ]
}

Verifica el marcado con la prueba de resultados enriquecidos de Google. La aparición en la SERP depende de Google y puede tardar varios días tras la reindexación de la página.

Resolución de problemas

«Por favor, configure su clave API del proveedor de IA»

La clave del proveedor seleccionado está vacía o no es válida. Comprueba que la clave corresponde al proveedor activo (OpenAI = sk-…, Anthropic = sk-ant-…).

Errores en la generación masiva

Los errores API (cuota superada, clave revocada, timeout) se registran en Parámetros avanzados → Logs mediante PrestaShopLogger. El informe final del procesamiento muestra el detalle de éxitos / omitidos / errores por idioma.

La FAQ no se muestra en la ficha del producto

  1. Comprueba que el producto tiene al menos una FAQ activa en el idioma consultado.
  2. Comprueba que el hook configurado existe en tu tema — vuelve a displayProductFooter para probar.
  3. Vacía la caché de PrestaShop (Parámetros avanzados → Rendimiento).

Los rich snippets no aparecen en Google

El marcado puede ser válido sin que Google lo muestre: la visualización de los resultados enriquecidos queda a discreción de Google. Valida primero el marcado con la prueba de resultados enriquecidos y luego espera el tiempo de reindexación.

Desinstalación

La desinstalación elimina la tabla ps_product_faq (todas las FAQ generadas) y todas las claves de configuración. Se solicita una confirmación. Exporta tus datos previamente si es necesario.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte