První pohled na Webhooks (v2)

POZOR: Upozorňujeme, že tato funkce nebo článek je určen pro pokročilé uživatele.

webhook je způsob, jak může aplikace nebo software jako Ultimate Multisite poskytovat jiným aplikacím informace v reálném čase. Webhook doručuje data nebo payloady jiným aplikacím v okamžiku, kdy k tomu dojde, což znamená, že data získáte okamžitě.

To je užitečné, pokud potřebujete integrovat nebo předat určitá data z Ultimate Multisite do jiného CRM nebo systému pokaždé, když je spuštěna událost. Například potřebujete odeslat jméno a e-mailovou adresu uživatele do mailing listu pokaždé, když je vytvořen nový uživatelský účet.

Jak vytvořit webhook

Chcete-li vytvořit webhook, přejděte do administračního dashboardu sítě. Klikněte na Ultimate Multisite > Webhooks > Add New Webhook.

Poté můžete upravit konfiguraci webhooku:

Při vytváření nového webhooku budete požádáni o informace jako Name, URL, a Event. Pro svůj webhook můžete použít libovolný název. Nejdůležitější pole jsou URL a Event.

URL je endpoint nebo cíl, kam Ultimate Multisite odešle payload nebo data. Toto je aplikace, která data přijme.

Zapier je nejběžnější řešení, které uživatel používá k usnadnění integrace s aplikací třetí strany. Bez platformy jako Zapier budete muset ručně vytvořit vlastní funkci, která data zachytí a zpracuje. Viz tento článek o tom, jak používat webhook Ultimate Multisite se Zapierem.

V tomto článku se podíváme na základní koncept toho, jak webhook funguje, a na události dostupné v Ultimate Multisite. Budeme používat web třetí strany s názvem requestbin.com. Tento web nám umožní vytvořit endpoint a zachytit payload bez psaní kódu. Upozornění: vše, co udělá, je, že nám ukáže, že data byla přijata. Payload nebude nijak zpracován ani s ním nebude provedena žádná akce.

Přejděte na requestbin.com a klikněte na Create Request Bin.

Po kliknutí na toto tlačítko budete vyzváni k přihlášení, pokud již máte účet, nebo k registraci. Pokud již účet máte, přesměruje vás to přímo na jejich dashboard. Na jejich dashboardu okamžitě uvidíte endpoint nebo URL, kterou můžete použít při vytváření webhooku Ultimate Multisite.

Pokračujte zkopírováním URL a vraťte se do Ultimate Multisite. Vložte endpoint do pole URL a z rozbalovací nabídky vyberte událost. V tomto příkladu vybereme Payment Received.

Tato událost se spustí pokaždé, když uživatel provede platbu. Všechny dostupné události, jejich popis a payloady jsou uvedeny dole na stránce. Kliknutím na tlačítko Add New Webhook webhook uložíte.

Nyní můžeme do endpointu odeslat testovací událost, abychom viděli, zda webhook, který jsme vytvořili, funguje. To můžeme udělat kliknutím na Send Test Event pod webhookem, který jsme vytvořili.

Zobrazí se potvrzovací okno s informací, že test byl úspěšný.

Nyní, pokud se vrátíme na web Requestbin, uvidíme, že payload byl přijat a obsahuje některá testovací data.

Toto je základní princip fungování webhooku a endpointů. Pokud chcete vytvořit vlastní endpoint, budete muset vytvořit vlastní funkci pro zpracování dat, která obdržíte z Ultimate Multisite.