Prvý pohľad na webhooks (v2)

POZOR: Tento príspevok alebo funkcia je určená pre pokročilých používateľov.

Webhook je spôsob, ako aplikácia alebo softvér ako Ultimate Multisite poskytne iným aplikáciám informácie v reálnom čase. Webhook posiela údaje alebo nálohy (payloads) iným aplikáciám hneď, čo znamená, že obtenie údajov je okamžité.

Toto je užitočné, ak potrebujete integrovať alebo predať určité údaje z Ultimate Multisite do iného CRM alebo systému pri každom spustení udalosti. Napríklad potrebujete poslať meno a e-mail používateľa na mailing list pri každom vytvorení nového účtu používateľa.

Ako vytvoriť webhook

Aby ste vytvorili webhook, prejdite do dashboardu administrátora vašej siete (network admin dashboard). Kliknite na Ultimate Multisite > Webhooks > Pridať nový webhook.

Potom môžete upraviť konfiguráciu webhooku:

Pri vytváraní nového webhooku budete vyzvaný za informáciami ako Názov, URL a Udženie (Event). Môžete si dať akýkoľvek názov pre váš webhook. Najdôležitejšie polia sú URL a Udženie (Event).

URL je bod konca alebo destinácia, kde Ultimate Multisite pošle nálohu alebo údaje. Je to aplikácia, ktorá tieto údaje prijme.

Zapier je najbežnejšie riešenie, ktoré používajú na uľahčenie integrácie s externými aplikáciami. Bez platformy ako Zapier budete musieť manuálne vytvoriť prispôsobenú funkciu, ktorá zachytí údaje a spracuje ich. Prečítajte si tento článok o tom, ako použiť webhook Ultimate Multisite s Zapierom.

V tomto článku si zameriame na základné pojmy toho, ako funguje webhook a aké udalosti sú k dispozícii v Ultimate Multisite. Použijeme externú stránku requestbin.com. Táto stránka nám umožní vytvoriť endpoint a zachytiť payload bez toho, aby sme mali pýtať o kódovanie. Vedenie: všetko, čo to urobí, je namáčať nám, že údaje boli prijaté. Na payload sa nič nebuduje ani neuskupuje žiadna akcia.

Prejdite na requestbin.com a kliknite na Create Request Bin (Vytvoriť binu požiadavky).

Po kliknutí na tu vás bude pýtať, či máte už účet alebo sa zaregistrujete. Ak máte už účet, presmerne vás presmeruje na ich dashboard. Na ich dashboard okamžite uvidíte endpoint alebo URL, ktorý môžete použiť pri vytváraní vášho webchka v Ultimate Multisite.

Kopírujte URL a vráťte sa do Ultimate Multisite. Endpoint vložte do polia URL a vyberte udalosti z rozbaľovacieho menu. V tomto príklade si vyberieme Payment Received (Prijatý platba).

Táto udalosť sa spustí, keď používateľ urobí platbu. V spodnej časti stránky sú uvedené všetky dostupné udalosti, ich popis a payloady. Kliknite na tlačidlo Add New Webhook (Pridať nový webhook), aby ste zachytili webhook.

Teraz môžeme poslať testovú udal os endpoint, aby sme videli, či funguje webhook, ktorý sme vytvorili. Môžeme to urobiť kliknutím na Send Test Event (Odoslať testovú udalosť) pod vytvoreným webchkom.

Toto zobrazuje okno potvrdenia, že test bol úspešný.

Keď sa v súbore Requestbin vráťe, uvidíte, že náklad (payload) bol prijato so z triedenými dátami.

Toto je základný princíp toho, ako fungujú webhooky a endpointy. Ak chcete vytvoriť vlastný endpoint, budete musieť vytvoriť vlastnú funkciu na spracovanie dát, ktoré dostávate od Ultimate Multisite.