Siirry sisältöön
Wink

Webhook-integraatio

Webhookit mahdollistavat järjestelmiesi vastaanottaa reaaliaikaisia ilmoituksia, kun tapahtumia tapahtuu Wink-tililläsi — uusia varauksia, peruutuksia, maksupäivityksiä ja muuta. Tämä opas ohjaa sinut asennuksen ja parhaiden käytäntöjen läpi.

Kohdeyleisö

Osio nimeltä “Kohdeyleisö”

Tämä opas on tarkoitettu kehittäjille, jotka integroivat Wink:iä ulkoisiin järjestelmiin, kuten kiinteistöhallintajärjestelmiin (PMS), kanavahallintaan, CRM-järjestelmiin tai räätälöityihin hallintapaneeleihin.

Miten webhookit toimivat

Osio nimeltä “Miten webhookit toimivat”
  1. Rekisteröit webhook-URL:n Winkissä.
  2. Kun tapahtuma tapahtuu (esim. uusi varaus), Wink lähettää HTTP POST -pyynnön URL-osoitteeseesi.
  3. Palvelimesi käsittelee tiedot ja vastaa 200 OK.

Webhookin asennus

Osio nimeltä “Webhookin asennus”
  1. Kirjaudu tilillesi (Extranet, Studio tai TripPay — kaikki tukevat webhookeja).
  2. Siirry kohtaan Applications ja sitten Webhooks. Katso Webhooks.
  3. Klikkaa Create webhook.
  4. Anna nimi (esim. “PMS Booking Sync”).
  5. Syötä webhook-URL — HTTPS-päätepiste palvelimellasi.
  6. Valitse tapahtumat — Valitse tilattavat tapahtumat tai jätä tyhjäksi vastaanottaaksesi kaikki tapahtumat.
  7. Kytke Enabled päälle.
  8. Klikkaa Save.

Tapahtumatyypit

Osio nimeltä “Tapahtumatyypit”

Wink tukee yli 64 webhook-tapahtumatyyppiä eri kategorioissa, kuten tilinhallinta, varaus-sopimukset, maksut, kanavahallinnan päivitykset ja hallintoyksikön hallinta. Yleisiä tapahtumia ovat:

KategoriaEsimerkkejä
Varausbooking.create, booking.cancelled
Varaussopimusbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Maksuinternal.payment.succeeded, internal.payment.failed
Hyvityksetbooking.contract.refund.partial, booking.contract.refund.full
Kanavahallintachannel-manager.update.rate, channel-manager.update.availability
Tiliaccount.create, account.status.updated

Täydellisen listan kaikista tapahtumatyypeistä ja kuvauksista löydät Webhook Events Catalog -osiosta.

Näytä kaikki yli 64 tapahtumatyyppiä

Parhaat käytännöt

Osio nimeltä “Parhaat käytännöt”
  • Käytä HTTPS:ää — Wink lähettää tiedot vain HTTPS-päätepisteisiin.
  • Vastaa nopeasti — Palauta 200 OK heti, kun vastaanotat tiedot. Tee raskaat käsittelyt asynkronisesti.
  • Idempotenssi — Käsittelijäsi tulee olla idempotentti. Wink voi yrittää uudelleen, jos 200-vastausta ei saada.
  • Vahvista lähde — Varmista, että saapuvat pyynnöt ovat peräisin Winkistä ennen käsittelyä.
  • Lokitus — Kirjaa kaikki vastaanottamasi webhook-tiedot. Tämä helpottaa integrointiongelmien vianmääritystä.

Tauko ja poisto

Osio nimeltä “Tauko ja poisto”

Voit poistaa käytöstä webhookin ilman, että poistat sitä. Tämä keskeyttää toimituksen, jotta voit vianmäärityksen aikana säilyttää asetukset. Kun olet valmis, kytke se takaisin päälle.

Webhookin poistaminen poistaa sen pysyvästi. Kaikki integraatiot, jotka käyttävät kyseistä webhookia, lakkaavat vastaanottamasta ilmoituksia.

Lisälukemista

Osio nimeltä “Lisälukemista”