AI Actions Reference

Keď je pripojený s príslušnými API povoleniami, váš AI asistent môže vykonávať nasledujúce akcie vo vašom obchode PrestaShop v reálnom čase. Tieto akcie sú dostupné v pracovných postupoch SmartFlow a môžu byť tiež použité AI počas rozhovorov s vašimi zákazníkmi.

---

Produkty

Získať produkt

Získať podrobnosti o produkte podľa jeho ID.

• Vstup: ID produktu
• Vracia: Názov, popis, krátky popis, referencia, cena, množstvo na sklade, aktívny stav, SEO polia (meta názov, meta popis, meta kľúčové slová)
• API povolenie: products (GET)

Aktualizovať obsah produktu

Aktualizovať popis a/alebo krátky popis produktu s plnou viacjazyčnou podporou.

• Vstupy: ID produktu, popis (voliteľné), krátky popis (voliteľné), ID jazyka (voliteľné — predvolené na primárny jazyk obchodu)
• Vracia: Potvrdenie so zoznamom aktualizovaných polí
• API povolenie: products (GET + PUT)

tip

AI zachováva obsah v iných jazykoch pri aktualizácii konkrétneho jazyka. Napríklad, aktualizácia francúzskeho popisu nebude mať vplyv na anglickú verziu.

Aktualizovať SEO produktu

Aktualizovať SEO polia produktu s viacjazyčnou podporou.

• Vstupy: ID produktu, meta názov (voliteľné), meta popis (voliteľné), meta kľúčové slová (voliteľné), ID jazyka (voliteľné)
• Vracia: Potvrdenie s aktualizovanými SEO hodnotami
• API povolenie: products (GET + PUT)

---

Objednávky

Získať objednávku podľa referencie

Vyhľadať konkrétnu objednávku pomocou jej referenčného čísla (napr. ABCDEF123).

• Vstup: Referencia objednávky
• Vracia: Úplné podrobnosti objednávky vrátane dátumu, stavu, celkovej sumy, spôsobu platby, informácií o doprave a zoznamu produktov
• API povolenie: orders (GET), order_details (GET), order_states (GET)

Získať objednávky podľa e-mailu

Získať všetky objednávky zadané konkrétnym zákazníkom.

• Vstupy: E-mail zákazníka, limit (voliteľné — predvolené na 10)
• Vracia: Zoznam objednávok s úplnými podrobnosťami, celkový počet
• API povolenie: orders (GET), order_details (GET), order_states (GET), customers (GET)

Získať poslednú objednávku

Získať najnovšiu objednávku pre konkrétneho zákazníka.

• Vstup: E-mail zákazníka
• Vracia: Najnovšia objednávka s úplnými podrobnosťami, alebo null, ak neboli nájdené žiadne objednávky
• API povolenie: orders (GET), order_details (GET), order_states (GET), customers (GET)

Aktualizovať stav objednávky

Zmeniť stav objednávky (napr. označiť ako odoslanú, označiť ako doručenú).

• Vstupy: ID objednávky, nové ID stavu objednávky, poslať e-mailové oznámenie (voliteľné — predvolené na nie)
• Vracia: Potvrdenie s novým stavom a informáciou, či bol e-mail odoslaný
• API povolenie: order_histories (GET + POST)

warning

Zmena stavu objednávky môže spustiť e-mailové oznámenia zákazníkom, ak je možnosť sendEmail povolená. Uistite sa, že je aplikovaný správny stav.

---

Zákazníci

Získať zákazníka

Vyhľadať zákazníka podľa jeho e-mailovej adresy.

• Vstup: E-mail zákazníka
• Vracia: ID zákazníka, meno, priezvisko, e-mail, dátum narodenia, stav newslettera, dátum registrácie, poznámky
• API povolenie: customers (GET)

Aktualizovať zákazníka

Aktualizovať profilové informácie zákazníka.

• Vstupy: ID zákazníka, meno (voliteľné), priezvisko (voliteľné), e-mail (voliteľné), poznámky (voliteľné)
• Vracia: Potvrdenie so zoznamom aktualizovaných polí
• API povolenie: customers (GET + PUT)

---

Konfigurácia

Získať jazyky

Zoznam všetkých jazykov nakonfigurovaných vo vašom obchode PrestaShop.

• Nie je potrebný žiadny vstup
• Vracia: Zoznam jazykov s ID, názvom a ISO kódom (napr. fr, en, de)
• API povolenie: languages (GET)

info

Táto akcia sa používa interne AI pri vykonávaní viacjazyčných aktualizácií produktov, aby sa zabezpečilo, že sa použije správne ID jazyka.

---

Súhrnná tabuľka

Akcia	Kategória	Čítať	Písať
Získať produkt	Produkty	Áno	—
Aktualizovať obsah produktu	Produkty	Áno	Áno
Aktualizovať SEO produktu	Produkty	Áno	Áno
Získať objednávku podľa referencie	Objednávky	Áno	—
Získať objednávky podľa e-mailu	Objednávky	Áno	—
Získať poslednú objednávku	Objednávky	Áno	—
Aktualizovať stav objednávky	Objednávky	—	Áno
Získať zákazníka	Zákazníci	Áno	—
Aktualizovať zákazníka	Zákazníci	Áno	Áno
Získať jazyky	Konfigurácia	Áno	—

---

Súvisiace

• API Permissions — Nakonfigurujte požadované povolenia Webservice
• Webhooks & Skills — Automaticky spúšťajte tieto akcie pri udalostiach obchodu