Saltar al contingut
Wink

Integració de Webhooks

Els webhooks permeten que els vostres sistemes rebin notificacions en temps real quan es produeixen esdeveniments al vostre compte Wink — noves reserves, cancel·lacions, actualitzacions de pagaments i més. Aquesta guia us acompanya en la configuració i les millors pràctiques.

Públic

Section titled “Públic”

Aquesta guia és per a desenvolupadors que integren Wink amb sistemes externs com sistemes de gestió de propietats (PMS), gestors de canals, CRM o panells personalitzats.

Com funcionen els webhooks

Section titled “Com funcionen els webhooks”
  1. Registreu una URL de webhook a Wink.
  2. Quan es produeix un esdeveniment (per exemple, una nova reserva), Wink envia un HTTP POST a la vostra URL.
  3. El vostre servidor processa la càrrega útil i respon amb un 200 OK.

Configuració d’un webhook

Section titled “Configuració d’un webhook”
  1. Inicieu sessió al vostre compte (Extranet, Studio o TripPay — tots suporten webhooks).
  2. Navegueu a Applications i després a Webhooks. Vegeu Webhooks.
  3. Feu clic a Create webhook.
  4. Introduïu un nom (per exemple, “Sincronització de reserves PMS”).
  5. Introduïu la vostra URL de webhook — el punt final HTTPS al vostre servidor.
  6. Seleccioneu esdeveniments — trieu esdeveniments específics als quals subscriure-us, o deixeu-ho buit per rebre tots els esdeveniments.
  7. Activeu el botó Enabled.
  8. Feu clic a Save.

Tipus d’esdeveniments

Section titled “Tipus d’esdeveniments”

Wink suporta més de 64 tipus d’esdeveniments de webhook en categories que inclouen gestió de comptes, contractes de reserva, pagaments, actualitzacions de gestors de canals i administració d’entitats. Els esdeveniments més comuns inclouen:

CategoriaExemples
Reservabooking.create, booking.cancelled
Contracte de reservabooking.contract.created, booking.contract.processing, booking.contract.cancelled
Pagamentinternal.payment.succeeded, internal.payment.failed
Reemborsamentsbooking.contract.refund.partial, booking.contract.refund.full
Gestor de canalschannel-manager.update.rate, channel-manager.update.availability
Compteaccount.create, account.status.updated

Per a una llista completa de tots els tipus d’esdeveniments amb descripcions, consulteu el Catàleg d’esdeveniments de Webhook.

Veure tots els més de 64 tipus d’esdeveniments

Millors pràctiques

Section titled “Millors pràctiques”
  • Utilitzeu HTTPS — Wink envia càrregues útils només a punts finals HTTPS.
  • Responeu ràpidament — Retorneu un 200 OK tan aviat com rebeu la càrrega útil. Feu qualsevol processament pesat de manera asíncrona.
  • Idempotència — El vostre gestor ha de ser idempotent. Wink pot tornar a intentar l’entrega si no rep una resposta 200.
  • Valideu la font — Verifiqueu que les sol·licituds entrants provenen de Wink abans de processar-les.
  • Registre — Registreu cada càrrega útil de webhook que rebeu. Això facilita molt la depuració de problemes d’integració.

Pausar i eliminar

Section titled “Pausar i eliminar”

Podeu desactivar un webhook sense eliminar-lo. Això pausa l’entrega perquè pugueu resoldre problemes sense perdre la configuració. Quan estigueu preparats, torneu a activar-lo.

Eliminar un webhook el suprimeix permanentment. Qualsevol integració que depengui d’aquest webhook deixarà de rebre notificacions.

Lectures complementàries

Section titled “Lectures complementàries”