Перейти к основному содержимому

Отели: 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, internationalnational
room_to_roomoccupied_only, always, neveroccupied_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, пока лаборатория отеля не подтвердит заголовки подписи поставщика.