Jak napojit chatbota na objednávky ve WooCommerce

Běžný chatbot odpoví na dopravu, vrácení nebo parametry produktu, protože to všechno stojí ve vašem obsahu. Na dotaz „kde je moje objednávka číslo 1042?" ale odpovědět neumí, ta informace nikde na webu není. Žije ve vašem WooCommerce a mění se každou hodinu.

Vlastní akce (beta) to řeší. Napojí asistenta na WooCommerce REST API, takže si stav objednávky načte živě a odpoví na něj sám, bez operátora a bez pluginu. V tomto návodu si to nastavíte krok za krokem.

Co budete potřebovat

• Tarif Pro nebo vyšší (funguje i ve zkušební verzi). Vlastní akce jsou beta funkce dostupná od Pro.
• WooCommerce e-shop s přístupem do administrace WordPressu.
• Pár minut. Připravená šablona udělá většinu práce za vás.

Krok 1: Vygenerujte klíče k WooCommerce REST API

WooCommerce má vestavěné REST API, jen mu vytvoříte přístupový klíč. V administraci WordPressu jděte do WooCommerce → Nastavení → Pokročilé → REST API a dejte Přidat klíč.

• Popis: ať poznáte, k čemu klíč je, například „Breezaro chatbot".
• Uživatel: účet s právy vidět objednávky.
• Oprávnění: stačí Čtení. Asistent nikdy nic nezapisuje, takže mu víc práv nedávejte.

Po uložení WooCommerce ukáže Consumer key a Consumer secret. Zobrazí se jen jednou, tak si je hned zkopírujte. Podrobnosti k autentizaci najdete v oficiální dokumentaci WooCommerce REST API.

Krok 2: Založte akci ze šablony v Breezaro

V dashboardu otevřete Vlastní akce a v galerii šablon zvolte Stav objednávky (WooCommerce). Šablona předvyplní skoro všechno:

• Metodu a adresu. GET https://vas-eshop.cz/wp-json/wc/v3/orders/{{orderNumber}}, jen vas-eshop.cz přepíšete na svou doménu.
• Vstupy. orderNumber (číslo objednávky) a email. Ty si asistent od zákazníka vyžádá sám.
• Výběr polí. Z odpovědi WooCommerce se asistentovi předají jen užitečná pole (stav, datum, položky, částka, měna), ne celý technický objekt.

Zbývá doplnit autentizaci: do tajné hlavičky vložíte Consumer key a Consumer secret z prvního kroku. Breezaro je uloží šifrovaně a po uložení už se nikdy nezobrazí. Postup je popsaný přímo u šablony.

Krok 3: Zapněte ověření vlastnictví

Tohle je nejdůležitější krok, nepřeskakujte ho. Bez něj by kdokoli, kdo tipne číslo objednávky, viděl cizí data.

Šablona má ověření nastavené rovnou: e-mail od zákazníka se musí shodovat s fakturačním e-mailem objednávky. Asistent se tedy nejdřív zeptá na e-mail, a pokud nesedí s objednávkou, chová se, jako by objednávka neexistovala. Zákazník nepozná rozdíl mezi „špatné číslo" a „cizí objednávka" a hádání se navíc omezuje.

Pokud číslo objednávky a e-mail posíláte přímo do jiného endpointu, který filtruje sám, otestujte akci jednou se záměrně špatným e-mailem. Když se objednávka vrátí i tak, endpoint podle e-mailu nefiltruje a ověření vlastnictví v Breezaru rozhodně nechte zapnuté.

Krok 4: Otestujte a zapněte

V editoru je testovací krok. Zadejte reálné číslo objednávky a odpovídající e-mail a spusťte test. Uvidíte přesně tu odpověď, kterou by dostal asistent, i výsledek ověření. Akci lze zapnout až po úspěšném testu, takže špatně nastavený endpoint se k zákazníkům nedostane.

Jakmile test projde, akci zapněte. Od té chvíle asistent při dotazu na objednávku sám zavolá WooCommerce a odpoví aktuálním stavem.

Jak to je s bezpečností

Vlastní akce jsou navržené tak, aby špatně nastavená akce nemohla uškodit:

• Jen čtení, jen HTTPS. Povolené jsou pouze požadavky GET a POST na veřejné adresy; na interní síť se akce nedostane.
• Klíče jsou šifrované a po uložení se už nikdy nezobrazí, ani vašemu týmu.
• Ověření vlastnictví hlídá, že zákazník uvidí jen svou objednávku.
• Výběr polí posílá asistentovi jen to, co potřebuje, ne celý záznam.
• Asistent smí v jedné odpovědi zavolat nejvýš dvě akce a volání jsou limitovaná, takže je nelze zneužít k zahlcení vašeho e-shopu.

Kolik stojí odpověď s akcí

Každé volání akce se účtuje jako jedna odpověď navíc v kreditové sazbě vašeho modelu. Dotaz na stav objednávky, u kterého asistent zavolá WooCommerce, tak stojí dvojnásobek běžné odpovědi: u modelu za 1 kredit jsou to 2 kredity, u modelu za 3 kredity 6 kreditů. Když se zákazník ptá na něco jiného a akce se nezavolá, neplatíte nic navíc.

Co dál

Stejným způsobem napojíte i další systémy, které mají HTTP API, vlastní akce nejsou vázané jen na WooCommerce. Kompletní přehled možností najdete v dokumentaci k vlastním akcím.

Vlastní akce jsou zatím v beta verzi. Pokud je chcete vyzkoušet, ozvěte se nám a zapneme vám je.