Integrarea 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.

Exemplu de conversație

Exemplul ilustrează experiența clienților. Acțiunile disponibile și informațiile afișate depind de această integrare și de configurația dumneavoastră.

Înainte de a începe

Mai întâi creați sau selectați un chatbot. Aveți nevoie de permisiuni pentru a-i gestiona integrările și de acces la setările de conectare ale contului extern. Dacă pe caseta Connect (Conectare) apare un mesaj de upgrade sau de contact, verificați dacă abonamentul dumneavoastră include această integrare. Păstrați confidențialitatea datelor de autentificare API; nu le introduceți niciodată în codul de încorporare al site-ului.

Ce oferă integrarea

Cu integrarea IdoBooking activată, chatbotul dumneavoastră poate:

• Să listeze apartamentele și unitățile de cazare disponibile, împreună 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 datele 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)

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

Pasul 1: Instalați ChatLab din IdoBooking Marketplace

1. Conectați-vă la panoul de administrare IdoBooking
2. Mergeți la secțiunea Marketplace
3. Căutați ChatLab și apăsați 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 datele manual.

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

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 se potrivește nevoilor dumneavoastră. Funcțiile de integrare a rezervărilor IdoBooking (căutarea apartamentelor, verificarea disponibilității, rezervările) necesită funcționalitatea de integrare IdoBooking. Dacă abonamentul dumneavoastră nu o include, urmați instrucțiunile de upgrade sau de contact.

Pasul 4: Selectați un chatbot

Alegeți un chatbot existent pentru a-l conecta cu IdoBooking sau creați unul nou. Asistentul poate crea un bot nou în mod automat.

Pasul 5: Finalizați configurarea

Asistentul efectuează automat următoarele operațiuni:

• Conectează datele de autentificare IdoBooking la chatbotul selectat
• Activează căutarea apartamentelor, verificarea disponibilității și căutarea rezervărilor. Crearea rezervărilor nu este activată automat.
• Vă redirecționează înapoi la IdoBooking sau la panoul de administrare ChatLab

După finalizarea asistentului, chatbotul dumneavoastră este pregătit să preia solicitările legate de rezervări. Puteți ajusta acțiunile AI individuale în Settings > Actions (Setări > 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. Mergeți la Settings > Users (Setări > Utilizatori)
3. Apăsați 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 obligatorii
3. Setați o 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 opțiunea „Active API access” (Acces API activ) - acest lucru este necesar pentru funcționarea integrării
2. Dezactivați opțiunea „Active panel access” (Acces activ la panou) - 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: Rolul de administrator (mai simplu)

• Selectați Administrator ca rol
• Aceasta acordă permisiuni API extinse chiar și atunci când accesul la panou este dezactivat. Utilizați un rol personalizat dacă integrarea are nevoie doar de anumite operațiuni de citire.

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 de modul:

• 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 de locație:

1. Derulați până la secțiunea Location and accommodation permissions (Permisiuni pentru locații și unități de cazare)
2. Selectați proprietățile pe care trebuie să le acopere acest chatbot; acordați acces la toate doar dacă acesta este scopul dorit.

Pasul 5: Dezactivați notificările inutile

Pentru a preveni primirea notificărilor operaționale de către utilizatorul API, 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 notați datele de conectare

1. Apăsați 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 pe care l-ați 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 dumneavoastră 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. Mergeți la fila Connect (Conectare)
4. Găsiți și apăsați pe IdoBooking în lista de integrări

Pasul 2: Introduceți datele de conectare

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

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

Pasul 3: Conectați

1. După completarea tuturor câmpurilor obligatorii, butonul Connect devine activ
2. Apăsați 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” (Actualizează chatbotul), iar un buton „Disconnect” (Deconectează) apare în cazul în care doriți să dezactivați integrarea mai târziu.

---

Configurarea acțiunilor AI

Odată ce integrarea IdoBooking este conectată (prin oricare dintre metode), puteți configura ce acțiuni AI poate efectua chatbotul dumneavoastră. Revizuiți acțiunile active după oricare dintre metodele de configurare. Crearea rezervărilor nu este activată automat.

Acțiuni AI disponibile

• Get Apartments - Listează apartamentele și unitățile de cazare disponibile, cu descrieri, configurația paturilor și fotografii
• Find Available Apartments - Caută apartamente disponibile pentru un anumit interval de date, cu informații despre preț
• Check Apartment Availability - Verifică disponibilitatea pentru un anumit apartament ș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 datele oaspeților și informațiile despre rezervare
• AI room search - Compară descrierea dorințelor oaspetelui cu descrierile camerelor dumneavoastră, în loc să verifice datele

AI room search și Get Apartments sunt alternative, nu adiții. Când AI room search este activat, acesta înlocuiește instrumentul simplu de listare, iar Get Apartments este retras din chatbot, astfel încât un singur instrument de listare a camerelor este activ în orice moment. Acțiunile bazate pe date calendaristice nu sunt afectate.

Activarea și personalizarea acțiunilor

1. După conectare, apăsați pe Configure AI Actions (Configurează acțiunile AI) în fereastra modală de succes sau navigați la Settings > Actions și găsiț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. În caseta de dialog a acțiunii, apăsați pe Enable (Activează) pentru o acțiune nouă sau pe Update (Actualizează) pentru o acțiune existentă.

Configurarea „Find available apartments”

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

Number of offers to show (Numărul de oferte de afișat)

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 la obiect, util atunci când majoritatea oaspeților aleg între câteva favorite.
• Valorile mai mari (8-10) oferă oaspeților mai multă varietate pentru comparație, util pentru proprietăți cu un catalog mai amplu.

Offer selection strategy (Strategia de selectare a ofertelor)

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

• Cheapest offers (Cele mai ieftine oferte - 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 (Distribuite uniform după preț) - alege apartamente distribuite uniform pe întreaga plajă 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. Util atunci când doriți ca oaspeții să vadă întreaga gamă disponibilă, nu doar opțiunile economice.
• Most expensive offers (Cele mai scumpe oferte) - returnează apartamentele cu cel mai mare preț, sortate de la cel mai scump la cel mai ieftin. Util pentru proprietăți premium sau când doriți să evidențiați oferta din categoria superioară.
• Random selection (Selecție aleatorie) - alege apartamente la întâmplare din rezultatele filtrate. Util atunci când doriți să variați apartamentele evidențiate între conversații și să evitați recomandarea constantă 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.

---

Testați configurarea finalizată

Deschideți Overview (Prezentare generală) și începeți o conversație nouă de test. Solicitați camere pentru un interval viitor de date și un număr specific de oaspeți, apoi deschideți linkul de rezervare returnat și comparați datele, moneda și prețul cu cele din IdoBooking. Testați căutarea rezervărilor folosind o rezervare pe care sunteți autorizat să o inspectați. Activați și testați Create Reservation doar atunci când intenționați să creați o rezervare reală; un test în chat poate scrie date în sistemul dumneavoastră de rezervări.

Bune practici

Recomandări de securitate (configurare manuală)

• Utilizați un utilizator API dedicat - Creați un utilizator separat special pentru integrarea ChatLab, în loc să folosiți contul personal de administrator
• Permisiuni minime - Acordați doar permisiunile necesare pentru scenariul dumneavoastră de utilizare. Utilizați acces doar pentru citire dacă chatbotul trebuie doar să preia informații
• Rotirea periodică a datelor de autentificare - 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 dumneavoastră 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 „Verificați disponibilitatea” sau „Arătați camerele”

---

Depanare

• Conexiunea eșuează - Verificați dacă „Active API access” este activat pentru utilizator în IdoBooking
• Erori de tip „Access denied” - Verificați dacă utilizatorul are permisiunile de modul corecte
• 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)

---

Catalogul de camere și Hotel Overview

Dacă în contul dumneavoastră apare fila Hotel, folosiți Hotel > Rooms (Hotel > Camere) pentru a verifica catalogul de camere și starea antrenării. AI room search este distinct de verificările disponibilității bazate pe date: acesta compară descrierile camerelor, în timp ce acțiunile de disponibilitate verifică un sejur solicitat. Indexarea automată a camerelor depinde de autoindexarea catalogului și de capacitatea atribuită camerelor; în caz contrar, utilizați Train rooms (Antrenează camerele) când este disponibil. Verificați acțiunile activate și așteptați finalizarea antrenării înainte de a vă baza pe AI room search.

Articole conexe

• Adăugarea chatbotului pe site-ul dumneavoastră
• Antrenarea chatbotului dumneavoastră
• Trimiterea unui link către chatbotul dumneavoastră