Налаштування Webhook/ru: відмінності між версіями

Матеріал з SERVIO
Перейти до навігації Перейти до пошуку
(Створена сторінка: Настройка Webhook)
 
(Створена сторінка: '''Webhook''' в веб-разработке это метод увеличения или расширения функциональности вебстраницы или веб-приложения с помощью пользовательских обратных вызовов (callbacks). Эти обратные вызовы могут обслуживаться сторонней системой в интеграции HMSServioAPI (ServioExtern...)
 
(Не показано одну проміжну версію цього користувача)
Рядок 3: Рядок 3:
== Инструкция по настройке Webhook ==
== Инструкция по настройке Webhook ==


<div lang="uk" dir="ltr" class="mw-content-ltr">
'''Webhook''' в веб-разработке это метод увеличения или расширения функциональности вебстраницы или веб-приложения с помощью пользовательских обратных вызовов (callbacks). Эти обратные вызовы могут обслуживаться сторонней системой в интеграции HMSServioAPI (ServioExternalService).
'''Webhook''' у веброзробці це метод збільшення або розширення функціональності вебсторінки або вебзастосунку за допомогою користувацьких зворотних викликів (callbacks). Ці зворотні виклики можуть обслуговуватися сторонньою системою в межах інтеграції HMSServioAPI (ServioExternalService).
</div>


<div lang="uk" dir="ltr" class="mw-content-ltr">
В '''Servio HMS''' реализована интеграция с '''Webhook''' с версии '''06.00.096'''. На данный момент функциональность позволяет в режиме реального времени получать информацию о событиях гостей, анкет, компаний, номеров в формате JSON с отображением событий и идентификатором. На данный момент из таких событий для контрагентов:
В '''Servio HMS''' реалізована інтеграція з '''Webhook''' з версії '''06.00.096'''. На даний момент функціональність дозволяє в режимі реального часу отримувати інформацію про події гостей, анкет, компаній, номерів в форматі json з відображенням подій та  ідентифікатором. На разі з таких подій для контрагентів:
* '''Анкета''' - добавление, изменение, изъятие (''объединение дубликатов'');
* '''Анкета''' - додавання, зміна, вилучення (''об’єднання дублікатів'');
* '''Гость''' - добавление, изменение, изъятие (''аннулирование'');
* '''Гість''' - додавання, зміна, вилучення (''анулювання'');
* '''Компания''' - добавление, изменение, извлечение (''аннулирование'');
* '''Компанія''' - додавання, зміна, вилучення (''анулювання'');
* '''Номер''' - изменение статуса номера(''статус на уборку'');
* '''Номер''' - зміна статусу номеру(''статус на прибирання'');
В программе '''Servio HMS''' настройка '''Webhook''' возможна для всех отелей, а также для каждого отеля отдельно. В случае настройки для всех отелей возможна передача событий для анкет, гостей, компаний и номеров. Для настройки отеля можно настраивать только передачу гостей и номеров.
В програмі '''Servio HMS''' налаштування '''Webhook''' можливо для всіх готелів, а також до кожного готелю окремо. На разі налаштування для всіх готелей можливо передачу подій для анкет, гостей, компаній та номерів. Для налаштування для певного готелю можливо налаштовувати тільки передачу подій гостей та номерів.
</div>


<div lang="uk" dir="ltr" class="mw-content-ltr">
Для того чтобы настроить '''Webhook''' в программе '''Servio HMS''' необходимо: <br>
Для того, щоб налаштувати '''Webhook''' у програмі '''Servio HMS''' необхідно: <br>
1. Перейти на страницу '''"Настройки/Разное"'''<br>
1. Перейти на сторінку '''"Налаштування/Інше"'''<br>
2. Перейти на вкладку '''"Быстрая реакция на события"'''<br>
2. Перейти на вкладку '''"Швидка реакція на події"'''<br>
[[Файл:Webhook screenshot 1.png|1200px|bordered]]
[[Файл:Webhook screenshot 1.png|1200px|bordered]]
</div>


<div lang="uk" dir="ltr" class="mw-content-ltr">
3. В поле '''Название''', ввести название события или идентификатор для понимания событий<br>
3. В поле '''Назва''', ввести назву події чи ідентифікатор для розуміння подій<br>
4. В поле '''"Адрес сервиса"''' вводим ''url'' сервиса (''Обратиться к сисадмину'')<br>
4. В поле '''"Адреса сервісу"''' вводимо ''url'' сервісу (''Звернутися до сисадміну'')<br>
5. В таблице выбрать необходимого контрагента и поставить флаги событий, необходимых для отображения (''Например: Гость - добавление, изменение'')<br>
5. В таблиці обрати необхідного контрагента та поставити прапори подій котрі потрібні для відображення (''Наприклад: Гість - додавання, зміна'')<br>
6. Нажать '''Добавить''', после чего активный Webhook будет отображаться в левой стороне страницы '''Справочник быстрых реакций''''<br>
6. Натиснути '''Додати''', після чого активний Webhook буде відображатися в лівій стороні сторінки '''"Довідник швидких реакцій"'''<br>
[[Файл:Webhook screenshot 2.png|1200px|bodered]]
[[Файл:Webhook screenshot 2.png|1200px|bodered]]
</div>


<div lang="uk" dir="ltr" class="mw-content-ltr">
После того как Webhook настроен, события будут отправляться по указанным адресам . Примеры Webhook в формате json по событиям и контрагентам:
Після того як Webhook налаштовано, події будуть відправлятися на вказані адреси . Приклади Webhook у форматі json за подіями і контрагентами:
</div>


<div lang="uk" dir="ltr" class="mw-content-ltr">
'''Анкета:'''
'''Анкета:'''  
  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: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: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: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: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: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: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: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-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}
2023-06-30 09:30:01,923 INFO main - Jam_3: {"Add":null,'''"Update"''':{"Rooms":[160],"Clients":null,"Companies":null,"Guests":null},"Delete":null}
</div>

Поточна версія на 07:37, 30 червня 2023

Інші мови:

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

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

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

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

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

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

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

После того как 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}