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

> 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…

- Página: <https://www.datafirefly.com/es/documentation/datafirefly-faq-ia-produit-prestashop-8/>
- Idioma: es
- Actualizado el: 2026-07-02
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

## 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](https://platform.openai.com) (empieza por `sk-`).
- **Clave API Anthropic:** desde [console.anthropic.com](https://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](https://search.google.com/test/rich-results). 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.