वेबहुक एकीकरण

वेबहुक आपके सिस्टम को रियल-टाइम सूचनाएं प्राप्त करने देते हैं जब आपकी Wink खाता पर घटनाएं होती हैं — नई बुकिंग, रद्दीकरण, भुगतान अपडेट, और भी बहुत कुछ। यह गाइड आपको सेटअप और सर्वोत्तम प्रथाओं के माध्यम से मार्गदर्शन करता है।

दर्शक

यह गाइड उन डेवलपर्स के लिए है जो Wink को बाहरी सिस्टम जैसे कि प्रॉपर्टी मैनेजमेंट सिस्टम (PMS), चैनल मैनेजर, CRM, या कस्टम डैशबोर्ड के साथ एकीकृत कर रहे हैं।

वेबहुक कैसे काम करते हैं

1. आप Wink पर एक वेबहुक URL पंजीकृत करते हैं।
2. जब कोई घटना होती है (जैसे, नई बुकिंग), Wink आपके URL पर HTTP POST भेजता है।
3. आपका सर्वर पेलोड को प्रोसेस करता है और 200 OK के साथ प्रतिक्रिया देता है।

वेबहुक सेटअप करना

1. अपने खाते में लॉग इन करें (Extranet, Studio, या TripPay — सभी वेबहुक का समर्थन करते हैं)।
2. Applications पर जाएं और फिर Webhooks पर जाएं। देखें Webhooks।
3. Create webhook पर क्लिक करें।
4. एक नाम दर्ज करें (जैसे, “PMS Booking Sync”)।
5. अपना वेबहुक URL दर्ज करें — आपके सर्वर पर HTTPS एंडपॉइंट।
6. इवेंट चुनें — सदस्यता के लिए विशिष्ट घटनाएं चुनें, या सभी घटनाएं प्राप्त करने के लिए खाली छोड़ दें।
7. Enabled को चालू करें।
8. Save पर क्लिक करें।

इवेंट प्रकार

Wink 64+ वेबहुक इवेंट प्रकार का समर्थन करता है जिनमें खाता प्रबंधन, बुकिंग कॉन्ट्रैक्ट, भुगतान, चैनल मैनेजर अपडेट, और प्रबंधन इकाई प्रशासन शामिल हैं। सामान्य घटनाओं में शामिल हैं:

श्रेणी	उदाहरण
बुकिंग	booking.create, booking.cancelled
बुकिंग कॉन्ट्रैक्ट	booking.contract.created, booking.contract.processing, booking.contract.cancelled
भुगतान	internal.payment.succeeded, internal.payment.failed
रिफंड	booking.contract.refund.partial, booking.contract.refund.full
चैनल मैनेजर	channel-manager.update.rate, channel-manager.update.availability
खाता	account.create, account.status.updated

हर इवेंट प्रकार के विवरण के साथ पूरी सूची के लिए, देखें Webhook Events Catalog।

सभी 64+ इवेंट प्रकार देखें

संकेत

डेवलपमेंट के दौरान सभी घटनाओं की सदस्यता लेकर शुरू करें। एक बार जब आप पेलोड समझ जाएं, तो केवल उन घटनाओं तक सीमित करें जिनकी आपके सिस्टम को आवश्यकता है।

सर्वोत्तम प्रथाएं

• HTTPS का उपयोग करें — Wink केवल HTTPS एंडपॉइंट्स को पेलोड भेजता है।
• त्वरित प्रतिक्रिया दें — पेलोड प्राप्त होते ही 200 OK लौटाएं। कोई भी भारी प्रोसेसिंग असिंक्रोनस रूप से करें।
• इडेम्पोटेंसी — आपका हैंडलर इडेम्पोटेंट होना चाहिए। यदि Wink को 200 प्रतिक्रिया नहीं मिलती है तो वह पुनः प्रयास कर सकता है।
• स्रोत सत्यापित करें — प्रोसेसिंग से पहले सुनिश्चित करें कि आने वाले अनुरोध Wink से हैं।
• लॉगिंग — हर वेबहुक पेलोड को लॉग करें जो आप प्राप्त करते हैं। इससे एकीकरण समस्याओं का डिबगिंग आसान हो जाता है।

रोकना और हटाना

आप एक वेबहुक को अक्षम कर सकते हैं बिना उसे हटाए। यह डिलीवरी को रोकता है ताकि आप बिना कॉन्फ़िगरेशन खोए समस्या निवारण कर सकें। जब आप तैयार हों, तो इसे फिर से चालू करें।

वेबहुक को हटाने से वह स्थायी रूप से हटा दिया जाता है। उस वेबहुक पर निर्भर कोई भी एकीकरण सूचनाएं प्राप्त करना बंद कर देगा।

आगे पढ़ें

• Webhook Events Catalog — सभी 64+ इवेंट प्रकारों की पूरी सूची।
• Webhooks — वेबहुक प्रबंधन के लिए पूर्ण संदर्भ।
• Applications — अपने API क्रेडेंशियल्स प्रबंधित करें।
• Developers > APIs — पूर्ण API दस्तावेज़।