FlexiBee a Integromat - SMS upozornění

Přemýšleli jste někdy o tom, že byste chtěli dostat SMS pokaždé, když se ve FlexiBee něco konkrétního stane? Například, pokud se ve FlexiBee vytvoří nová objednávka? Integromat umí posílat i SMSky.

Případy použití

SMS upozornění je zajímavá věc. Pokud začnu například s upozorněním na novou objednávku, tak je možné poslat hned minimálně dvě. Prvním případem může být upozornění pro mě, které bude obsahovat informaci o tom, že se ve FlexiBee objevila nová objednávka.

Další možností je poslat SMS přímo zákazníkovi, jako potvrzení přijetí jeho objednávky. Na každé objednávce je pole, do kterého je možné zadat telefonní číslo zákazníka (kontaktTel). Toto pole je pak možné v Itegromatu přečíst a použít jako telefonní číslo, na které se odešle upozornění. V textu pak samozřejmě můžeme seskládat pěknou zprávu, např. „Děkujeme za vaši objednávku. Evidujeme ji pod číslem OBPxxx/2017. Stav objednávky můžete sledovat na adrese mujweb.cz/objednavka/OBPxxx/2017. Hezký den“ :-).

Samozřejmě je možné posílat SMS upozornění i na jiné změny ve FlexiBee. Dojde k vyskladnění zboží? Zákazníkovi nebo nám může přijít SMS. Dojde k vytvoření nové faktury? Opět může přijít SMS. Je založen nový uživatel? Může přijít jednorázové heslo SMSkou atd.

Nastavení FlexiBee – aktivace Changes API

Ve FlexiBee je potřeba mít aktivováno Changes API, aby se mohl Integromat dozvědět o tom, že nová objednávka vznikla. Postup aktivace Changes API naleznete na stránkách FlexiBee. Není to vůbec složité. Jen je potřeba poslat prádný PUT request na adresu /changes/enable.xml

curl -k -L -u {jmeno}:{heslo} -X PUT https://localhost:5434/c/{firma}/changes/enable.xml -H Content-Length:0

Místo {jmeno} a {heslo} doplníme jméno a heslo uživatele s dostatečnými právy, místo {firma} pak zadáme identifikátor firmy, nad kterou chceme Changes API zapnout.

Tím máme FlexiBee nastaveno a můžeme začít s klikáním scénáře v Integromatu.

Scénář v Integromatu

Jednoduchý scénář v Integromatu
Jednoduchý scénář v Integromatu


Ve scénáři použijeme dvě komponenty, které jsem dosud nikde nepoužil. První z nich bude ABRA FlexiBee – Sledovat změny v evidenci (webhook) a druhou bude Android – Poslat SMS.

ABRA FlexiBee – Sledovat změny v evidenci (webhook)

Pokud máme ve FlexiBee zapnuto Changes API, je možné použít tuto komponentu a spustit scénář pokaždé, když dojde k vytvoření nové objednávky. E-Shop zapíše novou objednávku. FlexiBee notifikuje přes REST-API webhook v Integromatu a ten pak zajistí odeslání SMSky.

Nastavení komponenty pro FlexiBee WebHooks
Nastavení komponenty pro FlexiBee WebHooks


Přidáme tedy komponentu ABRA FlexiBee a zvolíme možnost Sledovat změny v evidenci (webhook). Vyplníme název webhooku (doporučuji dávat co nejpřesnější jména, protože po uložení již není možné si nastavení prohlédnout), connection do FlexiBee, vybereme firmu a evidenci (Přijaté objednávky), nad kterou chceme změny sledovat a nakonec zaškrtneme možnost Vložení záznamu.

Tím máme webhook kompletně nastaven a připraven k prvnímu použití.

ABRA FlexiBee – Načíst detail záznamu

Načíst detail záznamu z FlexiBee
Načíst detail záznamu z FlexiBee


Integromat ale jako obsah notifikace na webhook získá z FlexiBee jen ID záznamu, který byl vytvořen. Pokud nechceme posílat jen strohé notifikace (Je tu nová objednávka s ID xxx), je nutné si konkrétní záznam z FlexiBee načíst další komponentou. K tomuto účelu využijeme komponentu ABRA FlexiBee – Načíst detail záznamu. Opět vybereme správnou connection, společnost a evidenci. Jako ID předáme ID z webhooku. Itegromat teď udělá dotaz do FlexiBee a načte patřičný záznam. Teď již máme všechna pole, která budeme nejspíš potřebovat (telefonní číslo, variabilní symbol, celkovou částku, …).

Mobilní aplikace Integromat pro Android

Tak a teď už zbývá jen poslat SMS upozornění na patřičné telefonní číslo. Potřebujeme mít mobilní telefon s operačním systémem Android a pokud možno co nejnižší cenou za SMS (neomezený tarif?). Do telefonu z Obchodu stáhneme aplikaci Integromat. Po úspěšném stažení a instalaci se zobrazí možnost spárovat s Integromatem. To je celkem jednoduché, protože stačí naskenovat QR kód, který vygeneruje Integromat při přidání nového zařízení.

Také je potřeba v nastavení aplikace povolit odesílání SMS.

Android – Poslat SMS

Do scénáře v Integromatu pak přidáme modul Android – Poslat SMS. Zvolíme nebo přidáme nové zařízení. Při přidání nového se zobrazí QR kód, který naskenujeme telefonem a potvrdíme.

Modul pro komunikaci s Androidem
Modul pro komunikaci s Androidem


Do pole příjemce zadáme telefonní číslo příjemce, které je v objednávce ve FlexiBee v poli kontaktTel.

Text zprávy seskládáme z dalších informací. Je možné použít velké množství informací, které jsme z FlexiBee načetli. Máme k dispozici variabilní symbol, číslo účtu, celkovou částku, číslo objednávky. Můžeme si seskládat adresu, na které může zákazník sledovat stav objednávky atd. Jen musíme dávat pozor na to, že běžná SMS má délku 160 znaků :-).

Pár slov na závěr

Ve scénáři jsem použil modul pro Android, protože můj mobilní telefon je tímto operačním systémem obdařen. Tento modul také, na rozdíl od modulu Apple iOS, umí odesílat SMS. Modul pro iPhone umí odesílat „jen“ push notifikace, takže se nehodí pro upozorňování zákazníků.

Pokud tedy váš e-shop neumí odesílat SMSky, tak toto je velmi jednoduché řešení. Napojte si e-shop na FlexiBee a Integromatem pak zajistíte upozornění zákazníka :-).

A cena tohoto řešení? Starších telefonů s androidem se dneska všude válí mraky a koupě nového je otázkou maximálně 2 000 Kč. K tomu nějaký SMSkově neomezený tarif. Podle úspěšnosti e-shopu možná první nebo druhý placený tarif Integromatu. Možná ale bude stačit i FREE. Telefon napojit na wi-fi, strčit do zásuvky a uklidit do skladu :-). Takže náklady budou tak 500 až 1000 Kč na měsíc.

Pokud budeme z telefonu i volat, tak předpokládám, že náklady na toto řešení budou výrazně nižší :-).

ABRA FlexiBee, Integromat, REST API, SMS upozornění

- (11. 8. 2017)
Kája z Norska
Kája z Norska

Jsem programátor, horolezec a tak trochu FlexiBee fanatik :-).
Na CharlieBlogu sepisuji své nápady a poznatky už od roku 2006.