BMPro AI / Plaza integracja rezerwacji głosowych

[jevkoo]

IBMPro AI / Plaza PMS - Instrukcja obsługi integracji rezerwacji głosowych

Integracja IBMPro AI z systemem Plaza PMS umożliwia automatyczne pobieranie rezerwacji utworzonych przez asystenta głosowego AI, przechowywanie ich w bazie Plaza oraz synchronizację dostępności pokoi.

System został przygotowany jako etap pośredni pomiędzy Voicebotem a standardowymi rezerwacjami Plaza. Wszystkie pobrane rezerwacje trafiają najpierw do tabeli REZERWACJAAI, skąd mogą zostać później przekształcone w standardowe rezerwacje Plaza.


1. Zakładka „Testy”



Zakładka służy do testowania komunikacji z API IBMPro oraz połączenia z bazą Firebird Plaza.

Dostępne funkcje:

• Pobierz nowe i zapisz – pobiera wszystkie nowe rezerwacje z IBMPro i zapisuje je do tabeli REZERWACJAAI.
• Oznacz jako pobrana – wysyła do IBMPro informację, że wskazana rezerwacja została pobrana przez Plaza.
• Zbuduj dostępność z Plaza – generuje JSON dostępności na podstawie procedury AVAIL_IN_DATE_RANGE.
• Wyślij dostępność – przesyła wygenerowaną dostępność do IBMPro.

W dolnym oknie wyświetlane są informacje diagnostyczne:

• ścieżka do pliku program.ini,
• serwer Firebird,
• port,
• ścieżka bazy danych,
• użytkownik,
• dialekt SQL,
• wykorzystywana biblioteka fbclient.dll.

Po uruchomieniu programu należy sprawdzić czy pojawi się komunikat:

Kod: Zaznacz cały

Połączono z Plaza Firebird i sprawdzono tabelę REZERWACJAAI.

Oznacza to poprawną konfigurację połączenia.


2. Synchronizacja dostępności

Integracja nie wysyła liczby wolnych pokoi w hotelu tylko pule dostępności.

Dostępność budowana jest na podstawie procedury:

Kod: Zaznacz cały

AVAIL_IN_DATE_RANGE
(
...
PROFILIMPORT_ID,
...
)

Dzięki temu agent AI otrzymuje wyłącznie liczbę pokoi udostępnionych dla konkretnego kanału sprzedaży.

Jeżeli dla danego dnia:

Kod: Zaznacz cały

ODOSTEPNOSC > 0

wysyłane jest:

Kod: Zaznacz cały

{"date":"2026-06-05","availability":"1"}

Jeżeli brak dostępności:

Kod: Zaznacz cały

{"date":"2026-06-05","availability":"0"}

Przykładowy wygenerowany JSON:

Kod: Zaznacz cały

[
{"date":"2026-05-31","availability":"1"}
]

3. Zakładka „Rezerwacje AI”



Zakładka prezentuje wszystkie rekordy zapisane w tabeli REZERWACJAAI.

Wyświetlane są między innymi:

• ID rekordu w Plaza,
• ID rezerwacji IBMPro,
• data przyjazdu,
• data wyjazdu,
• imię i nazwisko gościa,
• telefon,
• status,
• profil importu,
• powiązana rezerwacja Plaza,
• data pobrania,
• data zapisu.

Kolumna Rezerwacja będzie zawierała identyfikator REZERWACJA_ID po utworzeniu właściwej rezerwacji Plaza.

Aktualnie tabela pełni funkcję bufora pomiędzy IBMPro i Plaza PMS.


4. Szczegóły rezerwacji AI



Dwukrotne kliknięcie rezerwacji otwiera okno szczegółów.

Okno zawiera komplet informacji przekazanych przez Voicebota:

• ID rezerwacji IBMPro,
• daty pobytu,
• status,
• profil importu,
• imię,
• nazwisko,
• telefon,
• Conversation ID,
• Caller ID,
• notatkę,
• pełny JSON odebrany z API.

Najcenniejszą informacją jest sekcja:

Historia rozmowy

Przechowywany jest tam pełny zapis konwersacji pomiędzy gościem a sztuczną inteligencją.

Przykład:

Kod: Zaznacz cały

[agent] Dzień dobry...
[user] Chciałbym zarezerwować pokój...
[agent] Czy interesuje Pana...
[user] Zwykły pobyt...

Dzięki temu recepcjonista może szybko sprawdzić przebieg rozmowy i poznać oczekiwania klienta.

[hr]

5. Struktura bazy danych

Integracja wykorzystuje tabelę:

Kod: Zaznacz cały

REZERWACJAAI

Zgodnie ze standardami Plaza wszystkie własne pola posiadają prefiks:

Kod: Zaznacz cały

REZERWACJAAI_

Przykłady:

Kod: Zaznacz cały

REZERWACJAAI_ID
REZERWACJAAI_EXT_ID
REZERWACJAAI_DATA_OD
REZERWACJAAI_DATA_DO
REZERWACJAAI_IMIE
REZERWACJAAI_NAZWISKO
REZERWACJAAI_HISTORIA
REZERWACJAAI_JSON

Pola będące powiązaniami z innymi tabelami pozostają bez prefiksu:

Kod: Zaznacz cały

REZERWACJA_ID
PROFILIMPORT_ID
OSOBA_ID
FIRMA_ID
POKOJ_ID
POKOJTYP_ID

[hr]

6. Proces działania integracji

Krok 1

Program pobiera nowe rezerwacje z IBMPro.

↓

Krok 2

Rezerwacje zapisywane są do tabeli REZERWACJAAI.

↓

Krok 3

Operator analizuje szczegóły rezerwacji oraz historię rozmowy.

↓

Krok 4

Na podstawie danych tworzona jest właściwa rezerwacja Plaza.

↓

Krok 5

W polu REZERWACJA_ID zapisywany jest identyfikator utworzonej rezerwacji.

↓

Krok 6

System oznacza rezerwację jako pobraną po stronie IBMPro.

↓

Krok 7

Synchronizowana jest dostępność pokoi dla wskazanego PROFILIMPORT_ID.


7. Ważne informacje

• Nigdy nie oznaczaj rezerwacji jako pobranej przed zapisaniem jej w Plaza.
• Historia rozmowy może zawierać dodatkowe informacje niewidoczne w podstawowych polach rezerwacji.
• Dostępność wysyłana do IBMPro pochodzi z procedury AVAIL_IN_DATE_RANGE.
• Synchronizacja dostępności jest zależna od PROFILIMPORT_ID.
• REZERWACJAAI jest tabelą przejściową. W przyszłości dane będą przenoszone bezpośrednio do tabeli REZERWACJA.