Permisiuni API
Pentru a debloca întregul potențial al AI SmartTalk — cum ar fi căutarea comenzilor, actualizarea descrierilor produselor sau gestionarea clienților — trebuie să configurați un token API pentru Webservice PrestaShop cu permisiunile corecte.
Această etapă este necesară dacă doriți să utilizați AI Actions (SmartFlow). Fără aceasta, asistentul dumneavoastră AI poate răspunde la întrebări bazate pe cunoștințe sincronizate, dar nu va putea accesa datele din magazin în timp real.
1. Activarea Webservice-ului
- Accesați Parametrii avansați > Webservice
- Activați webservice-ul PrestaShop
- Faceți clic pe Salvați
2. Crearea unei chei API
- Pe pagina Webservice, faceți clic pe Adăugați o nouă cheie webservice
- Completați formularul:
- Cheie: Faceți clic pe Generați pentru a crea un token securizat sau introduceți propria cheie
- Descrierea cheii:
AI SmartTalk - Stare: Activat
- Setați permisiunile așa cum este descris mai jos
- Faceți clic pe Salvați
Copiați și salvați cheia API — veți avea nevoie de ea atunci când configurați integrarea în AI SmartTalk.
3. Permisiuni necesare
În secțiunea de permisiuni a cheii dumneavoastră API, activați următoarele resurse:
| Resursă | GET | PUT | POST | Descriere |
|---|---|---|---|---|
| produse | Da | Da | — | Citiți detalii despre produse, actualizați descrierile și SEO |
| comenzi | Da | — | — | Căutați comenzi după referință sau client |
| detalii_comenzi | Da | — | — | Vizualizați produsele dintr-o comandă |
| stări_comenzi | Da | — | — | Citiți etichetele stării comenzilor |
| istorii_comenzi | Da | — | Da | Citiți istoricul stării, adăugați modificări de stare |
| clienți | Da | Da | — | Căutați și actualizați informațiile clienților |
| limbi | Da | — | — | Listați limbile disponibile în magazin |
Bifați doar permisiunile enumerate mai sus. Nu este necesar să acordați acces la alte resurse.
4. Utilizarea fiecărei resurse
Produse (citire + scriere)
- Citire: Recuperați detalii despre produse — nume, descriere, descriere scurtă, preț, referință, stoc, câmpuri SEO (titlu meta, descriere meta, cuvinte cheie meta)
- Scriere: Actualizați descrierile produselor, descrierile scurte și câmpurile SEO cu suport complet pentru mai multe limbi
Comenzi (doar citire)
- Căutați o comandă după numărul său de referință
- Listați comenzile pentru un client specific (după email)
- Obțineți cea mai recentă comandă pentru un client
Detalii Comenzi (doar citire)
- Vizualizați produsele dintr-o comandă: nume, referință, cantitate, preț unitar
Stări Comenzi (doar citire)
- Recuperați eticheta ușor de citit pentru fiecare stare a comenzii (de exemplu, "Plata acceptată", "Expediat")
Istorii Comenzi (citire + creare)
- Citire: Vizualizați istoricul modificărilor de stare al unei comenzi
- Creare: Adăugați o nouă modificare de stare la o comandă (de exemplu, marcați ca expediat), cu notificare prin email opțională pentru client
Clienți (citire + scriere)
- Citire: Căutați un client după email sau ID — recuperați nume, email, dată de înregistrare, stare newsletter, note
- Scriere: Actualizați informațiile clientului (prenume, nume, email, note)
Limbi (doar citire)
- Listați toate limbile configurate în magazinul dumneavoastră (utilizate pentru actualizări de produse multilingve)
5. Introducerea cheii API în AI SmartTalk
Odată ce cheia dumneavoastră Webservice este creată și configurată:
- Accesați configurația modulului AI SmartTalk în PrestaShop
- Cheia API este de obicei transmisă în timpul conexiunii OAuth
- Dacă trebuie să o actualizați, accesați tabloul de bord AI SmartTalk > Integrare > PrestaShop și actualizați tokenul Webservice
Pentru configurări multi-site, fiecare site poate avea propria cheie API Webservice configurată independent.
Pași următori
- Sincronizați datele magazinului dumneavoastră — Transmiteți catalogul de produse către AI
- Vezi ce poate face AI — Referință completă a acțiunilor disponibile