Ringostat
Вхід

Бронювання номерів: 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. 1
    Ліве меню → «Інтеграції» → «Готові інтеграції» → вкладка «Бронювання» → картка «Servio HMS» → «Підключити».
    Картка Servio HMS
    Картка Servio HMS
  2. 2
    У блоці «Підключення» заповніть «URL API бронювання», «Токен доступу» та «ID готелю».
    Поля підключення
    Поля підключення
  3. 3
    Натисніть «Зберегти».
  4. 4
    Натисніть «Тест підключення». Якщо все правильно, з’явиться «Підключення працює».
    Тест підключення
    Тест підключення
Токен зберігається зашифрованим і після збереження не показується. Щоб замінити його, введіть новий; порожнє поле залишає збережений.

3. Налаштуйте, що пропонує агент

  1. 1
    У блоці «Що пропонує бот» натисніть «Показати категорії номерів готелю»: з’явиться список категорій з Servio з їхніми ID.
    Категорії номерів готелю
    Категорії номерів готелю
  2. 2
    «ID категорій номерів» — через кому, які категорії агент може пропонувати. Порожньо — усі.
  3. 3
    «Назви категорій для бота» — по одній у рядку, «ID: назва». Агент вимовлятиме ці назви замість назв із Servio, наприклад «11: котедж на двох».
  4. 4
    «ID прейскурантів» обмежує тарифи; «Приховати неповоротні тарифи» прибирає їх із пропозицій.
  5. 5
    «Дорослі від віку» — з якого віку гість бронюється як дорослий (типово 12). Молодші діти передаються в Servio з віком.
  6. 6
    «Додаткові місця» і «Враховувати туристичний збір» — як у вашому прейскуранті. Ціну рахує Servio, агент лише озвучує суму.

4. Увімкніть бронювання (за потреби)

Поки «Створювати бронювання» вимкнено, агент лише перевіряє наявність і ціни. Спершу проведіть тестові дзвінки в такому режимі.

Налаштування бронювання
Налаштування бронювання
Створювати бронюванняАгент створює бронювання в Servio, коли абонент погодив номер, дати, гостей і суму. Повторний такий самий запит не створює другого бронювання.
Тип бронюванняЗвичайне — утримує номер. Лист очікування — номер не утримується, бронювання підтверджує менеджер.
Тип оплати, ID компанії, ID умови договоруЯк у Servio. Для безготівкової оплати й листа очікування потрібен ID компанії.
ID додаткових умов договоруУмови договору через кому, тарифи яких агент теж пропонує: у готелю тариф без сніданків часто має власну умову. Бронювання оформлюється за умовою обраного тарифу. ID умов дасть адміністратор готелю або підтримка Servio.
Коментар до бронюванняТекст у бронюванні; підстановки {phone}, {name}, {date}. Вік дітей агент додає сам.
Посилання на оплатуПосилання на передоплату, яке агент отримує після звичайного бронювання. Номер бронювання підставляється замість {booking_id}. Агент може надіслати його SMS, якщо в кампанії є SMS-інструмент.
Дозволити скасування по телефонуАгент може скасувати бронювання, зроблене з номера абонента, після його підтвердження. Типово вимкнено.
Бронювання створюються в робочій базі готелю. Тестові бронювання погоджуйте з готелем і передавайте їх номери, щоб їх анулювали.

5. Підключіть до кампанії

  1. 1
    Редактор кампанії → картка «Інструменти AI» → оберіть Servio HMS: усі інструменти або лише позначені.
    Інструменти AI
    Інструменти AI
  2. 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), якщо бронювання в розмові не було. Детальніше — у гайді «Вебхуки: результати дзвінків».

Що далі