Бронювання номерів: Servio HMS
~6 хв · Агент перевіряє вільні номери з цінами і бронює їх у Servio HMS під час дзвінка.
- Що отримаєте:
- агент називає вільні котеджі й номери з сумою за весь період, пропонує найближчі вільні дати і, якщо дозволите, сам створює бронювання та називає його номер.
- Що потрібно заздалегідь:
- готель у Servio HMS з модулем бронювання (Reservation API), права адміністратора проєкту у Voice Agent і кампанія «Голосовий агент».
1. Отримайте доступи в Servio
Попросіть у підтримки Servio або адміністратора готелю три значення:
- URL API бронювання — адреса модуля ReservationService, наприклад https://pms.example.com/ReservationService_1_14;
- токен доступу (AccessToken);
- ID готелю в Servio. Якщо готель працює з безготівковою оплатою або листом очікування, — ще й ID компанії.
2. Підключіть інтеграцію
- 1
- 2
- 3Натисніть «Зберегти».
- 4
Токен зберігається зашифрованим і після збереження не показується. Щоб замінити його, введіть новий; порожнє поле залишає збережений.
3. Налаштуйте, що пропонує агент
- 1
- 2«ID категорій номерів» — через кому, які категорії агент може пропонувати. Порожньо — усі.
- 3«Назви категорій для бота» — по одній у рядку, «ID: назва». Агент вимовлятиме ці назви замість назв із Servio, наприклад «11: котедж на двох».
- 4«ID прейскурантів» обмежує тарифи; «Приховати неповоротні тарифи» прибирає їх із пропозицій.
- 5«Дорослі від віку» — з якого віку гість бронюється як дорослий (типово 12). Молодші діти передаються в Servio з віком.
- 6«Додаткові місця» і «Враховувати туристичний збір» — як у вашому прейскуранті. Ціну рахує Servio, агент лише озвучує суму.
4. Увімкніть бронювання (за потреби)
Поки «Створювати бронювання» вимкнено, агент лише перевіряє наявність і ціни. Спершу проведіть тестові дзвінки в такому режимі.

| Поле | Що задає |
|---|---|
| Створювати бронювання | Агент створює бронювання в Servio, коли абонент погодив номер, дати, гостей і суму. Повторний такий самий запит не створює другого бронювання. |
| Тип бронювання | Звичайне — утримує номер. Лист очікування — номер не утримується, бронювання підтверджує менеджер. |
| Тип оплати, ID компанії, ID умови договору | Як у Servio. Для безготівкової оплати й листа очікування потрібен ID компанії. |
| ID додаткових умов договору | Умови договору через кому, тарифи яких агент теж пропонує: у готелю тариф без сніданків часто має власну умову. Бронювання оформлюється за умовою обраного тарифу. ID умов дасть адміністратор готелю або підтримка Servio. |
| Коментар до бронювання | Текст у бронюванні; підстановки {phone}, {name}, {date}. Вік дітей агент додає сам. |
| Посилання на оплату | Посилання на передоплату, яке агент отримує після звичайного бронювання. Номер бронювання підставляється замість {booking_id}. Агент може надіслати його SMS, якщо в кампанії є SMS-інструмент. |
| Дозволити скасування по телефону | Агент може скасувати бронювання, зроблене з номера абонента, після його підтвердження. Типово вимкнено. |
Бронювання створюються в робочій базі готелю. Тестові бронювання погоджуйте з готелем і передавайте їх номери, щоб їх анулювали.
5. Підключіть до кампанії
- 1
- 2Збережіть кампанію.
| Інструмент | Що робить |
|---|---|
| search_availability | Вільні категорії і сума за весь період на задані дати, кількість дорослих і вік дітей. |
| suggest_dates | Найближчі вільні дати, якщо на обрані місць немає. |
| create_booking | Створює бронювання; повертає його номер і посилання на оплату. |
| get_booking, send_confirmation | Статус бронювання абонента і лист-підтвердження гостю. |
| cancel_booking | Скасування — лише якщо дозволено в налаштуваннях. |
Додайте в інструкції агента правила готелю: що бронювати лише після явної згоди гостя і називати номер бронювання, які категорії кому пропонувати (наприклад, лише для гостей від 12 років), чи називати ціни окремих послуг.
Одне бронювання — один номер. Якщо для групи немає категорії, що вміщує всіх, агент не знайде варіанта: пропишіть в інструкціях, що такі запити передаються менеджеру.
6. Номер бронювання у вашій CRM
У шаблоні тіла вебхука кампанії підставте результат інструмента: {{tools.servio_create_booking.booking_id?}} — номер бронювання, {{tools.servio_create_booking.payment_link?}} — посилання на оплату. Знак ? означає, що поле буде порожнім (null), якщо бронювання в розмові не було. Детальніше — у гайді «Вебхуки: результати дзвінків».
Що далі
- Вебхуки: результати дзвінків — результати інструментів у шаблоні вебхука.
- Інструкції для агента — де прописати правила бронювання.
- Номери і тестовий дзвінок — перевірте сценарії до запуску.




