Integrare cu IdoBooking

Conectați chatbotul ChatLab cu sistemul dumneavoastră de rezervări IdoBooking pentru a oferi vizitatorilor site-ului informații despre disponibilitate în timp real și asistență la rezervare.

Ce oferă integrarea

Cu integrarea IdoBooking activată, chatbotul dumneavoastră poate:

• Să afișeze lista apartamentelor și a unităților de cazare disponibile, cu descrieri și fotografii
• Să verifice disponibilitatea pentru date specifice
• Să găsească apartamente disponibile pentru un anumit interval de date, împreună cu prețurile
• Să caute rezervări existente după ID, status sau interval de date
• Să creeze rezervări noi cu detaliile oaspeților

Există două modalități de a configura această integrare - prin IdoBooking Marketplace (recomandat) sau manual prin panoul de administrare ChatLab.

---

Opțiunea A: Configurare prin IdoBooking Marketplace (recomandat)

Cea mai rapidă modalitate de a conecta ChatLab cu IdoBooking este prin IdoBooking Marketplace. Această metodă gestionează automat datele de autentificare API și activează toate acțiunile AI pentru chatbotul dumneavoastră.

Pasul 1: Instalați ChatLab din IdoBooking Marketplace

1. Conectați-vă la panoul de administrare IdoBooking
2. Accesați secțiunea Marketplace
3. Căutați ChatLab și faceți clic pe Install (Instalează)

IdoBooking trimite automat datele dumneavoastră de autentificare API către ChatLab - nu este nevoie să creați un utilizator API separat sau să copiați manual credențialele.

Pasul 2: Creați un cont ChatLab sau conectați-vă

După activarea ChatLab în marketplace, sunteți redirecționat către un asistent de configurare ghidat. Dacă aveți deja un cont ChatLab, conectați-vă. În caz contrar, creați un cont nou.

Pasul 3: Alegeți un plan de abonament

Selectați un plan de abonament care corespunde nevoilor dumneavoastră. Funcționalitățile integrării de rezervare IdoBooking (căutare de apartamente, verificarea disponibilității, rezervări) necesită un plan Standard sau Premium.

Pasul 4: Selectați un chatbot

Alegeți un chatbot existent pe care doriți să îl conectați cu IdoBooking sau creați unul nou. Asistentul poate crea automat un bot nou pentru dumneavoastră.

Pasul 5: Finalizați configurarea

Asistentul realizează automat următoarele:

• Conectează datele de autentificare IdoBooking la chatbotul selectat
• Activează toate acțiunile AI disponibile (căutare de apartamente, verificări ale disponibilității, rezervări)
• Vă redirecționează înapoi la IdoBooking sau către panoul de administrare ChatLab

După finalizarea asistentului, chatbotul este pregătit să gestioneze întrebările despre rezervări. Puteți ajusta acțiunile AI individuale în Bot Settings > Actions (Setări bot > Acțiuni).

---

Opțiunea B: Configurare manuală

Dacă preferați să configurați integrarea manual, urmați acești pași.

Partea 1: Crearea unui utilizator API în IdoBooking

Înainte de a conecta ChatLab la sistemul dumneavoastră IdoBooking, trebuie să creați un utilizator dedicat cu acces API în panoul IdoBooking.

Pasul 1: Navigați la gestionarea utilizatorilor

1. Conectați-vă la panoul de administrare IdoBooking
2. Accesați Settings > Users (Setări > Utilizatori)
3. Faceți clic pe Add new user (Adaugă utilizator nou)

Pasul 2: Creați contul de utilizator

1. Introduceți un login name (nume de utilizator) pentru noul utilizator (de exemplu, „chatlab-api”)
2. Completați restul informațiilor solicitate
3. Setați o password (parolă) sigură pentru acest cont

Pasul 3: Configurați accesul API

Configurați următoarele setări de acces pentru noul utilizator:

1. Activați „Active API access” (Acces API activ) - acest lucru este necesar pentru funcționarea integrării
2. Dezactivați „Active panel access” (Acces panou activ) - utilizatorul nu are nevoie de acces la panoul de administrare

Pasul 4: Setați rolul și permisiunile utilizatorului

Aveți două opțiuni pentru configurarea rolului de utilizator:

Opțiunea A: Rol de administrator (mai simplu)

• Selectați Administrator ca rol
• Deoarece utilizatorul nu va avea acces la panou, aceasta este o opțiune sigură care acordă permisiuni API complete

Opțiunea B: Rol de utilizator personalizat (mai detaliat)

Dacă preferați un control mai detaliat, selectați Custom user (Utilizator personalizat) și configurați următoarele permisiuni pentru module:

• Reservations (Rezervări) - Read-only (Doar citire, dacă chatbotul trebuie doar să preia informații despre rezervări) sau Full access (Acces complet, dacă chatbotul va crea rezervări)
• Customers (Clienți) - Read-only (Doar citire)
• Offers (Oferte) - Read-only (Doar citire)

Pentru utilizatorii personalizați, trebuie să configurați și permisiunile pentru locații:

1. Derulați până la secțiunea Location and accommodation permissions (Permisiuni pentru locații și cazare)
2. Vă recomandăm să selectați Select all (Selectează tot) pentru a acorda acces la toate proprietățile

Pasul 5: Dezactivați notificările inutile

Pentru a împiedica utilizatorul API să primească notificări operaționale, dezactivați următoarele opțiuni:

• Notifications for property staff (Notificări pentru personalul proprietății) - Dezactivare
• Automatic email notifications (Notificări automate prin e-mail) - Dezactivare

Pasul 6: Salvați și colectați detaliile de conectare

1. Faceți clic pe Save (Salvează) pentru a crea contul de utilizator
2. Notați următoarele informații - veți avea nevoie de ele pentru configurarea ChatLab:

• Login - Numele de utilizator creat (de exemplu, chatlab-api)
• Password - Parola pe care ați setat-o
• Subdomain - Subdomeniul dumneavoastră IdoBooking (de exemplu, client3760)

Găsirea subdomeniului: Uitați-vă la adresa URL a panoului IdoBooking. De exemplu, dacă adresa este https://client3760.idosell.com, subdomeniul dumneavoastră este client3760.

Partea 2: Configurarea integrării în ChatLab

Pasul 1: Navigați la fila Connect

1. Conectați-vă la panoul de administrare ChatLab
2. Selectați botul pe care doriți să îl configurați
3. Accesați fila Connect (Conectare)
4. Găsiți și faceți clic pe IdoBooking în lista de integrări

Pasul 2: Introduceți detaliile de conectare

Completați formularul de conectare cu informațiile obținute din IdoBooking:

• Client Subdomain - Introduceți subdomeniul dumneavoastră IdoBooking (fără adresa URL completă). Exemplu: client3760 (nu https://client3760.idosell.com)
• System Login - Introduceți numele de utilizator al contului API creat în IdoBooking
• System Password - Introduceți parola pentru utilizatorul API
• Default Currency - Selectați moneda pentru informațiile de preț
• Default Language - Selectați limba pentru descrierile proprietăților

Pasul 3: Conectare

1. După completarea tuturor câmpurilor obligatorii, butonul Connect (Conectare) devine activ
2. Faceți clic pe Connect pentru a stabili conexiunea
3. Așteptați mesajul de confirmare
4. Odată conectat, veți vedea o notificare de succes

După conectarea cu succes, butonul se schimbă din „Connect” în „Update Chatbot”, și va apărea butonul „Disconnect” în cazul în care doriți să dezactivați integrarea ulterior.

---

Configurarea acțiunilor AI

Odată ce integrarea IdoBooking este conectată (prin oricare dintre metode), puteți configura ce acțiuni AI poate efectua chatbotul. Dacă ați utilizat configurarea prin marketplace, toate acțiunile sunt activate în mod implicit.

Acțiuni AI disponibile

• Get Apartments - Afișează lista apartamentelor și a unităților de cazare disponibile, cu descrieri, configurații ale paturilor și fotografii
• Find Available Apartments - Caută apartamente disponibile pentru un anumit interval de date, cu informații despre prețuri
• Check Apartment Availability - Verifică disponibilitatea pentru un apartament specific și un interval de date
• Get Reservations - Caută rezervări existente după ID, status sau interval de date
• Create Reservation - Creează rezervări noi cu detaliile oaspeților și informațiile despre rezervare

Activarea și personalizarea acțiunilor

1. După conectare, faceți clic pe Configure AI Actions (Configurează acțiunile AI) în fereastra modală de succes sau navigați la Bot Settings > Actions și căutați categoria IdoBooking
2. Comutați acțiunile pe care doriți să le activați
3. Personalizați eticheta acțiunii (textul afișat utilizatorilor în timp ce acțiunea rulează) și instrucțiunile, după cum este necesar
4. Faceți clic pe Save (Salvează) pentru a aplica modificările

Configurarea „Find available apartments”

Acțiunea Find available apartments dispune de două controale suplimentare care decid câte apartamente afișează chatbotul atunci când un oaspete întreabă despre disponibilitate și care apartamente sunt selectate. Deschideți acțiunea din Bot Settings > Actions > IdoBooking - find available apartments pentru a le accesa.

Number of offers to show

Un glisor cu valori între 3 și 10 (implicit 6). Acesta controlează câte apartamente returnează chatbotul utilizatorului într-un singur răspuns.

• Valorile mai mici (3-4) mențin răspunsul scurt și concis, util atunci când majoritatea oaspeților aleg între câteva favorite.
• Valorile mai mari (8-10) oferă oaspeților o varietate mai mare de comparat, fiind utile pentru proprietățile cu un catalog mai amplu.

Offer selection strategy

Un meniu derulant care decide ce apartamente sunt alese din lista completă de rezultate disponibile, după filtrarea în funcție de dată și numărul de oaspeți. Sunt disponibile patru opțiuni:

• Cheapest offers (implicit) - returnează apartamentele cu cel mai mic preț minim, sortate de la cel mai ieftin la cel mai scump. Util atunci când oaspeții sunt atenți la preț sau doriți să începeți cu cele mai accesibile opțiuni.
• Evenly distributed by price - alege apartamente distribuite uniform pe întreaga gamă de prețuri. De exemplu, pentru 9 oferte, acest lucru oferă aproximativ 3 dintre cele mai ieftine, 3 cu preț mediu și 3 dintre cele mai scumpe. Este util atunci când doriți ca oaspeții să vadă întreaga gamă de opțiuni disponibile, nu doar varianta economică.
• Most expensive offers - returnează apartamentele cu cele mai mari prețuri, sortate de la cel mai scump la cel mai ieftin. O opțiune excelentă pentru proprietăți premium sau atunci când doriți să evidențiați opțiunile de top.
• Random selection - alege apartamente la întâmplare din rezultatele filtrate. Este util atunci când doriți să variați apartamentele evidențiate între conversații și să evitați recomandarea repetată a acelorași opțiuni.

Ambele setări sunt salvate pentru fiecare bot în parte, alături de promptul personalizat existent și eticheta acțiunii.

---

Bune practici

Recomandări de securitate (configurare manuală)

• Utilizați un utilizator API dedicat - Creați un utilizator separat exclusiv pentru integrarea ChatLab, în loc să utilizați contul personal de administrator
• Permisiuni minime - Acordați doar permisiunile necesare pentru scenariul dumneavoastră de utilizare. Utilizați acces doar pentru citire (read-only) dacă chatbotul trebuie doar să preia informații
• Rotirea periodică a credențialelor - Actualizați periodic parola utilizatorului API, apoi actualizați datele de autentificare în ChatLab

Optimizarea răspunsurilor chatbotului

• Antrenați-vă botul cu informații despre proprietate - Adăugați descrieri ale unităților de cazare în baza de cunoștințe, inclusiv facilități, caracteristici ale camerelor și detalii despre locație
• Stabiliți fluxuri de conversație clare - Configurați mesaje de întâmpinare care ghidează utilizatorii să întrebe despre disponibilitate și folosiți întrebări sugerate precum „Verifică disponibilitatea” sau „Vezi camerele”

---

Depanare

• Conexiunea eșuează - Verificați dacă opțiunea „Active API access” este activată pentru utilizator în IdoBooking
• Erori de tip „Access denied” - Verificați dacă utilizatorul are permisiunile corecte pentru module
• Nu se returnează date - Asigurați-vă că utilizatorul are acces la locațiile și proprietățile relevante
• Subdomeniu incorect - Verificați adresa URL IdoBooking și extrageți doar partea de subdomeniu (de exemplu, client3760 din https://client3760.idosell.com)

---