Настройка Webhook

‎

Инструкция по настройке Webhook

Webhook в веб-разработке это метод увеличения или расширения функциональности вебстраницы или веб-приложения с помощью пользовательских обратных вызовов (callbacks). Эти обратные вызовы могут обслуживаться сторонней системой в интеграции HMSServioAPI (ServioExternalService).

В Servio HMS реализована интеграция с Webhook с версии 06.00.096. На данный момент функциональность позволяет в режиме реального времени получать информацию о событиях гостей, анкет, компаний, номеров в формате JSON с отображением событий и идентификатором. На данный момент из таких событий для контрагентов:

• Анкета - добавление, изменение, изъятие (объединение дубликатов);
• Гость - добавление, изменение, изъятие (аннулирование);
• Компания - добавление, изменение, извлечение (аннулирование);
• Номер - изменение статуса номера(статус на уборку);

В программе Servio HMS настройка Webhook возможна для всех отелей, а также для каждого отеля отдельно. В случае настройки для всех отелей возможна передача событий для анкет, гостей, компаний и номеров. Для настройки отеля можно настраивать только передачу гостей и номеров.

Для того чтобы настроить Webhook в программе Servio HMS необходимо:
1. Перейти на страницу "Настройки/Разное"
2. Перейти на вкладку "Быстрая реакция на события"

3. В поле Название, ввести название события или идентификатор для понимания событий
4. В поле "Адрес сервиса" вводим url сервиса (Обратиться к сисадмину)
5. В таблице выбрать необходимого контрагента и поставить флаги событий, необходимых для отображения (Например: Гость - добавление, изменение)
6. Нажать Добавить, после чего активный Webhook будет отображаться в левой стороне страницы Справочник быстрых реакций'

Після того як Webhook налаштовано, події будуть відправлятися на вказані адреси . Приклади Webhook у форматі json за подіями і контрагентами:

Анкета:

2023-06-29 16:38:18,149 INFO  main - Jam_1: {"Add":{"Clients":[12766],"Companies":null,"Guests":null},"Update":null,"Delete":null}
2023-06-29 16:38:23,727 INFO  main - Jam_1:{"Add":null,"Update":{"Rooms":null,"Clients":[12766],"Companies":null,"Guests":null},"Delete":null}
2023-06-29 16:39:14,928 INFO  main - Jam_1: {"Add":null,"Update":{"Rooms":null,"Clients":[1405],"Companies":null,"Guests":null},"Delete":{"Clients":[2414,3430,12691,12698,12726,12743,12766],"Companies":null,"Guests":null}

Гість:

2023-06-29 16:25:03,915 INFO  main - Jam_3: {"Add":{"Clients":null,"Companies":null,"Guests":[23061]},"Update":null,"Delete":null}
2023-06-29 16:25:06,086 INFO  main - Jam_5: {"Add":null,"Update":{"Rooms":null,"Clients":null,"Companies":null,"Guests":[23061]},"Delete":null}
2023-06-29 16:25:37,882 INFO  main - Jam_8: {"Add":null,"Update":null,"Delete":{"Clients":null,"Companies":null,"Guests":[23061]}}

Компанії:

2023-06-29 16:39:51,286 INFO  main - Jam_2: {"Add":{"Clients":null,"Companies":[1148],"Guests":null},"Update":null,"Delete":null}
2023-06-29 16:40:09,021 INFO  main - Jam_2: {"Add":null,"Update":{"Rooms":null,"Clients":null,"Companies":[1148],"Guests":null},"Delete":null

Кімнати:

2023-06-30 09:30:01,923 INFO  main - Jam_3: {"Add":null,"Update":{"Rooms":[160],"Clients":null,"Companies":null,"Guests":null},"Delete":null}