Integrare Webhook

Webhook-urile 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 plăți și altele. Acest ghid te conduce prin configurare și bune practici.

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 panouri de control personalizate.

Cum funcționează webhook-urile

1. Înregistrezi o adresă URL webhook pe Wink.
2. Când apare un eveniment (de exemplu, 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

1. Autentifică-te în contul tău (Extranet, Studio sau TripPay — toate suportă webhook-uri).
2. Navighează la Applications și apoi la Webhooks. Vezi Webhooks.
3. Apasă pe Create webhook.
4. Introdu un nume (de exemplu, “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

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:

Categorie	Exemple
Rezervare	booking.create, booking.cancelled
Contract rezervare	booking.contract.created, booking.contract.processing, booking.contract.cancelled
Plată	internal.payment.succeeded, internal.payment.failed
Rambursări	booking.contract.refund.partial, booking.contract.refund.full
Channel manager	channel-manager.update.rate, channel-manager.update.availability
Cont	account.create, account.status.updated

Pentru o listă completă a tuturor tipurilor de evenimente cu descrieri, vezi Catalogul Evenimentelor Webhook.

Vezi toate cele 64+ tipuri de evenimente

Sfat

Începe prin a te abona la toate evenimentele în timpul dezvoltării. Odată ce înțelegi payload-urile, restrânge la doar evenimentele de care sistemul tău are nevoie.

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

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, reactivează-l.

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

Lecturi suplimentare

• Catalogul Evenimentelor Webhook — Listă completă a tuturor celor 64+ tipuri de evenimente.
• Webhooks — Referință completă pentru gestionarea webhook-urilor.
• Applications — Gestionează-ți acreditările API.
• Developers > APIs — Documentație completă API.