Przejdź do nawigacji
IntegracjePrzewodniki konfiguracjiPlanowanie

Hostaway

Sprawdzaj dostępność wynajmów w terminach rozmówcy, wraz z ceną za noc i minimalną długością pobytu.

Za pomocą poniższego narzędzia webhook 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.

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.

Zanim zaczniesz

1

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.

2

Pobierz token dostępu

W terminalu wymień klucz na token dostępu, zastępując ACCOUNT_ID i 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'

Skopiuj wartość access_token z odpowiedzi. Jest ważna przez 24 miesiące.

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.

3

Znajdź identyfikatory ofert

Wyświetl listę ofert za pomocą tokenu, zastępując YOUR_TOKEN:

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.

PoleWartość
Nazwacheck_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.”
MetodaGET
URLhttps://api.hostaway.com/v1/listings/{listing_id}/calendar
Nagłówki żądaniaAuthorization: Bearer , a następnie token dostępu, z ustawieniem Type na Secret
Parametry ścieżkilisting_id (ciąg znaków, wymagany): “Użyj 11111 dla domku Cedar Cabin i 22222 dla domku Lakeside Cabin.”
Parametry zapytaniastartDate (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ówReceptionist

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.

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ę, 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.

Dodaj procedurę 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

ProblemCo sprawdzić
401 lub 403 z HostawayWartość nagłówka musi zawierać Bearer, spację i token dostępu, a nie klucz API. Sprawdź, czy nie wygasł.
Sprawdzany jest niewłaściwy domekSprawdź, czy identyfikatory ofert w opisie listing_id pasują do twoich ofert.
Zajęta noc jest pokazywana jako wolnaSprawdź kalendarz w Hostaway. Zablokowane i zarezerwowane noce mają status inny niż available.
Recepcjonista proponuje zbyt krótki pobytW opisie narzędzia poleć mu sprawdzać minimumStay dla nocy przyjazdu.