# Połącz Channex

Channex to channel manager używany przez wiele systemów PMS i gospodarzy. Portal gościa odczytuje Twoje rezerwacje z Channex i tworzy link do portalu dla każdego gościa.

## 1. Utwórz klucz API w Channex

1. Zaloguj się do Channex (`https://app.channex.io` lub Twój adres Channex w wersji white-label).
2. Otwórz swój profil użytkownika i przejdź do **API keys**.
3. Utwórz nowy klucz o nazwie *Guest portal* i skopiuj go.

## 2. Połącz w panelu

1. Otwórz **Settings → Channels → Channex** (Ustawienia → Kanały → Channex).
2. Wklej **API key**.
3. **Base URL**: pozostaw `https://app.channex.io`, chyba że testujesz na `https://staging.channex.io`. Akceptowane są tylko adresy Channex.
4. Zaznacz **Enabled**, kliknij **Save**, **Test**.

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

## 3. Powiąż swoje obiekty

**Show listings** wyświetla Twoje obiekty z Channex wraz z ich identyfikatorami (UUID). **Add selected as properties** (zdjęcia również są importowane — pierwsze staje się okładką; **Import photos** na karcie pobiera je dla obiektów powiązanych wcześniej) tworzy obiekt dla każdego zaznaczonego — z nazwą, adresem, miejscowością, krajem i strefą czasową z Channex — wiąże go i importuje jego rezerwacje. Dla obiektu, który utworzyłeś już ręcznie, odznacz go i zamiast tego wklej ID w **Settings → Properties → Settings → Channex property ID**.

## 4. Import

Kliknij **Import now**; następnie rezerwacje są importowane co 30 minut, łącznie ze zmianami i anulacjami.

### Natychmiastowe aktualizacje (webhook)

![Natychmiastowe aktualizacje na karcie kanału](/site/img/docs/d-channels-instant.webp "Natychmiastowe aktualizacje na karcie kanału")


1. W **Settings → Channels → Channex** kliknij **Set up instant updates**, a następnie **Register in Channex**. Portal gościa tworzy webhook rezerwacji na Twoim koncie Channex (jeden dla całego konta albo po jednym dla każdego powiązanego obiektu, jeśli Twój plan Channex pozwala tylko na webhooki obiektów).
2. Nowe, zmienione i anulowane rezerwacje docierają wtedy w ciągu kilku sekund; karta pokazuje ostatnie wywołanie. Regularny import nadal działa jako zabezpieczenie.

Adres jest tajny. **New address** zastępuje go i automatycznie aktualizuje webhook w Channex.

## 5. Potwierdzanie rewizji rezerwacji (opcjonalnie)

Channex oczekuje, że system zarządzający Twoimi rezerwacjami **potwierdzi** (acknowledge) każdą rewizję rezerwacji z jego feedu; niepotwierdzone rewizje są wysyłane ponownie, a Channex ostrzega Cię e-mailem. Zaznacz **Acknowledge booking revisions** na karcie Channex, jeśli portal gościa jest jedynym systemem odczytującym to konto Channex. Jeśli inny system (inny PMS lub codeb-demo) już je potwierdza, pozostaw tę opcję wyłączoną — portal gościa odczytuje wtedy rezerwacje bezpośrednio i nic nie zostaje utracone.

## 6. Wiadomości do gości

W przypadku rezerwacji z Booking.com, Airbnb i Expedia możesz pisać do gościa w czacie danego kanału: sekcja **Messages** w rezerwacji pokazuje rozmowę, **Send portal link via …** wysyła link do przewodnika pobytu, a **Settings → Email → Also send it through the booking channel's chat** robi to automatycznie przed przyjazdem.

- W Channex musi być zainstalowana aplikacja **Messages** (app.channex.io → Applications).
- Rezerwacje Expedia Partner Solutions / partnerskie (affiliate) nie obsługują wiadomości.
- Rezerwacje zaimportowane, zanim wiadomości były dostępne, zostaną powiązane przy następnym imporcie.

## Najczęściej zadawane pytania

### Czy portal gościa zmienia cokolwiek w Channex?

Nie. Połączenie odczytuje rezerwacje (oraz, jeśli to włączysz, potwierdza rewizje rezerwacji) i wysyła napisane przez Ciebie wiadomości do gości. Dostępność i ceny nadal zarządzasz w Channex.

### Korzystam z Channex przez mój PMS — czy mogę się połączyć?

Tak, o ile możesz utworzyć klucz API Channex z dostępem do obiektów. Jeśli masz tylko login white-label, zapytaj dostawcę swojego PMS.