Отели: Cloudbeds и Opera Cloud
Система управления отелем (PMS) сообщает телефонной системе, кто в каком номере живёт. Заселение открывает внутренний номер комнаты, выезд закрывает его и стирает следы предыдущего гостя, звонки-будильники приходят из PMS, а номера могут звонить друг другу по правилам.
Коннекторы
Установите их в разделе Консоль, Админ, Интеграции (cloudbeds, opera, категория hospitality). Учётные данные запечатываются ключом компании и больше не показываются. Создайте точку входящих хуков для коннектора (см. Исходящие вебхуки) и передайте её адрес в PMS.
| Настройка | Значение | По умолчанию |
|---|---|---|
timezone | зона IANA отеля; время каждого будильника местное для неё | UTC |
room_prefix | цифры перед номером комнаты, чтобы получить внутренний номер (комната 201, префикс 1: номер 1201) | нет |
front_desk | внутренний номер, куда всегда можно позвонить из любой комнаты | 0 |
checkin_cos | класс обслуживания на время проживания: internal, local, national, international | national |
room_to_room | occupied_only, always, never | occupied_only |
wakeup_attempts | число звонков на один будильник до оповещения стойки регистрации (1–6) | 3 |
wakeup_retry_minutes | минут между звонками (1–30) | 5 |
Cloudbeds: property_id и API-ключ. Вебхуки: reservation/status_changed (checked_in, checked_out; комнаты берутся из getReservation), reservation/notes_created, housekeeping/room_condition_changed. В Cloudbeds нет объекта будильника, поэтому стойка регистрации пишет WAKEUP 06:30 (или WAKEUP CANCEL) в заметках брони; событие заметок ставит или отменяет будильник для каждой назначенной комнаты.
Opera Cloud (OHIP): адрес шлюза, client id и secret, пользователь и пароль интеграции, ключ приложения, enterprise id и код отеля. Бизнес-события: CHECKED_IN, CHECKED_OUT, ROOM_MOVE, ROOM_STATUS_CHANGED, WAKE_UP_CALL_CREATED, _UPDATED, _CANCELLED. Событие для другого кода отеля отклоняется.
Оба коннектора дают ИИ-агенту один инструмент, room_status (занят или свободен, состояние уборки).
Что происходит
| Событие PMS | Телефонная система |
|---|---|
| заселение | внутренний номер комнаты получает checkin_cos; язык гостя определяет подсказки и сообщение будильника |
| выезд | номер возвращается в restricted (только стойка регистрации и экстренные номера); голосовая почта, переадресация и «Не беспокоить» сбрасываются; ожидающие будильники отменяются |
| переселение | старая комната закрывается и сбрасывается, новая открывается, будильники и язык следуют за гостем |
| вне эксплуатации | комната ограничена |
| уборка | только записывается |
| будильник: установка / отмена | ставится в зоне отеля; одна и та же минута дважды — один будильник; не более 3 ожидающих на комнату; не более чем на 30 дней вперёд; для свободной комнаты отклоняется |
Будильник звонит в свою минуту, затем каждые wakeup_retry_minutes, пока не ответят или не кончатся попытки, после чего оповещается стойка регистрации.
Правила набора
Любая комната всегда может позвонить на стойку регистрации и на экстренные номера (911, 112, 065, 066, 999). Свободная комната или комната вне эксплуатации больше никуда звонить не может. Между комнатами действует room_to_room. Для остальных номеров нужен класс: до 4 цифр — внутренний, 7–9 цифр — местный, 10 и больше — междугородний, + или 00 — международный. Номера сотрудников не являются комнатами и этими правилами не ограничиваются.
Шаблонный сценарий
pbx/crates/flows/templates/hotel-front-desk.json: гости (звонящие из комнаты) получают меню со стойкой регистрации, уборкой, заказом будильника и обслуживанием в номере; внешние звонящие получают стойку регистрации, бронирование и справочник гостей. Любой тайм-аут, неверная клавиша и сбой заканчиваются на стойке регистрации, затем на её голосовой почте. Ветка будильника собирает четыре цифры (0630) и отправляет их вместе с внутренним номером звонящего в POST /api/v1/hotel/wakeups/by-extension (узлу HTTP нужна возможность http; замените пример адреса адресом вашей АТС, сохраните API-ключ с hotel:write как секрет сценария hotel_api_key и запишите подсказки).
Стойка
PMS питает стойку отеля компании (Стойка регистрации отеля): комнаты и будильники хранятся в базе, список комнат загружается из PMS один раз при запуске стойки, а стойка регистрации может также заселять и выселять гостей, переселять и ставить будильники из консоли. Точки хуков используют схему shared_secret для обеих PMS, пока лаборатория отеля не подтвердит заголовки подписи поставщика.