Pierwsze spojrzenie na webhooki (v2)

UWAGA: Ta funkcja i artykuł są przeznaczone dla zaawansowanych użytkowników.

Webhook to sposób, w jaki aplikacja lub oprogramowanie takie jak Ultimate Multisite może przekazywać innym aplikacjom informacje w czasie rzeczywistym. Webhook dostarcza dane do innych aplikacji natychmiast po ich wystąpieniu, co oznacza, że otrzymujesz dane od razu.

Jest to przydatne, gdy potrzebujesz zintegrować lub przekazać określone dane z Ultimate Multisite do innego systemu CRM lub innej aplikacji za każdym razem, gdy zostanie wywołane jakieś zdarzenie. Na przykład, gdy chcesz wysłać imię i adres e-mail użytkownika do listy mailingowej za każdym razem, gdy zostanie utworzone nowe konto użytkownika.

Jak utworzyć webhook

Aby utworzyć webhook, przejdź do panelu administracyjnego sieci. Kliknij Ultimate Multisite > Webhooks > Add New Webhook.

Podczas tworzenia nowego webhooka zostaniesz poproszony o podanie informacji takich jak Name, URL i Event. Możesz użyć dowolnej nazwy dla swojego webhooka. Najważniejszymi polami są URL i Event.

URL to punkt końcowy lub miejsce docelowe, do którego Ultimate Multisite będzie wysyłać payload, czyli dane. To jest aplikacja, która otrzyma dane.

Zapier to najczęściej używane rozwiązanie, które ułatwia integrację z aplikacjami zewnętrznymi. Bez platformy takiej jak Zapier, będziesz musiał ręcznie stworzyć własną funkcję, która przechwyci dane i je przetworzy. Zobacz ten artykuł o tym, jak używać webhooka Ultimate Multisite z Zapier.

W tym artykule przyjrzymy się podstawowej koncepcji działania webhooka oraz zdarzeniom dostępnym w Ultimate Multisite. Będziemy korzystać z zewnętrznej strony requestbin.com. Ta strona pozwoli nam utworzyć punkt końcowy i przechwycić payload bez pisania kodu. Uwaga: jedyne co zrobimy, to zobaczymy, że dane zostały odebrane. Nie będzie żadnego przetwarzania ani żadnych innych działań wykonanych na payloadzie.

Przejdź na stronę requestbin.com i kliknij Create Request Bin.

Po kliknięciu tego przycisku zostaniesz poproszony o zalogowanie się, jeśli masz już konto, lub o rejestrację. Jeśli masz już konto, zostaniesz przekierowany bezpośrednio do panelu. W panelu od razu zobaczysz punkt końcowy lub URL, którego możesz użyć do utworzenia webhooka Ultimate Multisite.

Skopiuj URL i wróć do Ultimate Multisite. Wklej punkt końcowy w polu URL i wybierz zdarzenie z listy rozwijanej. W tym przykładzie wybierzemy Payment Received.

To zdarzenie jest wywoływane za każdym razem, gdy użytkownik dokonuje płatności. Wszystkie dostępne zdarzenia, ich opisy i payloady są wymienione na dole strony. Kliknij przycisk Add New Webhook, aby zapisać webhook.

Teraz możemy wysłać testowe zdarzenie do punktu końcowego, aby sprawdzić, czy utworzony webhook działa. Możemy to zrobić, klikając Send Test Event pod utworzonym webhookiem.

Pojawi się okno potwierdzenia informujące, że test zakończył się pomyślnie.

Teraz, jeśli wrócimy na stronę Requestbin, zobaczymy, że payload został odebrany i zawiera dane testowe.

To jest podstawowa zasada działania webhooków i punktów końcowych. Jeśli chcesz utworzyć własny punkt końcowy, będziesz musiał stworzyć własną funkcję do przetwarzania danych otrzymanych z Ultimate Multisite.