Nastavenie webhooku

Webhook nastavíte raz v Nastaveniach a Gram potom odosiela správy do druhého systému automaticky. Potrebujete adresu, na ktorú sa majú údaje posielať, a ak ju druhý systém chráni, aj prihlasovacie údaje alebo token. Obe vám dá dodávateľ druhého systému.

Kde webhooky nájdete

V aplikácii otvorte Nastavenia, Integrácie, Webhooky. Uvidíte zoznam webhookov a môžete pridať nový. Webhooky môže spravovať len správca s oprávnením upravovať systémové nastavenia. Webhooky sú v plánoch Plus a Professional.

Pridanie webhooku

Formulár webhooku má niekoľko častí. Vyplňte ich zhora nadol a webhook uložte.

Cieľ

Miesto, kam Gram odosiela požiadavky webhooku.

Názov: podľa neho webhook spoznáte v zozname a pri kroku v Automatizácii, napríklad Objednávky do skladu.
URL: adresa druhého systému, na ktorú Gram údaje pošle, napríklad https://sklad.vasafirma.sk/gramcrm.
E-mail: na túto adresu Gram pošle upozornenie, keď sa webhook dlhšie nedarí doručiť, keď sa doručovanie obnoví a keď sa webhook po dlhom výpadku zruší. Pole je nepovinné, bez neho však o výpadku nebudete vedieť. Odporúčame adresu toho, kto sa o druhý systém stará.

Spúšťač

Pri každom webhooku vyberiete jeden z dvoch spôsobov odoslania.

Udalosti záznamu: Gram odošle webhook pri vytvorení, úprave alebo zmazaní vybraného záznamu. Správa obsahuje typ záznamu, jeho Id a informáciu o tom, čo sa stalo. Aktuálne údaje si druhý systém načíta cez API. Hodí sa napríklad na zosúladenie klientov alebo produktov: keď obchodník zmení adresu klienta, e-shop si načíta nové údaje.

Automatizácia: webhook odošle pracovný postup krokom Odoslať webhook. Podmienky postupu určia, kedy sa webhook odošle, a priamo v kroku vyberiete údaje, ktoré má obsahovať. Hodí sa napríklad vtedy, keď chcete odoslať len vyhraté obchodné prípady. Postup nastavíte podľa návodu Odoslanie webhooku z automatizácie.

	Udalosti záznamu	Automatizácia
Kedy sa odošle	pri vybranej zmene záznamu	podľa pracovného postupu
Čo sa odošle	typ záznamu, Id a udalosť	vybrané údaje
Kde sa nastaví	v Nastaveniach	v Nastaveniach a v pracovnom postupe

Pri spúšťači Automatizácia sa časti Udalosti a Typy záznamov skryjú, o tom, kedy a čo sa odošle, rozhoduje pracovný postup.

Autorizácia

Spôsob, akým sa Gram preukáže druhému systému, aby ten vedel, že požiadavka naozaj prichádza z vášho Gramu. Ktorý spôsob použiť, vám povie dodávateľ druhého systému.

Možnosť	Čo vyplníte
Žiadna	nič, druhý systém požiadavku neoveruje
Basic (užívateľ + heslo)	meno používateľa a heslo
Bearer token	token
Vlastná hlavička	názov hlavičky (predvolený je `X-Token`) a jej hodnotu

Ak druhý systém autorizáciu podporuje, vždy ju nastavte. Bez nej by váš systém mohol prijať požiadavku od kohokoľvek, kto pozná jeho adresu.

Udalosti

Vyberte, ktoré zmeny záznamov webhook spustia: vytvorenie, úprava alebo zmazanie. Môžete zaškrtnúť aj viac možností naraz.

Bez zaškrtnutej udalosti sa webhook nespustí nikdy. Ak webhook nič neposiela, skontrolujte najprv túto časť.

Typy záznamov

Vyberte, na ktoré záznamy sa webhook vzťahuje, napríklad Klienti, Objednávky alebo vaše vlastné entity.

Bez vybraného typu záznamu platí webhook pre všetky záznamy. Druhý systém potom dostane správu o každej zmene v Grame, aj o aktivitách a poznámkach, a takých správ môže byť veľmi veľa. Vyberte preto len tie typy, ktoré druhý systém naozaj potrebuje.

Úprava webhooku

Webhook otvoríte zo zoznamu a zmeníte ako ktorýkoľvek iný záznam. Uložené heslá a tokeny sa vo formulári zobrazujú ako ********. Ak ich nezmeníte, ostanú také, aké boli. Nové heslo alebo token stačí prepísať.

Ak sa doručovanie po dlhom výpadku zrušilo, formulár to ukáže. Ako webhook znova zapnúť, je v návode Výpadky a doručovanie webhooku.

Otázky a odpovede

Prečo webhook nič neposiela?

Pri spúšťači Udalosti záznamu skontrolujte, či je zaškrtnutá aspoň jedna udalosť a či ste vybrali správny typ záznamu. Pri spúšťači Automatizácia musí webhook použiť pracovný postup v kroku Odoslať webhook. Ak bol druhý systém dlhšie nedostupný, doručovanie sa mohlo zrušiť, pozrite Výpadky a doručovanie webhooku.

Dokáže webhook údaje do Gramu aj prijať?

Nie, webhooky posielajú údaje len z Gramu von. Na zápis údajov do Gramu z iného systému slúži API.

Môžem mať viac webhookov?

Áno. Každý webhook má vlastnú adresu, spúšťač a autorizáciu, takže napríklad objednávky môžu ísť do skladu a klienti do e-shopu.

Mohlo by vás tiež zaujímať: