# Połącz Hostaway

Gdy Hostaway jest połączony, każda rezerwacja (z Airbnb, Booking.com, Vrbo, bezpośrednia …) jest automatycznie importowana do portalu gościa: daty, liczba gości, imię i nazwisko oraz dane kontaktowe gościa. Anulacje i zmiany dat są przenoszone na bieżąco. Twoje dane z zameldowania, płatności i notatki nigdy nie są nadpisywane przez import.

## 1. Utwórz klucz API Hostaway

1. Zaloguj się do panelu Hostaway.
2. Otwórz **Settings → Hostaway API**.
3. Kliknij **Create**, aby dodać nowy klucz API, nadaj mu nazwę (na przykład *Guest portal*) i zapisz.
4. Skopiuj **Account ID** i **API key** (Hostaway nazywa go client secret). Klucz jest wyświetlany tylko raz.

## 2. Połącz Hostaway w swoim panelu

1. Otwórz **Settings → Channels → Hostaway**.
2. Wklej **Account ID** i **API key (client secret)**.
3. Pozostaw **API base URL** puste — używany jest wtedy `https://api.hostaway.com/v1`. Wypełnij je tylko wtedy, gdy chcesz użyć punktu końcowego zgodnego z Hostaway (na przykład punktu końcowego CodeB); musi to być publiczny adres https.
4. Zaznacz **Enabled** i kliknij **Test** (najpierw zapisuje ustawienia). Powinien pojawić się komunikat *Hostaway: connected*.

![Settings → Channels](/site/img/docs/d-settings-channels.webp "Settings → Channels")

## 3. Połącz swoje obiekty

1. Kliknij **Show listings** na karcie Hostaway. Zobaczysz każdą ofertę z jej ID i informacją, czy jest już połączona.
2. **Dopiero zaczynasz z portalem gościa?** Pozostaw oferty zaznaczone i kliknij **Add selected as properties**. Każda oferta staje się obiektem z nazwą, adresem, miejscowością, krajem, strefą czasową i godzinami zameldowania / wymeldowania z Hostaway, zostaje połączona, a jej rezerwacje są od razu importowane.
3. **Masz już obiekt utworzony ręcznie?** Odznacz tę ofertę (odznacza się automatycznie, gdy istnieje obiekt o tej samej nazwie) i zamiast tego wklej ID oferty w **Settings → Properties → Settings → Hostaway listing ID**, aby nie powstała kopia.

![Show listings: zaznacz oferty do dodania — połączone oferty i obiekty o tej samej nazwie są rozpoznawane](/site/img/docs/d-channels-listings.webp "Show listings: zaznacz oferty do dodania — połączone oferty i obiekty o tej samej nazwie są rozpoznawane")

Karta pokazuje postęp, a panel odświeża się sam, gdy rezerwacje zostaną zaimportowane. Importowane są także **zdjęcia** ofert (do 12 na obiekt, przechowywane na własnym serwerze portalu gościa); pierwsze staje się zdjęciem głównym. Inne zdjęcie główne wybierzesz w **Guide editor → Property & welcome → Photos from Hostaway**. Dla obiektów połączonych wcześniej kliknij **Import photos** na karcie Hostaway — pobiera tylko brakujące zdjęcia, więc można bezpiecznie kliknąć ponownie (na przykład po restarcie serwera).

![Podczas importu rezerwacji karta pokazuje postęp i odświeża panel po ich zaimportowaniu](/site/img/docs/d-channels-progress.webp "Podczas importu rezerwacji karta pokazuje postęp i odświeża panel po ich zaimportowaniu")

Następnie uzupełnij każdy obiekt: Wi-Fi, kody do drzwi, licencja MTA, opłata turystyczna i płatności.

## 4. Import

Kliknij **Import now**, aby od razu pobrać rezerwacje. Później importy działają automatycznie co 30 minut dla pobytów od 30 dni wstecz do około 18 miesięcy naprzód.

### Natychmiastowe aktualizacje (webhook)

Zamiast czekać do 30 minut na kolejny import, Hostaway może w ciągu kilku sekund poinformować portal gościa o nowych i zmienionych rezerwacjach:

1. W **Settings → Channels → Hostaway** kliknij **Set up instant updates** i **Copy**, aby skopiować adres.
2. W panelu Hostaway otwórz **Settings → Integrations → Webhooks** (unified webhooks), dodaj webhook z tym adresem URL i zapisz. Pozostaw login i hasło puste — kluczem jest sam adres.
3. Karta pokazuje, kiedy Hostaway ostatnio wywołał adres i z jakim skutkiem. Regularny import nadal działa jako zabezpieczenie.

![Natychmiastowe aktualizacje: tajny adres webhooka i ostatnie wywołanie](/site/img/docs/d-channels-instant.webp "Natychmiastowe aktualizacje: tajny adres webhooka i ostatnie wywołanie")

Adres jest tajny: każdy, kto go ma, może poprosić portal gościa o ponowne sprawdzenie rezerwacji (sama rezerwacja jest zawsze pobierana z Hostaway z użyciem Twojego klucza API). **New address** zastępuje go, jeśli kiedykolwiek wycieknie — wtedy wklej nowy adres w Hostaway.

## 5. Zaproś gości

Zaimportowane rezerwacje od razu otrzymują własny link do portalu. Możesz go wysłać:

- e-mailem z poziomu rezerwacji (**Email portal link to guest**);
- **na czacie kanału** — **Send portal link via Airbnb** (lub Booking.com, Vrbo …) w rezerwacji. Wiadomość trafia przez Hostaway do skrzynki gościa na platformie, na której dokonał rezerwacji;
- automatycznie na kilka dni przed przyjazdem: **Settings → Email** — *Email the portal link to new guests automatically* i/lub *Also send it through the booking channel's chat*.

## 6. Wiadomości do gości

Sekcja **Messages** w rezerwacji pokazuje rozmowę z Hostaway (wiadomości gościa i Twoje) i pozwala odpowiadać na czacie kanału. Wiadomości są wysyłane dokładnie tak, jak zostały napisane — symbole zastępcze, takie jak `[guest_name]`, nie są uzupełniane, więc wiadomość, która nadal je zawiera, zostanie odrzucona. Szczegóły: [E-mail i powiadomienia](/docs/email-and-notifications).

## Najczęściej zadawane pytania

### Które dane pochodzą z Hostaway, a które zostają tutaj?

Zapytania, oczekujące i niepotwierdzone prośby (na przykład prośba o rezerwację w Vrbo), wygasłe lub odrzucone prośby oraz pobyty właściciela nie są importowane — tylko rzeczywiste pobyty. Hostaway zarządza datami, statusem, liczbą gości i danymi kontaktowymi z rezerwacji — z wyjątkiem liczby gości poprawionej przez Ciebie w rezerwacji (**Guests → Change**), którą kolejne importy zachowują. Dane z zameldowania online, płatności, status kaucji, kody do drzwi i Twoje notatki znajdują się w portalu gościa i nigdy nie są nadpisywane.

### Jak zaktualizować zdjęcia jednego obiektu?

**Settings → Properties → Settings → Photos → Refresh photos** pobiera nowe zdjęcia, usuwa te, których Hostaway już nie wyświetla, i nigdy nie pobiera tego samego zdjęcia dwa razy. **Refresh and use the first as cover** dodatkowo resetuje zdjęcie główne.

![Ustawienia obiektu: odśwież zdjęcia jednego obiektu](/site/img/docs/d-property-photos.webp "Ustawienia obiektu: odśwież zdjęcia jednego obiektu")

### Co się dzieje, gdy rezerwacja zostanie anulowana w Hostaway?

Przy następnym imporcie rezerwacja zostaje oznaczona jako anulowana; portal gościa pokazuje anulację, a daty się zwalniają.

### Niektórzy goście nie mają adresu e-mail?

Kanały często ukrywają prawdziwy e-mail. Zamiast tego wyślij link do portalu przez czat kanału — **Send portal link via …** w rezerwacji — albo włącz automatyczne zaproszenie na czacie w **Settings → Email**.