Hoppa till innehåll
Wink

Webhook-integration

Webhooks låter dina system ta emot realtidsnotiser när händelser sker på ditt Wink-konto — nya bokningar, avbokningar, betalningsuppdateringar med mera. Den här guiden leder dig genom installation och bästa praxis.

Målgrupp

Section titled “Målgrupp”

Den här guiden är för utvecklare som integrerar Wink med externa system som fastighetshanteringssystem (PMS), kanalhanterare, CRM-system eller anpassade dashboards.

Hur webhooks fungerar

Section titled “Hur webhooks fungerar”
  1. Du registrerar en webhook-URL på Wink.
  2. När en händelse inträffar (t.ex. en ny bokning) skickar Wink en HTTP POST till din URL.
  3. Din server bearbetar payloaden och svarar med en 200 OK.

Ställa in en webhook

Section titled “Ställa in en webhook”
  1. Logga in på ditt konto (Extranet, Studio eller TripPay — alla stödjer webhooks).
  2. Gå till Applications och sedan Webhooks. Se Webhooks.
  3. Klicka på Create webhook.
  4. Ange ett namn (t.ex. “PMS Booking Sync”).
  5. Ange din webhook-URL — HTTPS-endpointen på din server.
  6. Välj händelser — Välj specifika händelser att prenumerera på, eller lämna tomt för att ta emot alla händelser.
  7. Slå på Enabled.
  8. Klicka på Save.

Händelsetyper

Section titled “Händelsetyper”

Wink stödjer 64+ webhook-händelsetyper inom kategorier som kontohantering, bokningskontrakt, betalningar, kanalhanteraruppdateringar och hantering av enhetsadministration. Vanliga händelser inkluderar:

KategoriExempel
Bokningbooking.create, booking.cancelled
Bokningskontraktbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Betalninginternal.payment.succeeded, internal.payment.failed
Återbetalningarbooking.contract.refund.partial, booking.contract.refund.full
Kanalhanterarechannel-manager.update.rate, channel-manager.update.availability
Kontoaccount.create, account.status.updated

För en komplett lista över alla händelsetyper med beskrivningar, se Webhook Events Catalog.

Visa alla 64+ händelsetyper

Bästa praxis

Section titled “Bästa praxis”
  • Använd HTTPS — Wink skickar payloads endast till HTTPS-endpoints.
  • Svara snabbt — Returnera en 200 OK så snart du tar emot payloaden. Gör tyngre bearbetning asynkront.
  • Idempotens — Din hanterare bör vara idempotent. Wink kan försöka leverera igen om den inte får ett 200-svar.
  • Verifiera källan — Kontrollera att inkommande förfrågningar kommer från Wink innan du bearbetar dem.
  • Loggning — Logga varje webhook-payload du tar emot. Det gör felsökning av integrationsproblem mycket enklare.

Pausa och ta bort

Section titled “Pausa och ta bort”

Du kan inaktivera en webhook utan att ta bort den. Detta pausar leveransen så att du kan felsöka utan att förlora din konfiguration. När du är redo, slå på den igen.

Att ta bort en webhook tar bort den permanent. Alla integrationer som förlitar sig på den webhooken slutar ta emot notiser.

Vidare läsning

Section titled “Vidare läsning”