> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Hostaway

नीचे दिए गए [वेबहुक टूल](/docs/hi/reception-ai/integrations/webhooks) से आपका रिसेप्शनिस्ट कॉलर की मांगी गई तारीखों के लिए Hostaway लिस्टिंग का कैलेंडर जांच सकता है और बता सकता है कि केबिन या यूनिट उपलब्ध है या नहीं, प्रति रात की कीमत क्या है और न्यूनतम ठहराव कितना है। Hostaway का सार्वजनिक API 24 महीने तक चलने वाला ऐक्सेस टोकन जारी करता है, इसलिए टूल सीधे Hostaway को कॉल करता है।

> **Note**
>
> आपका रिसेप्शनिस्ट रिज़र्वेशन नहीं बना सकता या मौजूदा रिज़र्वेशन नहीं देख सकता। यह कैलेंडर
> जांचता है और बुकिंग अनुरोध लेता है, फिर आपकी टीम [कॉल के बाद के सारांश](/docs/hi/reception-ai/features/notifications) से ठहराव की पुष्टि करती है।

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

### API कुंजी बनाएं

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

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

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

```bash
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 महीने तक मान्य है।

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

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

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

```bash
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                                                                                                                                                                                               |
| **URL**                   | `https://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` भी होता है।

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

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

ऐसी तारीखों के लिए केबिन पूछकर [अपने रिसेप्शनिस्ट का परीक्षण करें](/docs/hi/reception-ai/receptionist/testing) जिनके बारे में आपको पता है कि वे बुक हैं, फिर ऐसी तारीखों के लिए पूछें जिनके बारे में आपको पता है कि वे उपलब्ध हैं। जवाबों की तुलना अपने Hostaway कैलेंडर से करें।

> **Tip**
>
> ठहराव अनुरोधों के लिए एक [प्रोसीजर](/docs/hi/reception-ai/receptionist/rules-and-procedures) जोड़ें: रेंटल,
> आगमन और प्रस्थान की तारीखें और मेहमानों की संख्या पूछें, कैलेंडर जांचें, फिर अपनी टीम के लिए
> कॉलर का नाम, फ़ोन नंबर और ईमेल लें। एक नियम जोड़ें कि आपका रिसेप्शनिस्ट कभी भी ठहराव बुक होने का वादा न करे।

## सीमाएं

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

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

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