Ga naar inhoud
Wink

Webhook-integratie

Webhooks laten je systemen realtime meldingen ontvangen wanneer er gebeurtenissen plaatsvinden op je Wink-account — nieuwe boekingen, annuleringen, betalingsupdates en meer. Deze gids begeleidt je bij de setup en beste praktijken.

Doelgroep

Section titled “Doelgroep”

Deze gids is bedoeld voor ontwikkelaars die Wink integreren met externe systemen zoals property management systemen (PMS), channel managers, CRM’s of aangepaste dashboards.

Hoe webhooks werken

Section titled “Hoe webhooks werken”
  1. Je registreert een webhook-URL op Wink.
  2. Wanneer er een gebeurtenis plaatsvindt (bijv. een nieuwe boeking), stuurt Wink een HTTP POST naar jouw URL.
  3. Je server verwerkt de payload en reageert met een 200 OK.

Een webhook instellen

Section titled “Een webhook instellen”
  1. Log in op je account (Extranet, Studio of TripPay — allemaal ondersteunen webhooks).
  2. Ga naar Applications en vervolgens Webhooks. Zie Webhooks.
  3. Klik op Create webhook.
  4. Voer een naam in (bijv. “PMS Booking Sync”).
  5. Voer je webhook-URL in — het HTTPS-eindpunt op je server.
  6. Selecteer gebeurtenissen — Kies specifieke gebeurtenissen om op te abonneren, of laat leeg om alle gebeurtenissen te ontvangen.
  7. Zet Enabled aan.
  8. Klik op Save.

Soorten gebeurtenissen

Section titled “Soorten gebeurtenissen”

Wink ondersteunt verschillende soorten gebeurtenissen. Veelvoorkomende gebeurtenissen zijn:

  • Boeking aangemaakt — Er is een nieuwe boeking bevestigd.
  • Boeking geannuleerd — Een boeking is geannuleerd.
  • Betaling voltooid — Betaling is verwerkt.
  • Boeking bijgewerkt — Details van een boeking zijn gewijzigd.

Beste praktijken

Section titled “Beste praktijken”
  • Gebruik HTTPS — Wink stuurt payloads alleen naar HTTPS-eindpunten.
  • Reageer snel — Geef zo snel mogelijk een 200 OK terug zodra je de payload ontvangt. Voer zware verwerking asynchroon uit.
  • Idempotentie — Je handler moet idempotent zijn. Wink kan de levering opnieuw proberen als het geen 200-antwoord ontvangt.
  • Valideer de bron — Verifieer dat binnenkomende verzoeken van Wink komen voordat je ze verwerkt.
  • Logging — Log elke webhook-payload die je ontvangt. Dit maakt het debuggen van integratieproblemen veel eenvoudiger.

Pauzeren en verwijderen

Section titled “Pauzeren en verwijderen”

Je kunt een webhook uitschakelen zonder deze te verwijderen. Dit pauzeert de levering zodat je kunt troubleshooten zonder je configuratie te verliezen. Wanneer je klaar bent, zet je hem weer aan.

Het verwijderen van een webhook verwijdert deze permanent. Elke integratie die op die webhook vertrouwt, ontvangt dan geen meldingen meer.

Verdere lectuur

Section titled “Verdere lectuur”