API Machtigingen
Om het volledige potentieel van AI SmartTalk te ontgrendelen — zoals het opzoeken van bestellingen, het bijwerken van productbeschrijvingen of het beheren van klanten — moet je een PrestaShop Webservice API-token configureren met de juiste machtigingen.
Deze stap is vereist als je AI Acties (SmartFlow) wilt gebruiken. Zonder deze configuratie kan je AI-assistent nog steeds vragen beantwoorden op basis van gesynchroniseerde kennis, maar zal hij geen toegang hebben tot realtime winkelgegevens.
1. Het inschakelen van de Webservice
- Ga naar Geavanceerde Instellingen > Webservice
- Schakel PrestaShop's webservice in
- Klik op Opslaan
2. Een API-sleutel aanmaken
- Klik op de Webservice-pagina op Voeg nieuwe webservice-sleutel toe
- Vul het formulier in:
- Sleutel: Klik op Genereren om een veilige token te maken, of voer je eigen sleutel in
- Sleutelomschrijving:
AI SmartTalk - Status: Ingeschakeld
- Stel de machtigingen in zoals hieronder beschreven
- Klik op Opslaan
Kopieer en bewaar de API-sleutel — je hebt deze nodig bij het configureren van de integratie in AI SmartTalk.
3. Vereiste machtigingen
Schakel in de machtigingssectie van je API-sleutel de volgende bronnen in:
| Bron | GET | PUT | POST | Beschrijving |
|---|---|---|---|---|
| producten | Ja | Ja | — | Lees productdetails, werk beschrijvingen en SEO bij |
| bestellingen | Ja | — | — | Zoek bestellingen op op referentie of klant |
| bestel_details | Ja | — | — | Bekijk producten binnen een bestelling |
| bestel_statussen | Ja | — | — | Lees labels voor bestelstatussen |
| bestel_historieken | Ja | — | Ja | Lees statusgeschiedenis, voeg statuswijzigingen toe |
| klanten | Ja | Ja | — | Zoek en werk klantinformatie bij |
| talen | Ja | — | — | Lijst beschikbare winkel talen |
Vink alleen de hierboven vermelde machtigingen aan. Het is niet nodig om toegang tot andere bronnen te verlenen.
4. Wat elke bron doet
Producten (lezen + schrijven)
- Lezen: Haal productdetails op — naam, beschrijving, korte beschrijving, prijs, referentie, voorraad, SEO-velden (meta titel, meta beschrijving, meta zoekwoorden)
- Schrijven: Werk productbeschrijvingen, korte beschrijvingen en SEO-velden bij met volledige meertalige ondersteuning
Bestellingen (alleen lezen)
- Zoek een bestelling op aan de hand van het referentienummer
- Lijst bestellingen voor een specifieke klant (per e-mail)
- Haal de meest recente bestelling voor een klant op
Bestel Details (alleen lezen)
- Bekijk de producten binnen een bestelling: naam, referentie, hoeveelheid, eenheidsprijs
Bestel Statussen (alleen lezen)
- Haal het leesbare label voor elke bestelstatus op (bijv. "Betaling geaccepteerd", "Verzonden")
Bestel Historieken (lezen + aanmaken)
- Lezen: Bekijk de statuswijzigingsgeschiedenis van een bestelling
- Aanmaken: Voeg een nieuwe statuswijziging toe aan een bestelling (bijv. markeer als verzonden), met optionele e-mailnotificatie naar de klant
Klanten (lezen + schrijven)
- Lezen: Zoek een klant op per e-mail of ID — haal naam, e-mail, registratiedatum, nieuwsbriefstatus, notities op
- Schrijven: Werk klantinformatie bij (voornaam, achternaam, e-mail, notities)
Talen (alleen lezen)
- Lijst alle talen die op je winkel zijn geconfigureerd (gebruikt voor meertalige productupdates)
5. De API-sleutel invoeren in AI SmartTalk
Zodra je Webservice-sleutel is aangemaakt en geconfigureerd:
- Ga naar de configuratie van de AI SmartTalk-module in PrestaShop
- De API-sleutel wordt doorgaans verzonden tijdens de OAuth-verbinding
- Als je deze moet bijwerken, ga dan naar je AI SmartTalk-dashboard > Integratie > PrestaShop en werk de Webservice-token bij
Voor multi-site configuraties kan elke site zijn eigen Webservice API-sleutel onafhankelijk configureren.
Volgende stappen
- Synchroniseer je winkelgegevens — Duw je productcatalogus naar de AI
- Bekijk wat de AI kan doen — Volledige referentie van beschikbare acties