# Product-FAQ met AI: volledige installatie- en configuratiegids

> Overzicht DataFirefly Product-FAQ met AI maakt automatisch contextuele FAQ's aan voor uw PrestaShop 8-productfiches, via OpenAI of Anthropic Claude, met de injectie van Schema.org-FAQPage-opmaak in de head voor de rijke…

- Pagina: <https://www.datafirefly.com/nl/documentation/datafirefly-faq-ia-produit-prestashop-8/>
- Taal: nl
- Bijgewerkt op: 2026-09-09
- Andere talen: [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), [es](https://www.datafirefly.com/es/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)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## Overzicht

**DataFirefly Product-FAQ met AI** maakt automatisch contextuele FAQ's aan voor uw PrestaShop 8-productfiches, via OpenAI of Anthropic Claude, met de injectie van Schema.org-`FAQPage`-opmaak in de head voor de rijke resultaten van Google. De FAQ's worden in de database bewaard (tabel `ps_product_faq`): er gaat geen enkele API-aanroep uit aan de frontzijde.

- **Compatibiliteit:** PrestaShop 8.0 tot 8.99, PHP 7.2 tot 8.3
- **Meertalig:** de FAQ's worden per taal aangemaakt en bewaard
- **Multistore:** een aparte configuratie per subwinkel

## Installatie

1. Ga in uw backoffice naar **Modules → Modulebeheer → Een module installeren**.
2. Upload `productfaqai-3.0.0.zip`.
3. Klik op **Installeren** en daarna op **Configureren**.

**Bijwerken vanaf v2.x (de Sash-module):** de upgrade is niet destructief. Het schema van de tabel `ps_product_faq` blijft gelijk, dus uw bestaande FAQ's blijven behouden. Installeer v3.0.0 er gewoon overheen en stel daarna uw API-sleutel in de nieuwe interface opnieuw in.

## 1. AI-aanbieder en model

Het eerste formulier van de configuratiepagina.

- **AI-aanbieder:** OpenAI of Anthropic Claude. De module schakelt automatisch naar de juiste API.
- **OpenAI API-sleutel:** via [platform.openai.com](https://platform.openai.com) (begint met `sk-`).
- **Anthropic API-sleutel:** via [console.anthropic.com](https://console.anthropic.com) (begint met `sk-ant-`).
- **Model:** voor OpenAI is `gpt-4o-mini` aan te raden (het zuinigst). Voor Anthropic is `claude-haiku-4-5` aan te raden.
- **Aantal vragen:** 1 tot 15 (standaard 5).
- **Temperatuur:** 0 is deterministisch, 2 is zeer creatief. Aanbevolen: 0,7.
- **Max tokens:** de maximale lengte van het antwoord (standaard 2000). Verhoog die als u meer dan 8 vragen laat aanmaken.
- **Automatisch aanmaken:** maakt bij elke nieuwe product automatisch een FAQ aan (in de standaardtaal).

**Indicatieve kosten:** vijf vragen aanmaken kost ongeveer 0,0005 $ met gpt-4o-mini en ongeveer 0,001 $ met claude-haiku-4-5. 200 producten × 3 talen komt zo op 0,30 tot 0,60 $ in totaal.

## 2. Prompt en inhoudelijke richtlijnen

Het tweede formulier, dat de kwaliteit en de stijl van de aangemaakte FAQ's bepaalt.

- **Toon:** professioneel, vriendelijk, ontspannen, technisch, enthousiast of geruststellend.
- **Doelpubliek** (optioneel): vrije tekst, bijvoorbeeld « medische professionals B2B » of « eerste kopers ». De AI stemt woordkeuze en detailniveau daarop af.
- **Eigen systeemprompt** (optioneel): vervangt de standaardinstructies volledig. Laat leeg om de ingebouwde prompt te gebruiken.
- **Bijkomende richtlijnen** (optioneel): instructies die aan de prompt worden toegevoegd, bijvoorbeeld « vermeld altijd de garantie van 2 jaar » of « vermijd jargon ».
- **Categorie, fabrikant en kenmerken meenemen:** drie schakelaars die de context verrijken die naar de AI gaat. Zet « kenmerken » aan voor technische producten: de antwoorden worden merkbaar nauwkeuriger.

## 3. Weergave en SEO

- **Weergavepositie (hook):** kies uit 5 plaatsen:
   - `displayProductFooter`: onder de hele fiche (standaard, werkt overal)
   - `displayFooterProduct`: een variant, afhankelijk van het thema
   - `displayProductAdditionalInfo`: onder de aankoopknop (beter zichtbaar)
   - `displayReassurance`: het vertrouwensblok
   - `displayAfterProductThumbs`: onder de miniaturen
- **Titel van de FAQ:** één veld per taal van de winkel. Er zijn standaardwaarden voorzien in FR/EN/ES/DE/IT/PT/NL.
- **Accordeonmodus:** aan betekent inklapbare vragen (de eerste staat open). Uit betekent dat alle antwoorden zichtbaar zijn.
- **JSON-LD rich snippets:** injecteert de Schema.org-opmaak `FAQPage` in de head. Aanbevolen: aan.
- **Uitgesloten categorieën:** ID's gescheiden door komma's (bijvoorbeeld `12,45,78`). Producten uit die categorieën worden bij de bulkgeneratie overgeslagen.

De module registreert bij de installatie alle 5 de hooks, maar toont het blok alleen op de ingestelde hook. Bestaat een hook niet in uw thema, dan verschijnt het blok eenvoudigweg niet: test eerst met de standaardhook.

## FAQ's aanmaken

### Eén product tegelijk

In het paneel « FAQ's aanmaken voor de producten » heeft elke productregel een knop **Aanmaken**. Kies eerst de doeltaal in de keuzelijst boven aan de tabel. Per product ziet u hoeveel FAQ's er per taal al bestaan.

### Bulkgeneratie

- **Aanmaken voor alle producten (huidige taal):** verwerkt alle producten zonder FAQ in de actieve taal.
- **Aanmaken voor alle producten (alle talen):** verwerkt alle actieve talen van de winkel.
- **Opnieuw aanmaken afdwingen:** vink dit aan om de bestaande FAQ's te overschrijven, handig na een wijziging van de prompt, de toon of de aanbieder.

**Duur:** reken op ongeveer 1 product per seconde per taal (de API-latentie varieert). 100 producten × 3 talen komt zo op ongeveer 5 minuten. Sluit het tabblad niet tijdens de verwerking. Producten uit de uitgesloten categorieën worden automatisch overgeslagen.

### Automatisch aanmaken

Staat die optie in het eerste formulier aan, dan krijgt elk nieuw product (hook `actionProductAdd`) automatisch een FAQ in de standaardtaal van de winkel.

## FAQ-editor per product

Klik op een productregel op **FAQ's bewerken** om de editor te openen:

- **Taalkiezer** bovenaan, om meteen tussen de talen te wisselen.
- **Positie:** een numeriek gewicht, in oplopende weergavevolgorde.
- **Vraag en antwoord:** de tekst is rechtstreeks te bewerken.
- **Status:** een item in- of uitschakelen zonder het te verwijderen (een inactief item verschijnt niet op de fiche en niet in de JSON-LD).
- **Verwijderen:** een item definitief wissen.
- **Een FAQ toevoegen:** zelf een vraag met antwoord toevoegen.

Klik op **Opslaan** om alle wijzigingen van de pagina te bevestigen.

## FAQPage rich snippets

Staat de JSON-LD-optie aan, dan injecteert de module in de `head` van elke productfiche met minstens één actieve FAQ een blok `application/ld+json` volgens Schema.org `FAQPage`:

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

Controleer de opmaak met de [test voor rijke resultaten van Google](https://search.google.com/test/rich-results). Of het in de zoekresultaten verschijnt, hangt van Google af en kan enkele dagen duren na het opnieuw indexeren van de pagina.

## Problemen oplossen

### « Stel uw API-sleutel in »

De sleutel van de gekozen aanbieder is leeg of ongeldig. Controleer of de sleutel bij de actieve aanbieder hoort (OpenAI is `sk-…`, Anthropic is `sk-ant-…`).

### Fouten bij de bulkgeneratie

API-fouten (quotum overschreden, ingetrokken sleutel, timeout) komen via PrestaShopLogger in **Geavanceerde parameters → Logboeken** terecht. Het verslag na de verwerking toont per taal het detail van de geslaagde, overgeslagen en mislukte generaties.

### De FAQ verschijnt niet op de productfiche

1. Controleer of het product minstens één **actieve** FAQ heeft in de bekeken taal.
2. Controleer of de ingestelde hook in uw thema bestaat, en schakel ter controle terug naar `displayProductFooter`.
3. Leeg de PrestaShop-cache (**Geavanceerde parameters → Prestaties**).

### De rich snippets verschijnen niet in Google

De opmaak kan geldig zijn zonder dat Google die toont: het weergeven van rijke resultaten blijft een beslissing van Google. Controleer eerst de opmaak met de test voor rijke resultaten en wacht daarna de herindexering af.

## Verwijderen

Bij het verwijderen worden de tabel `ps_product_faq` (met alle aangemaakte FAQ's) en alle configuratiesleutels gewist. Er wordt om bevestiging gevraagd. Exporteer uw gegevens vooraf als dat nodig is.