Referința Acțiunilor AI
Când este conectat cu permisiunile corespunzătoare API, asistentul dumneavoastră AI poate efectua următoarele acțiuni pe magazinul dumneavoastră PrestaShop în timp real. Aceste acțiuni sunt disponibile în fluxurile de lucru SmartFlow și pot fi, de asemenea, utilizate de AI în timpul conversațiilor cu clienții dumneavoastră.
Produse
Obține Produs
Recuperați detalii complete ale unui produs după ID-ul său.
- Input: ID produs
- Returns: Nume, descriere, descriere scurtă, referință, preț, cantitate în stoc, status activ, câmpuri SEO (titlu meta, descriere meta, cuvinte cheie meta)
- API permission:
products(GET)
Actualizează Conținutul Produsului
Actualizați descrierea și/sau descrierea scurtă a unui produs, cu suport complet pentru mai multe limbi.
- Inputs: ID produs, descriere (opțional), descriere scurtă (opțional), ID limbă (opțional — implicit la limba principală a magazinului)
- Returns: Confirmare cu lista câmpurilor actualizate
- API permission:
products(GET + PUT)
AI-ul păstrează conținutul în alte limbi atunci când actualizează o limbă specifică. De exemplu, actualizarea descrierii în franceză nu va afecta versiunea în engleză.
Actualizează SEO-ul Produsului
Actualizați câmpurile SEO ale unui produs, cu suport pentru mai multe limbi.
- Inputs: ID produs, titlu meta (opțional), descriere meta (opțional), cuvinte cheie meta (opțional), ID limbă (opțional)
- Returns: Confirmare cu valorile SEO actualizate
- API permission:
products(GET + PUT)
Comenzi
Obține Comandă după Referință
Căutați o comandă specifică folosind numărul său de referință (de exemplu, ABCDEF123).
- Input: Referință comandă
- Returns: Detalii complete ale comenzii, inclusiv dată, status, sumă totală, metodă de plată, informații de livrare și lista produselor
- API permission:
orders(GET),order_details(GET),order_states(GET)
Obține Comenzi după Email
Recuperați toate comenzile plasate de un client specific.
- Inputs: Email client, limită (opțional — implicit la 10)
- Returns: Listă de comenzi cu detalii complete, număr total
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Obține Ultima Comandă
Obțineți cea mai recentă comandă pentru un client specific.
- Input: Email client
- Returns: Cea mai recentă comandă cu detalii complete, sau null dacă nu s-au găsit comenzi
- API permission:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Actualizează Statusul Comenzii
Schimbați statusul unei comenzi (de exemplu, marcați ca expediată, marcați ca livrată).
- Inputs: ID comandă, nou ID stare comandă, trimite notificare prin email (opțional — implicit la nu)
- Returns: Confirmare cu noul status și dacă a fost trimis un email
- API permission:
order_histories(GET + POST)
Schimbarea statusului unei comenzi poate declanșa notificări prin email pentru clienți dacă opțiunea sendEmail este activată. Asigurați-vă că statusul corect este aplicat.
Clienți
Obține Client
Căutați un client după adresa sa de email.
- Input: Email client
- Returns: ID client, prenume, nume, email, dată naștere, status newsletter, dată înregistrare, note
- API permission:
customers(GET)
Actualizează Client
Actualizați informațiile de profil ale unui client.
- Inputs: ID client, prenume (opțional), nume (opțional), email (opțional), note (opțional)
- Returns: Confirmare cu lista câmpurilor actualizate
- API permission:
customers(GET + PUT)
Configurare
Obține Limbi
Listați toate limbile configurate pe magazinul dumneavoastră PrestaShop.
- Nu este necesar input
- Returns: Listă de limbi cu ID, nume și cod ISO (de exemplu,
fr,en,de) - API permission:
languages(GET)
Această acțiune este utilizată intern de AI atunci când efectuează actualizări de produse multilingve, pentru a asigura utilizarea corectă a ID-ului limbii.
Tabel rezumat
| Acțiune | Categorie | Citește | Scrie |
|---|---|---|---|
| Obține Produs | Produse | Da | — |
| Actualizează Conținutul Produsului | Produse | Da | Da |
| Actualizează SEO-ul Produsului | Produse | Da | Da |
| Obține Comandă după Referință | Comenzi | Da | — |
| Obține Comenzi după Email | Comenzi | Da | — |
| Obține Ultima Comandă | Comenzi | Da | — |
| Actualizează Statusul Comenzii | Comenzi | — | Da |
| Obține Client | Clienți | Da | — |
| Actualizează Client | Clienți | Da | Da |
| Obține Limbi | Config | Da | — |
Relaționat
- Permisiuni API — Configurați permisiunile Webservice necesare
- Webhooks & Abilități — Declanșați aceste acțiuni automat la evenimentele din magazin