Et første blik på webhooks (v2)

OPMÆRKSOM: Bemærk venligst, at denne funktion eller artikel er til avancerede brugere.

En webhook er en måde for en app eller software som Ultimate Multisite at give andre apps realtidsinformation. En webhook leverer data eller payloads til andre apps, så snart de sker, hvilket betyder, at du får data med det samme.

Dette er nyttigt, hvis du skal integrere eller sende visse data fra Ultimate Multisite til et andet CRM eller system hver gang en begivenhed udløses. For eksempel skal du sende brugerens navn og e-mailadresse til en mailingliste hver gang en ny brugerkonto oprettes.

Sådan opretter du en webhook

For at oprette en webhook skal du gå til dit netværksadministrator dashboard. Klik på Ultimate Multisite > Webhooks > Tilføj ny webhook.

Derefter kan du redigere webhook-konfigurationen:

Når du opretter en ny webhook vil du blive bedt om information som Navn, URL og Begivenhed. Du kan bruge et hvilket som helst navn til din webhook. De vigtigste felter er dog URL'en og Begivenheden.

URL'en er endpoint eller destination, som Ultimate Multisite vil sende payload eller data til. Det er applikationen, der modtager dataene.

Zapier er den mest almindelige løsning, som brugere bruger til at gøre integration med tredjepartsapps lettere. Uden en platform som Zapier skal du manuelt oprette en custom funktion, der fanger og behandler dataene. Se denne artikel om hvordan man bruger Ultimate Multisite webhook med Zapier.

I denne artikel kigger vi på det grundlæggende koncept med, hvordan en webhook fungerer, og hvilke events der er tilgængelige i Ultimate Multisite. Vi vil bruge en tredjepartsplatform kaldet requestbin.com. Denne side lader os oprette et endpoint og fange payload'en uden at skulle kode noget. Ansvarsfraskrivelse: alt, den gør, er at vise os, at data har været modtaget. Der vil ikke blive foretaget nogen behandling eller handling på payload'en.

Gå til requestbin.com og klik på Create Request Bin.

Efter at have klikket på knappen bliver du bedt om at logge ind, hvis du allerede har en konto, eller oprette en ny. Hvis du allerede har en konto, vil det føre dig direkte til dit dashboard. På deres dashboard ser du straks endpoint'en eller URL'en, du kan bruge til at oprette din Ultimate Multisite webhook.

Kopier derefter URL'en og gå tilbage til Ultimate Multisite. Indsæt endpoint'en i feltet for URL og vælg en event fra rullemenuen. I dette eksempel vælger vi Payment Received (Betaling modtaget).

Denne event udløses hver gang en bruger foretager et betalingstransaktion. Alle tilgængelige events, deres beskrivelser og payloads findes nederst på siden. Klik på knappen Add New Webhook for at gemme webhoken.

Nu kan vi sende en testevent til endpoint'en for at se, om den webhook, vi har oprettet, virker. Vi kan gøre dette ved at klikke på Send Test Event under den webhook, du har oprettet.

Dette viser et bekræftelsesvindue, der siger, at testen var succesfuld.

Når vi går tilbage til Requestbin sitet, vil du se, at payload'en er modtaget med nogle testdata.

Dette er grundprincippet for, hvordan webhooks og endpoints fungerer. Hvis du skal oprette et custom endpoint, skal du lave en custom funktion til at behandle de data, du modtager fra Ultimate Multisite.