Skip to content
Wink

Webhook-integrasjon

Webhooks lar systemene dine motta sanntidsvarsler når hendelser skjer på Wink-kontoen din — nye bestillinger, avbestillinger, betalingsoppdateringer og mer. Denne guiden tar deg gjennom oppsett og beste praksis.

Målgruppe

Section titled “Målgruppe”

Denne guiden er for utviklere som integrerer Wink med eksterne systemer som eiendomsadministrasjonssystemer (PMS), kanaladministratorer, CRM-er eller tilpassede dashbord.

Hvordan webhooks fungerer

Section titled “Hvordan webhooks fungerer”
  1. Du registrerer en webhook-URL på Wink.
  2. Når en hendelse inntreffer (f.eks. en ny bestilling), sender Wink en HTTP POST til URL-en din.
  3. Serveren din behandler innholdet og svarer med en 200 OK.

Sette opp en webhook

Section titled “Sette opp en webhook”
  1. Logg inn på kontoen din (Extranet, Studio eller TripPay — alle støtter webhooks).
  2. Gå til Applications og deretter Webhooks. Se Webhooks.
  3. Klikk på Create webhook.
  4. Skriv inn et navn (f.eks. “PMS Booking Sync”).
  5. Skriv inn din webhook-URL — HTTPS-endepunktet på serveren din.
  6. Velg hendelser — Velg spesifikke hendelser å abonnere på, eller la stå tomt for å motta alle hendelser.
  7. Slå på Enabled.
  8. Klikk Save.

Hendelsestyper

Section titled “Hendelsestyper”

Wink støtter 64+ webhook-hendelsestyper innen kategorier som kontoadministrasjon, bookingkontrakter, betalinger, kanaladministratoroppdateringer og administrasjon av enheter. Vanlige hendelser inkluderer:

KategoriEksempler
Bookingbooking.create, booking.cancelled
Bookingkontraktbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Betalinginternal.payment.succeeded, internal.payment.failed
Refusjonerbooking.contract.refund.partial, booking.contract.refund.full
Kanaladministratorchannel-manager.update.rate, channel-manager.update.availability
Kontoaccount.create, account.status.updated

For en komplett liste over alle hendelsestyper med beskrivelser, se Webhook Events Catalog.

Se alle 64+ hendelsestyper

Beste praksis

Section titled “Beste praksis”
  • Bruk HTTPS — Wink sender innhold kun til HTTPS-endepunkter.
  • Svar raskt — Returner en 200 OK så snart du mottar innholdet. Gjør tung prosessering asynkront.
  • Idempotens — Håndtereren din bør være idempotent. Wink kan prøve å sende på nytt hvis den ikke mottar 200.
  • Valider kilden — Bekreft at innkommende forespørsler kommer fra Wink før behandling.
  • Logging — Logg alle webhook-innhold du mottar. Dette gjør feilsøking av integrasjonsproblemer mye enklere.

Pause og sletting

Section titled “Pause og sletting”

Du kan deaktivere en webhook uten å slette den. Dette pauser leveringen slik at du kan feilsøke uten å miste konfigurasjonen. Når du er klar, slår du den på igjen.

Å slette en webhook fjerner den permanent. Enhver integrasjon som er avhengig av den webhooken vil slutte å motta varsler.

Videre lesning

Section titled “Videre lesning”