AI Actions Reference
Když je připojen s odpovídajícími API oprávněními, váš AI asistent může provádět následující akce na vašem obchodě PrestaShop v reálném čase. Tyto akce jsou k dispozici v pracovních postupech SmartFlow a mohou být také použity AI během konverzací s vašimi zákazníky.
Produkty
Získat produkt
Získejte úplné podrobnosti o produktu podle jeho ID.
- Vstup: ID produktu
- Vrací: Název, popis, krátký popis, reference, cena, množství na skladě, aktivní stav, SEO pole (meta název, meta popis, meta klíčová slova)
- API oprávnění:
products(GET)
Aktualizovat obsah produktu
Aktualizujte popis a/nebo krátký popis produktu s plnou vícejazyčnou podporou.
- Vstupy: ID produktu, popis (volitelný), krátký popis (volitelný), ID jazyka (volitelný — výchozí je primární jazyk obchodu)
- Vrací: Potvrzení se seznamem aktualizovaných polí
- API oprávnění:
products(GET + PUT)
AI zachovává obsah v jiných jazycích při aktualizaci konkrétního jazyka. Například aktualizace francouzského popisu neovlivní anglickou verzi.
Aktualizovat SEO produktu
Aktualizujte SEO pole produktu s vícejazyčnou podporou.
- Vstupy: ID produktu, meta název (volitelný), meta popis (volitelný), meta klíčová slova (volitelný), ID jazyka (volitelný)
- Vrací: Potvrzení s aktualizovanými hodnotami SEO
- API oprávnění:
products(GET + PUT)
Objednávky
Získat objednávku podle reference
Vyhledejte konkrétní objednávku pomocí jejího referenčního čísla (např. ABCDEF123).
- Vstup: Referenční číslo objednávky
- Vrací: Úplné podrobnosti objednávky včetně data, stavu, celkové částky, platební metody, informací o doručení a seznamu produktů
- API oprávnění:
orders(GET),order_details(GET),order_states(GET)
Získat objednávky podle e-mailu
Získejte všechny objednávky, které provedl konkrétní zákazník.
- Vstupy: E-mail zákazníka, limit (volitelný — výchozí je 10)
- Vrací: Seznam objednávek s úplnými podrobnostmi, celkový počet
- API oprávnění:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Získat poslední objednávku
Získejte nejnovější objednávku pro konkrétního zákazníka.
- Vstup: E-mail zákazníka
- Vrací: Nejnovější objednávku s úplnými podrobnostmi, nebo null, pokud nebyly nalezeny žádné objednávky
- API oprávnění:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Aktualizovat stav objednávky
Změňte stav objednávky (např. označit jako odeslanou, označit jako doručenou).
- Vstupy: ID objednávky, nové ID stavu objednávky, odeslat e-mailové oznámení (volitelný — výchozí je ne)
- Vrací: Potvrzení s novým stavem a informací, zda byl e-mail odeslán
- API oprávnění:
order_histories(GET + POST)
Změna stavu objednávky může spustit e-mailová oznámení zákazníkům, pokud je možnost sendEmail povolena. Ujistěte se, že je použit správný stav.
Zákazníci
Získat zákazníka
Vyhledejte zákazníka podle jeho e-mailové adresy.
- Vstup: E-mail zákazníka
- Vrací: ID zákazníka, jméno, příjmení, e-mail, datum narození, stav odběru novinek, datum registrace, poznámky
- API oprávnění:
customers(GET)
Aktualizovat zákazníka
Aktualizujte profilové informace zákazníka.
- Vstupy: ID zákazníka, jméno (volitelný), příjmení (volitelný), e-mail (volitelný), poznámky (volitelný)
- Vrací: Potvrzení se seznamem aktualizovaných polí
- API oprávnění:
customers(GET + PUT)
Konfigurace
Získat jazyky
Vylistujte všechny jazyky nakonfigurované ve vašem obchodě PrestaShop.
- Žádný vstup není vyžadován
- Vrací: Seznam jazyků s ID, názvem a ISO kódem (např.
fr,en,de) - API oprávnění:
languages(GET)
Tato akce je používána interně AI při provádění vícejazyčných aktualizací produktů, aby bylo zajištěno, že je použito správné ID jazyka.
Shrnutí tabulka
| Akce | Kategorie | Číst | Zapsat |
|---|---|---|---|
| Získat produkt | Produkty | Ano | — |
| Aktualizovat obsah produktu | Produkty | Ano | Ano |
| Aktualizovat SEO produktu | Produkty | Ano | Ano |
| Získat objednávku podle reference | Objednávky | Ano | — |
| Získat objednávky podle e-mailu | Objednávky | Ano | — |
| Získat poslední objednávku | Objednávky | Ano | — |
| Aktualizovat stav objednávky | Objednávky | — | Ano |
| Získat zákazníka | Zákazníci | Ano | — |
| Aktualizovat zákazníka | Zákazníci | Ano | Ano |
| Získat jazyky | Konfigurace | Ano | — |
Související
- API Permissions — Nakonfigurujte požadovaná oprávnění Webservice
- Webhooks & Skills — Automaticky spouštějte tyto akce při událostech obchodu