नेविगेशन पर जाएँ
इंटीग्रेशंससेटअप गाइड्सशेड्यूलिंग

Hostaway

कॉलर की तारीखों पर आपके रेंटल उपलब्ध हैं या नहीं, साथ में प्रति रात की कीमतें और न्यूनतम ठहराव जांचें।

नीचे दिए गए वेबहुक टूल से आपका रिसेप्शनिस्ट कॉलर की मांगी गई तारीखों के लिए Hostaway लिस्टिंग का कैलेंडर जांच सकता है और बता सकता है कि केबिन या यूनिट उपलब्ध है या नहीं, प्रति रात की कीमत क्या है और न्यूनतम ठहराव कितना है। Hostaway का सार्वजनिक API 24 महीने तक चलने वाला ऐक्सेस टोकन जारी करता है, इसलिए टूल सीधे Hostaway को कॉल करता है।

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

शुरू करने से पहले

1

API कुंजी बनाएं

Hostaway डैशबोर्ड में Settings → Hostaway API खोलें और नई API कुंजी बनाएं। इसका नाम Reception.ai रखें और पार्टनर के रूप में Hostaway Public API चुनें। कुंजी कॉपी कर लें: Hostaway इसे सिर्फ़ एक बार दिखाता है। अपना Account ID नोट कर लें, जो Settings में भी दिखता है।

2

ऐक्सेस टोकन पाएं

टर्मिनल में कुंजी को ऐक्सेस टोकन से बदलें और ACCOUNT_ID व API_KEY को बदलें:

curl -X POST 'https://api.hostaway.com/v1/accessTokens' \
  -H 'Content-type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials&client_id=ACCOUNT_ID&client_secret=API_KEY&scope=general'

रिस्पॉन्स से access_token वैल्यू कॉपी करें। यह 24 महीने तक मान्य है।

ऐक्सेस टोकन आपके Hostaway खाते में मौजूद हर चीज़ पढ़ और बदल सकता है, जिसमें अतिथि की जानकारी और दरवाज़े के कोड शामिल हैं। इसे शेयर किए गए दस्तावेज़ों या ऑनलाइन टूल्स में पेस्ट न करें। अगर यह लीक हो जाए, तो इसे रद्द करें और Hostaway में API कुंजी हटा दें।

3

अपनी लिस्टिंग IDs ढूंढें

टोकन से अपनी लिस्टिंग्स की सूची पाएं और YOUR_TOKEN को बदलें:

curl 'https://api.hostaway.com/v1/listings?limit=100' \
  -H 'Authorization: Bearer YOUR_TOKEN'

रिस्पॉन्स में हर लिस्टिंग का एक id और एक name होता है। हर उस लिस्टिंग की ID नोट करें जिसे आपके रिसेप्शनिस्ट को जांचना चाहिए।

टूल बनाएं

Integrations में जाएं, Add integration चुनें और Webhook Tool चुनें।

फ़ील्डवैल्यू
नामcheck_hostaway_calendar
विवरण”जांचें कि हमारा कोई रेंटल कॉलर की तारीखों पर उपलब्ध है या नहीं, और प्रति रात की कीमत व न्यूनतम ठहराव बताएं। कॉलर को रेंटल उपलब्ध होने की बात बताने से पहले इसका उपयोग करें।“
मेथडGET
URLhttps://api.hostaway.com/v1/listings/{listing_id}/calendar
रिक्वेस्ट हेडर्सAuthorization: Bearer के बाद आपका ऐक्सेस टोकन, और Type को Secret पर सेट करें
पाथ पैरामीटर्सlisting_id (string, आवश्यक): “Cedar Cabin के लिए 11111 और Lakeside Cabin के लिए 22222 का उपयोग करें।“
क्वेरी पैरामीटर्सstartDate (string, आवश्यक): “आगमन की तारीख, YYYY-MM-DD के रूप में।”
endDate (string, आवश्यक): “ठहराव की आखिरी रात, YYYY-MM-DD के रूप में।”
includeResources (string, निश्चित वैल्यू): 0
एजेंट्स को असाइन करेंReceptionist

केबिन के नाम और IDs को अपनी जानकारी से बदलें और हर लिस्टिंग के लिए एक लाइन जोड़ें। Enable चुनें।

Hostaway हर रात के लिए एक एंट्री देता है। status के available होने पर रात उपलब्ध होती है। हर रात में उसका price और minimumStay भी होता है।

includeResources को 0 पर निश्चित रखें। 1 के साथ Hostaway हर रात के रिज़र्वेशन, जिनमें अतिथि के नाम, फ़ोन नंबर और ईमेल शामिल हैं, आपके रिसेप्शनिस्ट को दिखाई देने वाली जानकारी में जोड़ देता है।

इसका परीक्षण करें

ऐसी तारीखों के लिए केबिन पूछकर अपने रिसेप्शनिस्ट का परीक्षण करें जिनके बारे में आपको पता है कि वे बुक हैं, फिर ऐसी तारीखों के लिए पूछें जिनके बारे में आपको पता है कि वे उपलब्ध हैं। जवाबों की तुलना अपने Hostaway कैलेंडर से करें।

ठहराव अनुरोधों के लिए एक प्रोसीजर जोड़ें: रेंटल, आगमन और प्रस्थान की तारीखें और मेहमानों की संख्या पूछें, कैलेंडर जांचें, फिर अपनी टीम के लिए कॉलर का नाम, फ़ोन नंबर और ईमेल लें। एक नियम जोड़ें कि आपका रिसेप्शनिस्ट कभी भी ठहराव बुक होने का वादा न करे।

सीमाएं

  • आपका रिसेप्शनिस्ट रिज़र्वेशन बना, बदल या रद्द नहीं कर सकता। आपकी टीम हर ठहराव की पुष्टि करती है।
  • यह एक बार में एक लिस्टिंग जांचता है। दूसरा केबिन सुझाने के लिए, यह हर एक को बारी-बारी से जांचता है।
  • प्रति रात की कीमतों में सफ़ाई शुल्क, टैक्स या डिस्काउंट शामिल नहीं होते, इसलिए आपके रिसेप्शनिस्ट को इन्हें सिर्फ़ एक अनुमान के रूप में बताना चाहिए।
  • टूल मौजूदा रिज़र्वेशन नहीं देखता। Hostaway के रिज़र्वेशन और लिस्टिंग रिकॉर्ड्स में दरवाज़े के कोड और Wi-Fi पासवर्ड शामिल होते हैं, इसलिए यह गाइड उन्हें आपके रिसेप्शनिस्ट के सामने नहीं रखती। Zapier का Hostaway ऐप वही रिकॉर्ड्स लौटाता है और इसमें बुकिंग या उपलब्धता ऐक्शंस नहीं हैं।
  • आपका ऐक्सेस टोकन 24 महीने बाद काम करना बंद कर देता है। उससे पहले नया बनाएं और हेडर अपडेट करें।

समस्या निवारण

समस्याक्या जांचें
Hostaway से 401 या 403हेडर वैल्यू में Bearer, एक स्पेस और ऐक्सेस टोकन होना चाहिए, API कुंजी नहीं। जांचें कि इसकी अवधि समाप्त तो नहीं हुई है।
गलत केबिन जांचा जाता हैजांचें कि listing_id विवरण में दी गई लिस्टिंग IDs आपकी लिस्टिंग्स से मेल खाती हैं।
बुक की गई रात उपलब्ध दिखती हैHostaway में कैलेंडर जांचें। ब्लॉक और रिज़र्व की गई रातों का status, available के अलावा कुछ और होता है।
रिसेप्शनिस्ट बहुत कम अवधि का ठहराव ऑफ़र करता हैटूल विवरण में इसे आगमन की रात का minimumStay जांचने के लिए कहें।