Shoptet
Shoptet připojení umožňuje agentům a workflows pracovat s daty ze Shoptet e-shopu. Siesta AI může číst produkty, objednávky, zákazníky, skladové informace a faktury, případně vytvářet nebo upravovat vybrané záznamy podle oprávnění připojení.
Rychlé připojení
- V sekci Připojení klikněte na Add Connection.
- Vyberte Shoptet.
- Zvolte dostupný způsob autentizace pro váš e-shop.
- Povolte požadovaná oprávnění nebo vložte privátní API token.
- Pojmenujte připojení a uložte ho.
Co připojení umí
- Načíst informace o e-shopu, měně, jazyku a konfiguraci.
- Vypsat produkty, načíst detail produktu a pracovat s katalogem.
- Vytvořit, upravit nebo odstranit produkt, pokud má připojení zapisovací oprávnění.
- Vypsat objednávky, načíst detail objednávky a měnit stav objednávky.
- Pracovat se zákazníky, skladovými položkami a dalšími e-commerce daty podle dostupných oprávnění.
Důležité principy
- Produkty používejte podle GUID, objednávky podle kódu objednávky. Kód objednávky berte jako text, i když vypadá jako číslo.
- OAuth připojení používá krátkodobý API access token. Pokud vyprší, Siesta AI musí získat nový token.
- Privátní API token je statický token vytvořený v administraci e-shopu. Zacházejte s ním jako s citlivým údajem.
- Seznamové operace jsou stránkované. U větších e-shopů může načtení všech dat vyžadovat více API volání.
- Shoptet používá rate limits. Při překročení limitu nebo souběžných zápisech může služba vrátit chybu a workflow by mělo akci zopakovat později.
Bezpečnost a oprávnění
Pro běžné analytické scénáře používejte jen čtecí oprávnění. Zapisovací oprávnění zapínejte pouze tam, kde agent nebo workflow skutečně vytváří nebo mění produkty a objednávky. U mazání nebo hromadných změn doporučujeme lidské potvrzení.
Doporučené použití
Shoptet připojení se hodí pro e-commerce reporting, synchronizaci objednávek, kontrolu katalogu, automatizované zpracování objednávek a práci se zákaznickými daty v rámci povolených oprávnění.