Setting/propertiesnotifyurl: Difference between revisions

Jump to navigation Jump to search
← Older edit
No edit summary
No edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
A push notification (webhook) will be sent to this URL when a new booking, significant booking modification which effects availability, a guest message from OTA or cancellation occurs.
A push notification (webhook) will be sent to this URL when a new booking, significant booking modification which effects availability, a guest message from OTA or cancellation occurs.
Multiple URL's can be notified, enter each additional URL on a new line.
Your server should return an HTTP 200 header to acknowledge receipt of the notify.
If there is no response or a response HTTP code of 400 or higher the notify will be retried after a delay.
Outgoing messages are queued so there can be a short delay between the action occurring and the notification sending.
VERSION 2 webhooks will include a JSON object with the booking data in the format specified in API V2.
The following apples to VERSION 1 webhooks only:


The bookid and status are appended to your url like this example.
The bookid and status are appended to your url like this example.


https://yoururl.com/yourpage?bookid=12345678&status=new
<code>https://yoururl.com/yourpage?bookid=12345678&status=new</code>


Possible values for status are: new, modify, cancel, message
Possible values for status are: new, modify, cancel, message
Line 11: Line 23:
The card CVV and a token to retrieve it from the JSON getCard API function can be included as form url encoded POST data in the body of the push.
The card CVV and a token to retrieve it from the JSON getCard API function can be included as form url encoded POST data in the body of the push.


The URL can contain template variables which will be exchanged with information from the booking.
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span>  If you need to differentiate between multiple properties, an easy way is to include a property parameter in your URL


Multiple URL's can be notified, enter each additional URL on a new line.
<code>https://myserver.com/propid=1234 </code>


Your server should return an HTTP 200 header to acknowledge receipt of the notify.
The URL can contain template variables which will be exchanged with information from the booking.
 
If there is no response or a response HTTP code of 400 or higher the notify will be retried after a delay.
 
Outgoing messages are queued so there can be a short delay between the action occurring and the notification sending.


The status values are not synchronous, it is possible the first notification will have status modified or cancel instead of new if the booking has changed to that state before the message sends.
The status values are not synchronous, it is possible the first notification will have status modified or cancel instead of new if the booking has changed to that state before the message sends.
Retrieved from "https://wiki.beds24.com/index.php/Setting/propertiesnotifyurl"