Difference between revisions of "Category:Webhooks"
(10 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:API]] | [[Category:API]] | ||
+ | [[Category:API_V2]] | ||
+ | [[Category:Developers]] | ||
<div class="heading">Webhooks</div> | <div class="heading">Webhooks</div> | ||
− | This page gives a a general overview over | + | This page gives a a general overview over webhooks. |
Webhooks are small messages sent from our server to yours, they can be used to trigger an action on your server in a timely manner, for example to retrieve a new booking via API. | Webhooks are small messages sent from our server to yours, they can be used to trigger an action on your server in a timely manner, for example to retrieve a new booking via API. | ||
− | = Booking Webhook = | + | = Version 1 Booking Webhook = |
+ | |||
+ | V1 booking webhooks use the GET method | ||
+ | |||
Triggered on a new or modification to an existing booking. | Triggered on a new or modification to an existing booking. | ||
+ | |||
+ | <span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span>Webhooks are asynchronous and there can be a small variable delay between a change and a webhook being sent (an average delay of one minute is to be expected). They are not an instant notification. | ||
Setup: {{#fas:cog}} (SETTINGS) PROPERTIES > ACCESS | Setup: {{#fas:cog}} (SETTINGS) PROPERTIES > ACCESS | ||
Line 21: | Line 28: | ||
Template variables can also be used in the URL | Template variables can also be used in the URL | ||
− | <code> <nowiki>https://yourdomain.com/page?property=[PROPERTYID] | + | <code> <nowiki>https://yourdomain.com/page?property=[PROPERTYID]</nowiki></code> |
+ | |||
+ | <span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}} </span>Ensure any information included in the URL by template variable is suitable for a URL, for example guest names may contain characters that are not allowed in URL's and may cause the webhook to fail. | ||
+ | |||
+ | == Version 2 Booking Webhook == | ||
+ | |||
+ | V2 booking webhooks use the POST method | ||
+ | |||
+ | Booking webhooks can contain the booking data as a JSON object in their body. | ||
+ | This can mean in many cases there is no need to make any additional API call after receiving the webhook. | ||
+ | |||
+ | Technical documentation can be found here https://api.beds24.com/v2/#/Webhooks/postWebhooks___bookings | ||
+ | |||
+ | This is currently a Beta function, please contact support if you wish to use it. | ||
= Auto Action Webhook = | = Auto Action Webhook = | ||
Line 32: | Line 52: | ||
Setup: {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > WEBHOOKS | Setup: {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > WEBHOOKS | ||
+ | |||
+ | More information can be found here [https://wiki.beds24.com/index.php/Inventory_Webhooks Inventory Webhooks] |
Latest revision as of 10:57, 29 October 2024
This page gives a a general overview over webhooks.
Webhooks are small messages sent from our server to yours, they can be used to trigger an action on your server in a timely manner, for example to retrieve a new booking via API.
Contents
1 Version 1 Booking Webhook
V1 booking webhooks use the GET method
Triggered on a new or modification to an existing booking.
Webhooks are asynchronous and there can be a small variable delay between a change and a webhook being sent (an average delay of one minute is to be expected). They are not an instant notification.
Setup: (SETTINGS) PROPERTIES > ACCESS
Webhook URL's are specified per property so you can transmit information to identify the property in the URL
https://yourdomain.com/page?property=1
https://yourdomain.com/page?property=2
https://yourdomain.com/page?property=3
Template variables can also be used in the URL
https://yourdomain.com/page?property=[PROPERTYID]
Ensure any information included in the URL by template variable is suitable for a URL, for example guest names may contain characters that are not allowed in URL's and may cause the webhook to fail.
1.1 Version 2 Booking Webhook
V2 booking webhooks use the POST method
Booking webhooks can contain the booking data as a JSON object in their body. This can mean in many cases there is no need to make any additional API call after receiving the webhook.
Technical documentation can be found here https://api.beds24.com/v2/#/Webhooks/postWebhooks___bookings
This is currently a Beta function, please contact support if you wish to use it.
2 Auto Action Webhook
Triggered when an auto action triggers.
Setup: (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS
3 Inventory Webhook
Triggered when room inventory or price changes.
Setup: (SETTINGS) APPS & INTEGRATIONS > WEBHOOKS
More information can be found here Inventory Webhooks
Pages in category "Webhooks"
The following 4 pages are in this category, out of 4 total. download this selection of articles as a PDF book