Sari la conținut
Wink

Integrare Webhook

Webhooks permit sistemelor tale să primească notificări în timp real când apar evenimente în contul tău Wink — rezervări noi, anulări, actualizări de plată și altele. Acest ghid te ghidează prin configurare și bune practici.

Public țintă

Section titled “Public țintă”

Acest ghid este destinat dezvoltatorilor care integrează Wink cu sisteme externe precum sisteme de management al proprietăților (PMS), channel manageri, CRM-uri sau dashboard-uri personalizate.

Cum funcționează webhooks

Section titled “Cum funcționează webhooks”
  1. Înregistrezi o adresă URL webhook pe Wink.
  2. Când apare un eveniment (de ex., o rezervare nouă), Wink trimite un HTTP POST către URL-ul tău.
  3. Serverul tău procesează payload-ul și răspunde cu un 200 OK.

Configurarea unui webhook

Section titled “Configurarea unui webhook”
  1. Autentifică-te în contul tău (Extranet, Studio sau TripPay — toate suportă webhooks).
  2. Navighează la Applications și apoi Webhooks. Vezi Webhooks.
  3. Apasă pe Create webhook.
  4. Introdu un nume (de ex., “Sincronizare rezervări PMS”).
  5. Introdu URL-ul webhook-ului — endpoint-ul HTTPS de pe serverul tău.
  6. Selectează evenimentele — Alege evenimente specifice la care să te abonezi sau lasă gol pentru a primi toate evenimentele.
  7. Activează comutatorul Enabled.
  8. Apasă Save.

Tipuri de evenimente

Section titled “Tipuri de evenimente”

Wink suportă peste 64 de tipuri de evenimente webhook în categorii precum managementul contului, contracte de rezervare, plăți, actualizări channel manager și administrarea entităților. Evenimente comune includ:

CategorieExemple
Rezervarebooking.create, booking.cancelled
Contract rezervarebooking.contract.created, booking.contract.processing, booking.contract.cancelled
Platăinternal.payment.succeeded, internal.payment.failed
Rambursăribooking.contract.refund.partial, booking.contract.refund.full
Channel managerchannel-manager.update.rate, channel-manager.update.availability
Contaccount.create, account.status.updated

Pentru o listă completă cu toate tipurile de evenimente și descrierile lor, vezi Catalogul Evenimentelor Webhook.

Vezi toate cele 64+ tipuri de evenimente

Bune practici

Section titled “Bune practici”
  • Folosește HTTPS — Wink trimite payload-uri doar către endpoint-uri HTTPS.
  • Răspunde rapid — Returnează un 200 OK imediat ce primești payload-ul. Procesează orice sarcină grea asincron.
  • Idempotentă — Handler-ul tău trebuie să fie idempotent. Wink poate retrimite dacă nu primește un răspuns 200.
  • Validează sursa — Verifică că cererile primite provin de la Wink înainte de procesare.
  • Logare — Înregistrează fiecare payload webhook primit. Acest lucru facilitează mult depanarea problemelor de integrare.

Pauză și ștergere

Section titled “Pauză și ștergere”

Poți dezactiva un webhook fără să-l ștergi. Aceasta oprește livrarea pentru a putea depana fără să pierzi configurația. Când ești gata, activează-l din nou.

Ștergerea unui webhook îl elimină definitiv. Orice integrare care depinde de acel webhook va înceta să primească notificări.

Lecturi suplimentare

Section titled “Lecturi suplimentare”