Guide to AI Booking Engine implementation

Instructions for Implementing the AI Booking Engine on your hotel's website.

To place the booking engine on your website, you will need the unique identifier of your property. You can find it in the Modules -> Booking Engine -> Link to Booking Engine tab. The code is a string of characters. Its exact location is shown in the image below:

The main link you can direct your Guest to can be found in the location described above. It always has the following structure:

https://be.guestsage.com/pl/{YOUR_HASH}

When you open this link in your browser, the engine will display offers proposed by artificial intelligence. Your virtual revenue manager will select the appropriate length of stay and display dates.

To direct the Guest to specific dates, offers, or rooms, you need to use additional parameters that are appended to the base URL.

Available parameters:

arrivalDate – arrival date (start of stay), provided in the format YYYY-MM-DD, e.g.: arrivalDate=2025-04-17

departureDate – departure date (end of stay), provided in the format YYYY-MM-DD, e.g.: departureDate=2025-04-19

personsCount – number of adults, e.g.: personsCount=2

ageCategoryCounts – number of children in specific age groups, e.g.: ageCategoryCounts=[{"ageCategoryId":70,"count":1}], where ageCategoryId is the ID of the age group and count is the number of people in that category.

featuredRatePlanId – specific rate plan to be displayed, e.g.: featuredRatePlanId=4635

featuredRoomTypeId – specific room to be displayed, e.g.: featuredRoomTypeId=8739

discountCodeName – discount code, e.g.: discountCodeName=KOD30

How to use this?

To add parameters to the link, follow this rule:

Add /offers? to the base link.

This indicates that you will be searching for specific offers. Then, enter the first parameter, e.g., arrival date of April 17, 2025:

https://be.guestsage.com/pl/{YOUR_HASH}/offers?arrivalDate=2025-04-17

To add the next parameter, separate it with the & sign. This applies to each subsequent parameter. Let's add two new parameters: departure date and number of people.

https://be.guestsage.com/pl/{YOUR_HASH}/offers?arrivalDate=2025-04-17&departureDate=2025-04-19&personsCount=3

As you can see, each parameter consists of its name and the value entered after the = sign. Each subsequent parameter is separated by the & sign.

Note! If you decide to use additional parameters, your link must contain at least the arrival date, departure date, and number of people.

Where to find the IDs of rooms, rate plans, or age groups?

Each room, rate plan, or age group you configure has its own unique ID number. You can see their locations in the images below:

1. Room ID

2. Rate Plan ID

Usage examples:

1. Link with specific dates and number of people:

https://be.guestsage.com/pl/{YOUR_HASH}/offers?arrivalDate=2025-04-17&departureDate=2025-04-19&personsCount=3

1. Link with specific dates, number of people, and a selected room:

https://be.guestsage.com/pl/{YOUR_HASH}/offers?arrivalDate=2025-04-17&departureDate=2025-04-19&personsCount=3&featuredRoomTypeId=8739

1. Link with specific dates, number of people, and rate plan:

https://be.guestsage.com/pl/{YOUR_HASH}/offers?arrivalDate=2025-04-17&departureDate=2025-04-19&personsCount=3&featuredRatePlanId=4635

1. Link with specific dates, number of people, room, and rate plan:

https://be.guestsage.com/pl/{YOUR_HASH}/offers?arrivalDate=2025-04-17&departureDate=2025-04-19&personsCount=3&featuredRoomTypeId=8739&featuredRatePlanId=4635

1. Link with children in different age groups:

https://be.guestsage.com/pl/{YOUR_HASH}/offers?arrivalDate=2025-04-17&departureDate=2025-04-19&personsCount=1&featuredRoomTypeId=8739&featuredRatePlanId=4635&ageCategoryCounts=[{"ageCategoryId":21,"count":1},{"ageCategoryId":1,"count":1}]

How to use this in practice?

You have two options to implement redirection to the AI Booking Engine on your website – depending on how much you want to be involved technically.

If you want to quickly launch a simple version, you can place a button on your website that will automatically redirect the user to the booking system with the arrival date set to today, departure date to tomorrow, and the number of people (e.g., 2 adults). Here’s a sample code you can paste into your website:

<button id="booking-btn">Book now</button>

<script>
  document.getElementById('booking-btn').addEventListener('click', function () {
    const today = new Date();
    const tomorrow = new Date();
    tomorrow.setDate(today.getDate() + 1);

    const formatDate = (date) => date.toISOString().split('T')[0];

    const hash = '{YOUR_HASH}'; // Replace with your unique hash
    const url = `https://be.guestsage.com/pl/${hash}/offers?arrivalDate=${formatDate(today)}&departureDate=${formatDate(tomorrow)}&personsCount=2`;

    window.location.href = url;
  });
</script>

If, however, you want a more advanced solution – such as a form where the user can select the arrival date, departure date, number of people, or children – such a script requires programming work and is best commissioned to your website administrator.

You don't have a dedicated IT specialist? No problem! We can prepare a ready-made, fully functional booking form and embed it on your website – for a fee. Contact us and we’ll take care of the rest.