API Atļaujas
Lai atbloķētu AI SmartTalk pilnu potenciālu — piemēram, pasūtījumu meklēšanu, produktu aprakstu atjaunināšanu vai klientu pārvaldību — jums ir jākonfigurē PrestaShop Webservice API atslēga ar pareizajām atļaujām.
Šis solis ir nepieciešams, ja vēlaties izmantot AI Actions (SmartFlow). Bez tā jūsu AI asistents joprojām var atbildēt uz jautājumiem, pamatojoties uz sinhronizētu zināšanu, bet nevarēs piekļūt reāllaika veikala datiem.
1. Webservice aktivizēšana
- Dodieties uz Papildu parametri > Webservice
- Aktivizējiet PrestaShop webservice
- Noklikšķiniet uz Saglabāt
2. API atslēgas izveide
- Webservice lapā noklikšķiniet uz Pievienot jaunu webservice atslēgu
- Aizpildiet formu:
- Atslēga: Noklikšķiniet uz Ģenerēt, lai izveidotu drošu atslēgu, vai ievadiet savu
- Atslēgas apraksts:
AI SmartTalk - Statuss: Aktivizēts
- Iestatiet atļaujas, kā aprakstīts zemāk
- Noklikšķiniet uz Saglabāt
Kopējiet un saglabājiet API atslēgu — jums tā būs nepieciešama, konfigurējot integrāciju AI SmartTalk.
3. Nepieciešamās atļaujas
API atslēgas atļauju sadaļā aktivizējiet šādus resursus:
| Resurss | GET | PUT | POST | Apraksts |
|---|---|---|---|---|
| produkti | Jā | Jā | — | Lasīt produktu detaļas, atjaunināt aprakstus un SEO |
| pasūtījumi | Jā | — | — | Meklēt pasūtījumus pēc atsauces vai klienta |
| pasūtījuma_detaļas | Jā | — | — | Skatīt produktus pasūtījumā |
| pasūtījuma_stāvokļi | Jā | — | — | Lasīt pasūtījuma statusa etiķetes |
| pasūtījuma_vēstures | Jā | — | Jā | Lasīt statusa vēsturi, pievienot statusa izmaiņas |
| klienti | Jā | Jā | — | Meklēt un atjaunināt klientu informāciju |
| valodas | Jā | — | — | Saraksts ar pieejamajām veikala valodām |
Pārbaudiet tikai iepriekš minētās atļaujas. Nav nepieciešams piešķirt piekļuvi citiem resursiem.
4. Katras resursa izmantošana
Produkti (lasīt + rakstīt)
- Lasīt: Iegūt produktu detaļas — nosaukums, apraksts, īsais apraksts, cena, atsauce, krājums, SEO lauki (meta nosaukums, meta apraksts, meta atslēgvārdi)
- Rakstīt: Atjaunināt produktu aprakstus, īsos aprakstus un SEO laukus ar pilnu daudzvalodu atbalstu
Pasūtījumi (tikai lasīšanai)
- Meklēt pasūtījumu pēc tā atsauces numura
- Saraksts ar pasūtījumiem konkrētam klientam (pēc e-pasta)
- Iegūt visjaunāko pasūtījumu klientam
Pasūtījuma Detaļas (tikai lasīšanai)
- Skatīt produktus pasūtījumā: nosaukums, atsauce, daudzums, vienības cena
Pasūtījuma Stāvokļi (tikai lasīšanai)
- Iegūt cilvēkam saprotamu etiķeti katram pasūtījuma statusam (piemēram, "Maksājums pieņemts", "Nosūtīts")
Pasūtījuma Vēstures (lasīt + izveidot)
- Lasīt: Skatīt pasūtījuma statusa izmaiņu vēsturi
- Izveidot: Pievienot jaunu statusa izmaiņu pasūtījumam (piemēram, atzīmēt kā nosūtītu), ar opciju nosūtīt e-pasta paziņojumu klientam
Klienti (lasīt + rakstīt)
- Lasīt: Meklēt klientu pēc e-pasta vai ID — iegūt vārdu, e-pastu, reģistrācijas datumu, jaunumu statusu, piezīmes
- Rakstīt: Atjaunināt klientu informāciju (vārds, uzvārds, e-pasts, piezīmes)
Valodas (tikai lasīšanai)
- Saraksts ar visām valodām, kas konfigurētas jūsu veikalā (tiek izmantots daudzvalodu produktu atjauninājumiem)
5. API atslēgas ievade AI SmartTalk
Kad jūsu Webservice atslēga ir izveidota un konfigurēta:
- Dodieties uz AI SmartTalk moduļa konfigurāciju PrestaShop
- API atslēga parasti tiek pārsūtīta OAuth savienojuma laikā
- Ja jums ir nepieciešams to atjaunināt, dodieties uz savu AI SmartTalk informācijas paneli > Integrācija > PrestaShop un atjauniniet Webservice atslēgu
Multi-situāciju iestatījumos katrai vietnei var būt sava Webservice API atslēga, kas konfigurēta neatkarīgi.
Nākamie soļi
- Sinhronizējiet savu veikala datus — Pārsūtiet savu produktu katalogu uz AI
- Skatiet, ko AI var darīt — Pilns pieejamo darbību saraksts