> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brosbots.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rezerwacja hotelowa z zaliczką (Przelewy24)

> Agent recepcji sprawdza wolne pokoje, wstępnie rezerwuje wybrany i wysyła SMS-em link do płatności Przelewy24. Po wpłacie rezerwacja potwierdza się sama.

## Co to robi

Agent z szablonu **Recepcja hotelowa z rezerwacją online** prowadzi rozmowę
w stałym porządku:

1. pyta o termin, liczbę osób i preferencje, a daty w rodzaju „od piątku do
   niedzieli" albo „na długi weekend" zamienia na konkretne dni i **powtarza
   je do potwierdzenia** („czyli od piątku 14 do niedzieli 16 listopada, dwie
   noce, zgadza się?"),
2. sprawdza dostępność w systemie rezerwacji obiektu i proponuje najwyżej trzy
   warianty z ceną za cały pobyt,
3. po wyborze wstępnie rezerwuje pokój, rejestruje transakcję w Przelewy24
   i wysyła SMS-em link do płatności (zaliczka procentowa albo całość),
4. gdy wpłata dojdzie, Przelewy24 powiadamia BrosBots, płatność jest
   weryfikowana i rezerwacja zostaje potwierdzona w systemie obiektu,
5. gdy wpłata nie dojdzie w ustalonym czasie, pokój wraca do sprzedaży.

Jeśli system rezerwacji nie odpowiada, agent mówi o tym wprost, zapisuje
numer i dogodną godzinę, a recepcja oddzwania (prośba trafia na listę
leadów).

> [!TIP]
>
> Bez konta Przelewy24: zostaw tryb demo i nie wybieraj połączenia płatności.
> Link z SMS-a otworzy wtedy testową stronę płatności BrosBots z przyciskiem
> „Zapłać (test)", a kliknięcie potwierdzi rezerwację tak jak prawdziwa wpłata.
> Nic nie jest pobierane. Tak sprawdzisz cały przebieg przed założeniem konta.

## Konfiguracja

1. **Integracje → Przelewy24**: Merchant ID, POS ID (puste, gdy równe
   Merchant ID), klucz API do raportów i klucz CRC z panelu Przelewy24.
   Środowisko **Sandbox** do testów, **Produkcja** do prawdziwych wpłat.
   **Testuj połączenie** sprawdza dane logowania; klucz CRC sprawdza się przy
   pierwszej płatności.
2. System rezerwacji obiektu: agent pracuje na **przykładowym obiekcie**
   (cztery typy pokoi, ceny sezonowe, część terminów celowo zajęta). Podpięcie
   systemu rezerwacji obiektu ustalamy indywidualnie.
3. Edytor agenta → **Integracje** → **Rezerwacje hotelowe z zaliczką**:
   połączenie Przelewy24, zaliczka
   w procentach albo pełna kwota, minuty na płatność, maksymalna liczba nocy,
   e-mail recepcji do potwierdzeń i zasady obiektu dla agenta.

> [!NOTE]
>
> SMS wychodzi z numeru agenta, więc agent musi mieć przypisany numer.
> Przelewy24 wymaga adresu e-mail przy każdej transakcji: agent pyta o niego
> rozmówcę, a gdy go nie ma, używa e-maila recepcji z ustawień.

## Co widać w panelu

Każda płatność ma wiersz z kwotą, statusem (`pending`, `paid`, `expired`,
`failed`), numerem rezerwacji i powiadomieniem z Przelewy24. Potwierdzenie
rezerwacji i jej zwolnienie są w **dzienniku dostaw** integracji przy
rozmowie. Czas każdego wywołania narzędzia i czas odpowiedzi agenta są w
zakładce **Diagnostyka** rozmowy.

## Bezpieczeństwo

* Powiadomienie z Przelewy24 jest przyjmowane tylko z adresów IP operatora,
  tylko z poprawnym podpisem SHA-384 i tylko gdy kwota i waluta zgadzają się
  z zarejestrowaną transakcją.
* Powtórzone powiadomienie nie potwierdza rezerwacji drugi raz.
* Klucze Przelewy24 są szyfrowane w bazie i nigdy nie trafiają do logów.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.