Gå til indhold
Wink

Webhook-integration

Webhooks lader dine systemer modtage realtidsnotifikationer, når der sker begivenheder på din Wink-konto — nye bookinger, aflysninger, betalingsopdateringer og mere. Denne guide fører dig gennem opsætning og bedste praksis.

Målgruppe

Sektion kaldt “Målgruppe”

Denne guide er til udviklere, der integrerer Wink med eksterne systemer såsom ejendomsadministrationssystemer (PMS), channel managers, CRM’er eller brugerdefinerede dashboards.

Sådan fungerer webhooks

Sektion kaldt “Sådan fungerer webhooks”
  1. Du registrerer en webhook-URL på Wink.
  2. Når en begivenhed opstår (f.eks. en ny booking), sender Wink en HTTP POST til din URL.
  3. Din server behandler payloaden og svarer med en 200 OK.

Opsætning af en webhook

Sektion kaldt “Opsætning af en webhook”
  1. Log ind på din konto (Extranet, Studio eller TripPay — alle understøtter webhooks).
  2. Gå til Applications og derefter Webhooks. Se Webhooks.
  3. Klik på Create webhook.
  4. Indtast et navn (f.eks. “PMS Booking Sync”).
  5. Indtast din webhook URL — HTTPS-endpointet på din server.
  6. Vælg begivenheder — Vælg specifikke begivenheder at abonnere på, eller lad det være tomt for at modtage alle begivenheder.
  7. Skift Enabled til til.
  8. Klik på Save.

Begivenhedstyper

Sektion kaldt “Begivenhedstyper”

Wink understøtter 64+ webhook-begivenhedstyper inden for kategorier som kontoadministration, bookingkontrakter, betalinger, channel manager-opdateringer og administration af enheder. Almindelige begivenheder inkluderer:

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

For en komplet liste over alle begivenhedstyper med beskrivelser, se Webhook Events Catalog.

Se alle 64+ begivenhedstyper

Bedste praksis

Sektion kaldt “Bedste praksis”
  • Brug HTTPS — Wink sender payloads kun til HTTPS-endpoints.
  • Svar hurtigt — Returner en 200 OK, så snart du modtager payloaden. Udfør tung behandling asynkront.
  • Idempotens — Din handler bør være idempotent. Wink kan forsøge at sende igen, hvis den ikke modtager et 200 svar.
  • Valider kilden — Bekræft, at indkommende forespørgsler kommer fra Wink, før du behandler dem.
  • Logning — Log hver webhook-payload, du modtager. Det gør fejlfinding af integrationsproblemer meget nemmere.

Pause og sletning

Sektion kaldt “Pause og sletning”

Du kan deaktivere en webhook uden at slette den. Dette pauser leveringen, så du kan fejlfinde uden at miste din konfiguration. Når du er klar, kan du slå den til igen.

Sletning af en webhook fjerner den permanent. Enhver integration, der er afhængig af den webhook, vil stoppe med at modtage notifikationer.

Yderligere læsning

Sektion kaldt “Yderligere læsning”