Poradnik: Samodzielna implementacja AI Booking Engine

Instrukcja implementacji AI Booking Engine na własnej stronie internetowej

Aby umieścić silnik rezerwacyjny na stronie, potrzebny nam będzie unikalny identyfikator naszego obiektu. Znajdziemy go w zakładce Moduły -> Silnik rezerwacyjny -> Link do Booking Engine. Kod ma postać ciągu znaków. Jego dokładne umiejscowienie przedstawione jest na zdjęciu poniżej:

2.png

Podstawowy link, na który możesz skierować swojego Gościa, odnajdziemy właśnie we wskazanym wcześniej miejscu. Ma on zawsze postać:

https://be.guestsage.com/pl/{TWÓJ_HASH}

Gdy uruchomimy ten link w przeglądarce, wyświetli nam się silnik z ofertami zaproponowanymi przez sztuczną inteligencję. Twój wirtualny revenue manager dobierze odpowiednią długość pobytu oraz daty do wyświetlenia.

2.png

Aby skierować Gościa na konkretne daty, oferty czy pokoje, musimy skorzystać z dodatkowych parametrów, które dodawane są do podstawowego adresu URL.

Dostępne parametry:

arrivalDate– data przyjazdu (początek rezerwacji), wprowadzamy w formacie YYYY-MM-DD np.:arrivalDate=2025-04-17

departureDate – data wyjazdu (koniec rezerwacji), wprowadzamy w formacie YYYY-MM-DD np.: departureDate=2025-04-19

personsCount – liczba osób dorosłych, np.: personsCount=2

ageCategoryCounts – liczba dzieci w konkretnych grupach wiekowych, np.: ageCategoryCounts=[{"ageCategoryId":70,"count":1}], gdzie ageCategoryId to ID grupy wiekowej, a count to liczba osób w danej kategorii.

featuredRatePlanId – konkretny plan cenowy, który ma się wyświetlić, np.: featuredRatePlanId=4635

featuredRoomTypeId – konkretny pokój, który ma się wyświetlić, np.: featuredRoomTypeId=8739

discountCodeName – kod rabatowy, np.: discountCodeName=KOD30

Jak tego użyć?

Aby dodać parametry do linku, posiłkujemy się następującą zasadą:

Do podstawowego linku dodajemy: /offers?

Jest to oznaczenie, że będziemy wyszukiwać konkretne oferty. Następnie wprowadzamy pierwszy parametr np. data przyjazdu dnia 17.04.2025:

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

Aby wprowadzić następny parametr, musimy oddzielić go znakiem &. Tak samo będzie to wyglądało z każdym kolejnym parametrem. Dodajmy więc dwa nowe parametry - datę wyjazdu oraz liczbę osób.

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

Jak widzisz, każdy parametr składa się z jego nazwy oraz wartości wprowadzonej po znaku =. Każdy kolejny parametr oddzielony jest znakiem &

Uwaga! Jeżeli postanowisz wykorzystać dodatkowe parametry, Twój link musi zawierać co najmniej datę przyjazdu, datę wyjazdu oraz liczbę osób.

Gdzie znaleźć ID pokoi, planów cenowych czy grup wiekowych.

Każdy skonfigurowany przez nas pokój, plan cenowy czy grupowa wiekowa posiada swój własny unikalny numer ID. Ich umiejscowienie możesz zobaczyć na zdjęciach poniżej:

1. ID pokoju

2.png

2. ID planu cenowego

pexels-olly-3771087.jpg

Przykłady wykorzystania:

1. Link z konkretnymi datami i liczbą osób:

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

1. Link z konkretnymi datami, liczbą osób i wybranym pokojem:

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

1. Link z konkretnymi datami, liczbą osób i planem cenowym:

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

1. Link z konkretnymi datami, liczbą osób, pokojem i planem cenowym:

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

1. Link z dziećmi w różnych grupach wiekowych:

https://be.guestsage.com/pl/{TWÓJ_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}]

Jak wykorzystać to w praktyce?

Maszz dwie możliwości wdrożenia przekierowania do AI Booking Engine na swojej stronie internetowej – zależnie od tego, jak bardzo chcesz się w to zaangażować technicznie.

Jeśli chcesz szybko uruchomić prostą wersję, możesz umieścić na stronie przycisk, który automatycznie przekieruje użytkownika do systemu rezerwacji z ustawioną datą przyjazdu na dziś, wyjazdu na jutro oraz liczbą osób (np. 2 dorosłych). Oto przykładowy kod, który możesz wkleić na swoją stronę:

<button id="booking-btn">Zarezerwuj teraz</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 = '{TWÓJ_HASH}'; // Podmień na swój unikalny hash
    const url = `https://be.guestsage.com/pl/${hash}/offers?arrivalDate=${formatDate(today)}&departureDate=${formatDate(tomorrow)}&personsCount=2`;

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

Jeśli jednak zależy Ci na bardziej rozbudowanym rozwiązaniu – na przykład formularzu, w którym użytkownik sam wybiera datę przyjazdu, wyjazdu, liczbę osób lub dzieci – taki skrypt wymaga już pracy programistycznej i najlepiej zlecić go administratorowi Twojej strony.

Nie masz swojego specjalisty od stron www? Żaden problem! Możemy przygotować gotowy, w pełni funkcjonalny formularz rezerwacyjny i osadzić go na Twojej stronie – odpłatnie. Skontaktuj się z nami, a my zajmiemy się resztą.