> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Hostaway Za pomocą poniższego [narzędzia webhook](/docs/pl/reception-ai/integrations/webhooks) twój recepcjonista może sprawdzić kalendarz oferty Hostaway na terminy wskazane przez rozmówcę oraz podać, czy domek lub lokal jest dostępny, cenę za noc i minimalną długość pobytu. Publiczne API Hostaway wydaje token dostępu ważny przez 24 miesiące, więc narzędzie łączy się bezpośrednio z Hostaway. > **Note** > > Twój recepcjonista nie może tworzyć rezerwacji ani wyszukiwać istniejących. Sprawdza kalendarz > i przyjmuje prośbę o rezerwację, a twój zespół potwierdza pobyt na podstawie [podsumowania po rozmowie](/docs/pl/reception-ai/features/notifications). ## Zanim zaczniesz ### Utwórz klucz API W panelu Hostaway otwórz **Settings** → **Hostaway API** i utwórz nowy klucz API. Nazwij go `Reception.ai` i wybierz **Hostaway Public API** jako partnera. Skopiuj klucz: Hostaway wyświetla go tylko raz. Zanotuj też **Account ID**, widoczne również w **Settings**. ### Pobierz token dostępu W terminalu wymień klucz na token dostępu, zastępując `ACCOUNT_ID` i `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' ``` Skopiuj wartość `access_token` z odpowiedzi. Jest ważna przez 24 miesiące. > **Warning** > > Token dostępu może odczytywać i zmieniać wszystko na twoim koncie Hostaway, w tym dane gości > i kody do drzwi. Nie wklejaj go do współdzielonych dokumentów ani narzędzi online. Jeśli wycieknie, > unieważnij go i usuń klucz API w Hostaway. ### Znajdź identyfikatory ofert Wyświetl listę ofert za pomocą tokenu, zastępując `YOUR_TOKEN`: ```bash curl 'https://api.hostaway.com/v1/listings?limit=100' \ -H 'Authorization: Bearer YOUR_TOKEN' ``` Każda oferta w odpowiedzi ma `id` i `name`. Zanotuj identyfikator każdej oferty, którą powinien sprawdzać recepcjonista. ## Utwórz narzędzie Przejdź do **Integrations**, wybierz **Add integration**, a następnie **Webhook Tool**. | Pole | Wartość | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nazwa** | `check_hostaway_calendar` | | **Opis** | "Sprawdź, czy jeden z naszych wynajmów jest dostępny w terminach rozmówcy, oraz cenę za noc i minimalną długość pobytu. Użyj tego, zanim powiesz rozmówcy, że wynajem jest dostępny." | | **Metoda** | GET | | **URL** | `https://api.hostaway.com/v1/listings/{listing_id}/calendar` | | **Nagłówki żądania** | `Authorization`: `Bearer `, a następnie token dostępu, z ustawieniem **Type** na **Secret** | | **Parametry ścieżki** | `listing_id` (ciąg znaków, wymagany): "Użyj `11111` dla domku Cedar Cabin i `22222` dla domku Lakeside Cabin." | | **Parametry zapytania** | `startDate` (ciąg znaków, wymagany): "Data przyjazdu w formacie RRRR-MM-DD." `endDate` (ciąg znaków, wymagany): "Ostatnia noc pobytu w formacie RRRR-MM-DD." `includeResources` (ciąg znaków, stała wartość): `0` | | **Przypisz do agentów** | **Receptionist** | Zastąp nazwy domków i identyfikatory własnymi, a następnie dodaj po jednym wierszu na ofertę. Wybierz **Enable**. Hostaway zwraca jeden wpis na noc. Noc jest dostępna, gdy `status` ma wartość `available`. Każda noc ma też wartości `price` i `minimumStay`. > **Warning** > > Ustaw stałą wartość `0` dla `includeResources`. Przy wartości `1` Hostaway dodaje rezerwacje dla każdej nocy, > w tym imiona gości, numery telefonów i adresy e-mail, do danych widocznych dla recepcjonisty. ### Przetestuj [Przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing), pytając o domek w terminach, o których wiesz, że są zajęte, a potem w terminach, o których wiesz, że są wolne. Porównaj odpowiedzi z kalendarzem Hostaway. > **Tip** > > Dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures) dla próśb o pobyt: zapytaj o > wynajem, daty przyjazdu i wyjazdu oraz liczbę gości, sprawdź kalendarz, a następnie pobierz od > rozmówcy imię, numer telefonu i adres e-mail dla swojego zespołu. Dodaj zasadę, że recepcjonista nigdy > nie obiecuje, że pobyt został zarezerwowany. ## Ograniczenia * Recepcjonista nie może tworzyć, zmieniać ani anulować rezerwacji. Każdy pobyt potwierdza twój zespół. * Sprawdza jedną ofertę naraz. Aby zaproponować inny domek, sprawdza je kolejno. * Ceny za noc nie obejmują opłat za sprzątanie, podatków ani zniżek, więc recepcjonista powinien podawać je tylko orientacyjnie. * Narzędzie nie wyszukuje istniejących rezerwacji. Rekordy rezerwacji i ofert Hostaway zawierają kody do drzwi oraz hasła Wi-Fi, dlatego ten przewodnik nie udostępnia ich recepcjoniście. Aplikacja Hostaway w Zapier zwraca te same rekordy i nie ma akcji rezerwacji ani sprawdzania dostępności. * Token dostępu przestaje działać po 24 miesiącach. Utwórz nowy i wcześniej zaktualizuj nagłówek. ## Rozwiązywanie problemów | Problem | Co sprawdzić | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | 401 lub 403 z Hostaway | Wartość nagłówka musi zawierać `Bearer`, spację i token dostępu, a nie klucz API. Sprawdź, czy nie wygasł. | | Sprawdzany jest niewłaściwy domek | Sprawdź, czy identyfikatory ofert w opisie `listing_id` pasują do twoich ofert. | | Zajęta noc jest pokazywana jako wolna | Sprawdź kalendarz w Hostaway. Zablokowane i zarezerwowane noce mają `status` inny niż `available`. | | Recepcjonista proponuje zbyt krótki pobyt | W opisie narzędzia poleć mu sprawdzać `minimumStay` dla nocy przyjazdu. |