Kravchenko.i: Створена сторінка: Webhook settings

2023-06-30T07:51:57Z

Створена сторінка: Webhook settings

Нова сторінка

‎<languages/>

== Webhook Setup Guide ==

A '''Webhook''' in web development is a method of increasing or extending the functionality of a web page or web application by using special callbacks. These callbacks can be served by a third-party system as part of the HMSServioAPI (ServioExternalService) integration.

In '''Servio HMS''', integration with '''Webhook''' has been implemented since version '''06.00.096'''. Currently, the functionality allows you to receive real-time information about the events of guests, questionnaires, companies, and rooms in JSON format with the display of events and an identifier. In case of such events for counterparties:
* '''Questionnaire''' - Addendum, Change, Removal (''unification of duplicates'');
* '''Guest''' - Addendum, Change, Removal (''cancellation'');
* '''Company''' - Addendum, Change, Removal (''cancellation'');
* '''Room''' - Change (''cleaning status'');
In the ''Servio HMS'' program, ''Webhook'' settings are possible for all hotels and each hotel separately. When configured for all hotels, transferring events for profiles, guests, companies, and rooms is possible. To configure for a specific hotel, it is possible to configure only the transmission of guest and room events.

In order to configure "Webhook" in the "Servio HMS" program, you need: 
1. Go to the '''"Settings/Other"''' page
2. Go to the tab '''"Quick response to events"''' 
[[File:Webhook screenshot 1.png|1200px|bordered]]

3. In the "Name" field, enter the name of the event or an identifier to understand the events 
4. In the "Service address" field, enter the "URL" of the service ("Contact the sysadmin") 
5. Select the required counterparty in the table and set the event flags required for display (''For example Guest - addition, change'') 
6. Click '''Add'''', after which the active Webhook will be displayed on the left side of the page '''"Directory of quick reactions"''' 
[[File:Webhook screenshot 2.png|1200px|bordered]]

Once the Webhook is configured, events will be sent to this address. Examples of Webhooks in JSON format by events and counterparties:

'''Questionnaire:'''
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}
'''Guest:'''
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]}}
'''Companies:'''
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
'''Rooms:'''
2023-06-30 09:30:01,923 INFO main - Jam_3: {"Add":null,'''"Update"''':{"Rooms":[160],"Clients":null,"Companies" :null,"Guests":null},"Delete":null}

Налаштування Webhook/en - Історія редагувань

Kravchenko.i: Створена сторінка: Webhook settings