Integráció az IdoBooking rendszerrel

Kapcsolja össze ChatLab chatbotját az IdoBooking foglalási rendszerével, hogy valós idejű elérhetőségi információkat és foglalási támogatást nyújtson a weboldala látogatóinak.

Mit nyújt az integráció?

Az IdoBooking integráció bekapcsolásával a chatbot az alábbiakra képes:

• Elérhető apartmanok és szállások listázása leírásokkal és fotókkal
• Elérhetőség ellenőrzése konkrét dátumokra
• Elérhető apartmanok keresése adott dátumtartományra árakkal együtt
• Meglévő foglalások lekérése azonosító, státusz vagy dátumtartomány alapján
• Új foglalások létrehozása a vendégek adataival

Az integráció beállítására kétféle mód van - az IdoBooking Marketplace felületén keresztül (ajánlott), vagy manuálisan a ChatLab adminisztrációs felületén.

---

A lehetőség: Beállítás az IdoBooking Marketplace segítségével (ajánlott)

A ChatLab és az IdoBooking összekapcsolásának leggyorsabb módja az IdoBooking Marketplace használata. Ez a módszer automatikusan kezeli az API-hitelesítő adatokat, és bekapcsolja a chatbot összes AI-műveletét.

1. lépés: Telepítse a ChatLabot az IdoBooking Marketplace-ről

1. Jelentkezzen be az IdoBooking adminisztrációs felületére
2. Nyissa meg a Marketplace szakaszt
3. Keresse meg a ChatLab alkalmazást, majd kattintson az Install (Telepítés) gombra

Az IdoBooking automatikusan elküldi az API-hitelesítési adatokat a ChatLabnak - nem szükséges külön API-felhasználót létrehozni vagy az adatokat manuálisan másolni.

2. lépés: Hozzon létre vagy nyisson meg egy ChatLab-fiókot

Miután aktiválta a ChatLabot a piactéren, a rendszer átirányítja egy lépésről lépésre vezető beállítási varázslóhoz. Ha már rendelkezik ChatLab-fiókkal, jelentkezzen be. Ellenkező esetben hozzon létre egy új fiókot.

3. lépés: Válasszon előfizetési csomagot

Válassza ki az igényeinek megfelelő előfizetési csomagot. Az IdoBooking foglalási integrációs funkciói (apartmankeresés, elérhetőség-ellenőrzés, foglalások) STANDARD vagy PREMIUM csomagot igényelnek.

4. lépés: Válasszon egy chatbotot

Válasszon ki egy meglévő chatbotot az IdoBookinggal való összekapcsoláshoz, vagy hozzon létre egy újat. A varázsló automatikusan is létre tud hozni egy új botot.

5. lépés: Fejezze be a beállítást

A varázsló automatikusan elvégzi a következőket:

• Összekapcsolja az IdoBooking hitelesítési adatait a kiválasztott chatbottal
• Bekapcsolja az összes elérhető AI-műveletet (apartmankeresés, elérhetőség-ellenőrzések, foglalások)
• Visszairányítja Önt az IdoBooking felületére vagy a ChatLab adminisztrációs paneljére

A varázsló befejezése után a chatbot készen áll a foglalási érdeklődések kezelésére. Az egyes AI-műveleteket a Bot Settings > Actions (Botbeállítások > Műveletek) menüpontban finomhangolhatja.

---

B lehetőség: Manuális beállítás

Ha inkább manuálisan szeretné konfigurálni az integrációt, kövesse az alábbi lépéseket.

1. rész: API-felhasználó létrehozása az IdoBooking rendszerében

Mielőtt összekapcsolná a ChatLabot az IdoBooking rendszerével, létre kell hoznia egy dedikált felhasználót API-hozzáféréssel az IdoBooking paneljén.

1. lépés: Navigáljon a felhasználók kezeléséhez

1. Jelentkezzen be az IdoBooking adminisztrációs felületére
2. Lépjen a Settings > Users (Beállítások > Felhasználók) menüpontba
3. Kattintson az Add new user (Új felhasználó hozzáadása) lehetőségre

2. lépés: Hozza létre a felhasználói fiókot

1. Adjon meg egy login nevet az új felhasználónak (pl. „chatlab-api”)
2. Töltse ki a többi kötelező adatot
3. Állítson be egy biztonságos jelszót a fiókhoz

3. lépés: Konfigurálja az API-hozzáférést

Állítsa be az új felhasználó alábbi hozzáférési beállításait:

1. Kapcsolja be az „Active API access” (Aktív API-hozzáférés) lehetőséget - ez szükséges az integráció működéséhez
2. Kapcsolja ki az „Active panel access” (Aktív panelhozzáférés) lehetőséget - a felhasználónak nincs szüksége hozzáférésre az adminisztrációs felülethez

4. lépés: Állítsa be a felhasználói szerepkört és a jogosultságokat

A felhasználói szerepkör konfigurálására két lehetőség van:

A lehetőség: Rendszergazda szerepkör (egyszerűbb)

• Válassza az Administrator (Rendszergazda) szerepkört
• Mivel a felhasználó nem fér hozzá a panelhez, ez egy biztonságos megoldás, amely teljes körű API-jogosultságokat biztosít

B lehetőség: Egyéni felhasználói szerepkör (részletesebb)

Ha részletesebb szabályozást szeretne, válassza a Custom user (Egyéni felhasználó) lehetőséget, és konfigurálja a következő moduljogosultságokat:

• Reservations (Foglalások) - Csak olvasható (ha a chatbot csak lekéri a foglalási adatokat) vagy Teljes hozzáférés (ha a chatbot foglalásokat is létrehoz)
• Customers (Ügyfelek) - Csak olvasható
• Offers (Ajánlatok) - Csak olvasható

Egyéni felhasználók esetén a helyszínekre vonatkozó jogosultságokat is konfigurálnia kell:

1. Görgessen a Location and accommodation permissions (Helyszín- és szállásjogosultságok) szakaszhoz
2. Javasoljuk, hogy válassza a Select all (Mindet kijelöli) lehetőséget, hogy minden szálláshelyhez hozzáférést biztosítson

5. lépés: Kapcsolja ki a felesleges értesítéseket

Annak megakadályozására, hogy az API-felhasználó operatív értesítéseket kapjon, kapcsolja ki az alábbi opciókat:

• Notifications for property staff (Értesítések a személyzet számára) - Kikapcsolás
• Automatic email notifications (Automatikus e-mail-értesítések) - Kikapcsolás

6. lépés: Mentés és a kapcsolódási adatok összegyűjtése

1. Kattintson a Save (Mentés) gombra a felhasználói fiók létrehozásához
2. Jegyezze fel a következő adatokat - szüksége lesz rájuk a ChatLab konfigurálásához:

• Login - A létrehozott felhasználónév (pl. chatlab-api)
• Password - A megadott jelszó
• Subdomain - Az Ön IdoBooking aldomainje (pl. client3760)

Az aldomain megkeresése: Nézze meg az IdoBooking paneljének URL-címét. Ha az URL például https://client3760.idosell.com, akkor az Ön aldomainje a client3760.

2. rész: Az integráció beállítása a ChatLabban

1. lépés: Navigáljon a Connect fülre

1. Jelentkezzen be a ChatLab adminisztrációs paneljére
2. Válassza ki a konfigurálni kívánt botot
3. Lépjen a Connect (Összekapcsolás) fülre
4. Keresse meg az integrációk listájában az IdoBooking lehetőséget, majd kattintson rá

2. lépés: Adja meg a kapcsolódási adatokat

Töltse ki a kapcsolódási űrlapot az IdoBookingból összegyűjtött adatokkal:

• Client Subdomain - Adja meg az IdoBooking aldomaint (a teljes URL nélkül). Példa: client3760 (nem pedig https://client3760.idosell.com)
• System Login - Adja meg az IdoBookingban létrehozott API-felhasználó felhasználónevét
• System Password - Adja meg az API-felhasználó jelszavát
• Default Currency - Válassza ki az árinformációk pénznemét
• Default Language - Válassza ki a szállásleírások nyelvét

3. lépés: Csatlakozás

1. Az összes kötelező mező kitöltése után a Connect (Csatlakozás) gomb aktívvá válik
2. Kattintson a Connect gombra a kapcsolat létrehozásához
3. Várja meg a megerősítő üzenetet
4. A sikeres kapcsolódás után megjelenik a sikeres műveletet jelző értesítés

A sikeres csatlakozást követően a gomb felirata „Connect”-ről „Update Chatbot”-ra változik, valamint megjelenik egy „Disconnect” gomb arra az esetre, ha később le szeretné választani az integrációt.

---

AI-műveletek konfigurálása

Miután az IdoBooking integráció létrejött (bármelyik módszerrel), beállíthatja, hogy a chatbot milyen AI-műveleteket hajtson végre. Ha a piactéri beállítást használta, minden művelet alapértelmezés szerint be van kapcsolva.

Elérhető AI-műveletek

• Get Apartments - Kilistázza az elérhető apartmanokat és szálláshelyeket leírásokkal, ágyelrendezéssel és fényképekkel
• Find Available Apartments - Elérhető apartmanokat keres egy adott dátumtartományra, árinformációkkal együtt
• Check Apartment Availability - Ellenőrzi egy adott apartman elérhetőségét egy megadott dátumtartományban
• Get Reservations - Lekéri a meglévő foglalásokat azonosító, státusz vagy dátumtartomány alapján
• Create Reservation - Új foglalásokat hoz létre a vendégadatokkal és a foglalási részletekkel

Műveletek bekapcsolása és testreszabása

1. A kapcsolódás után kattintson a Configure AI Actions (AI-műveletek konfigurálása) gombra a sikeres műveletet jelző felugró ablakban, vagy navigáljon a Bot Settings > Actions menüponthoz, és keresse meg az IdoBooking kategóriát
2. Kapcsolja be a használni kívánt műveleteket
3. Igény szerint szabja testre a művelet címkéjét (a felhasználók számára a művelet futása közben megjelenő szöveget) és az utasításokat
4. Kattintson a Save (Mentés) gombra a módosítások alkalmazásához

A „Find available apartments” művelet konfigurálása

A Find available apartments művelethez két további beállítási lehetőség tartozik, amelyek meghatározzák, hogy hány apartmant jelenítsen meg a chatbot, amikor egy vendég az elérhetőségről kérdez, valamint hogy mely apartmanok kerüljenek a listába. Ezek eléréséhez nyissa meg a műveletet a Bot Settings > Actions > IdoBooking - find available apartments útvonalon.

Number of offers to show (Megjelenítendő ajánlatok száma)

Egy csúszka 3-10 közötti értékekkel (alapértelmezett: 6). Meghatározza, hogy a chatbot hány apartmant adjon vissza a felhasználónak egyetlen válaszban.

• Az alacsonyabb értékek (3-4) röviden és fókuszáltan tartják a választ, ami hasznos, ha a legtöbb vendég csak néhány kiemelt lehetőség közül választ.
• A magasabb értékek (8-10) nagyobb választékot nyújtanak az összehasonlításhoz, ami a szélesebb kínálattal rendelkező szállásoknál előnyös.

Offer selection strategy (Ajánlatkiválasztási stratégia)

Egy legördülő menü, amely eldönti, hogy a dátum és a vendégszám szerinti szűrés után mely apartmanok kerüljenek kiválasztásra az elérhető találatok teljes listájából. Négy lehetőség érhető el:

• Cheapest offers (Legolcsóbb ajánlatok - alapértelmezett) - a legalacsonyabb minimális árú apartmanokat adja vissza, a legolcsóbbtól a legdrágábbig rendezve. Ideális, ha a vendégek árérzékenyek, vagy ha a leginkább elérhető opciókkal szeretne indítani.
• Evenly distributed by price (Ár szerint egyenletesen elosztva) - az ártartományban egyenletesen eloszló apartmanokat választ ki. Például 9 ajánlat esetén körülbelül 3 legolcsóbbat, 3 középkategóriásat és 3 legdrágábbat jelenít meg. Akkor hasznos, ha azt szeretné, hogy a vendégek a teljes kínálatot lássák, ne csak a kedvező árú kategóriát.
• Most expensive offers (Legdrágább ajánlatok) - a legmagasabb árú apartmanokat adja vissza, a legdrágábbtól a legolcsóbbig rendezve. Prémium szálláshelyeknél előnyös, vagy ha a legmagasabb kategóriájú kínálatát szeretné előtérbe helyezni.
• Random selection (Véletlenszerű választás) - véletlenszerűen választ ki apartmanokat a szűrt eredményekből. Hasznos, ha a különböző beszélgetésekben változatosan szeretné bemutatni a kiemelt apartmanokat, elkerülve, hogy mindig ugyanazokat ajánlja.

Mindkét beállítás botonként kerül mentésre, a meglévő egyéni prompt és a műveletcímke mellett.

---

Bevált gyakorlatok

Biztonsági javaslatok (manuális beállítás esetén)

• Használjon dedikált API-felhasználót - Hozzon létre egy külön felhasználót kifejezetten a ChatLab integrációhoz ahelyett, hogy a személyes adminisztrátori fiókját használná
• Minimális jogosultságok elve - Csak a felhasználási esethez feltétlenül szükséges jogosultságokat adja meg. Használjon csak olvasható hozzáférést, ha a chatbotnak csupán információkat kell lekérnie
• Rendszeres jelszócsere - Rendszeresen frissítse az API-felhasználó jelszavát, majd frissítse a hitelesítő adatokat a ChatLabban is

A chatbot válaszainak optimalizálása

• Tréningezze a botot a szálláshely adataival - Töltse fel a tudásbázisba a szállások leírását, beleértve a felszereltséget, a szobák jellemzőit és az elhelyezkedés részleteit
• Állítson be világos beszélgetésmeneteket - Konfiguráljon olyan üdvözlő üzeneteket, amelyek arra ösztönzik a felhasználókat, hogy érdeklődjenek az elérhetőségről, és használjon javasolt kérdéseket, például „Elérhetőség ellenőrzése” vagy „Szobák megtekintése”

---

Hibaelhárítás

• A kapcsolódás sikertelen - Ellenőrizze, hogy az „Active API access” engedélyezve van-e a felhasználó számára az IdoBookingban
• „Access denied” (Hozzáférés megtagadva) hibák - Ellenőrizze, hogy a felhasználó rendelkezik-e a megfelelő moduljogosultságokkal
• Nem érkeznek adatok - Győződjön meg arról, hogy a felhasználónak van hozzáférése a releváns helyszínekhez és szállásokhoz
• Helytelen aldomain - Ellenőrizze az IdoBooking URL-címét, és kizárólag az aldomain részt másolja ki (pl. client3760 a következőből: https://client3760.idosell.com)

---