Integraatio IdoBookingin kanssa

Yhdistä ChatLab-chatbotisi IdoBooking-varausjärjestelmääsi tarjotaksesi reaaliaikaisia saatavuustietoja ja varausapua verkkosivustosi vierailijoille.

Esimerkkikeskustelu

Esimerkki havainnollistaa asiakaskokemusta. Saatavilla olevat toiminnot ja palautetut tiedot riippuvat tästä integraatiosta ja määrityksistäsi.

Ennen kuin aloitat

Luo tai valitse ensin chatbot. Tarvitset käyttöoikeuden sen integraatioiden hallintaan sekä pääsyn ulkoisen tilin yhteysasetuksiin. Jos Connect-ruudussa näkyy päivitys- tai yhteydenottokehote, tarkista, että tilauksesi sisältää tämän integraation. Pidä API-tunnisteet luottamuksellisina; älä koskaan liitä niitä verkkosivuston upotuskoodiin.

Mitä integraatio tarjoaa

Kun IdoBooking-integraatio on käytössä, chatbotisi voi:

• Listata saatavilla olevat huoneistot ja majoitukset kuvauksineen ja valokuvineen
• Tarkistaa saatavuuden tietyille päivämäärille
• Etsiä saatavilla olevat huoneistot valitulle ajanjaksolle hintatietoineen
• Hakea olemassa olevia varauksia tunnisteen (ID), tilan tai päivämäärävälin mukaan
• Luoda uusia varauksia vieraan tiedoilla

Tämän integraation voi ottaa käyttöön kahdella tavalla - IdoBooking Marketplace -kauppapaikan kautta (suositus) tai manuaalisesti ChatLabin hallintapaneelista.

---

Vaihtoehto A: Käyttöönotto IdoBooking Marketplacen kautta (suositus)

Nopein tapa yhdistää ChatLab ja IdoBooking on IdoBooking Marketplace. Tämä menetelmä käsittelee API-tunnisteet automaattisesti ja ottaa lukutoiminnot käyttöön chatbotillesi.

Vaihe 1: Asenna ChatLab IdoBooking Marketplacesta

1. Kirjaudu sisään IdoBooking-hallintapaneeliisi
2. Siirry Marketplace-osioon
3. Etsi ChatLab ja napsauta Install (Asenna)

IdoBooking lähettää API-tunnisteesi automaattisesti ChatLabiin - erillistä API-käyttäjää ei tarvitse luoda eikä tunnisteita tarvitse kopioida manuaalisesti.

Vaihe 2: Luo ChatLab-tili tai kirjaudu sisään

Kun olet aktivoinut ChatLabin kauppapaikassa, sinut ohjataan ohjattuun käyttöönottotoimintoon. Jos sinulla on jo ChatLab-tili, kirjaudu sisään. Muussa tapauksessa luo uusi tili.

Vaihe 3: Valitse tilaussopimus

Valitse tarpeisiisi sopiva tilaussopimus. IdoBooking-varausintegraation toiminnot (huoneistohaku, saatavuuden tarkistus, varaukset) edellyttävät IdoBooking-integraatio-ominaisuutta. Jos tilauksesi ei sisällä sitä, toimi päivitys- tai yhteydenottokehotteen mukaisesti.

Vaihe 4: Valitse chatbot

Valitse olemassa oleva chatbot yhdistettäväksi IdoBookingiin tai luo uusi. Ohjattu toiminto voi luoda uuden botin puolestasi automaattisesti.

Vaihe 5: Viimeistele asennus

Ohjattu toiminto tekee automaattisesti seuraavat toimet:

• Yhdistää IdoBooking-tunnisteesi valittuun chatbotiin
• Ottaa käyttöön huoneistohaun, saatavuustarkistukset ja varausten haun. Varausten luominen ei kytkeydy päälle automaattisesti.
• Ohjaa sinut takaisin IdoBookingiin tai ChatLabin hallintapaneeliin

Kun ohjattu toiminto on suoritettu, chatbotisi on valmis käsittelemään varauskyselyitä. Voit hienosäätää yksittäisiä AI-toimintoja kohdassa Settings > Actions (Asetukset > Toiminnot).

---

Vaihtoehto B: Manuaalinen asennus

Jos haluat määrittää integraation mieluummin manuaalisesti, noudata näitä ohjeita.

Osa 1: API-käyttäjän luominen IdoBookingissa

Ennen kuin yhdistät ChatLabin IdoBooking-järjestelmääsi, sinun on luotava erillinen käyttäjä API-oikeuksilla IdoBooking-paneelissasi.

Vaihe 1: Siirry käyttäjähallintaan

1. Kirjaudu sisään IdoBooking-hallintapaneeliisi
2. Siirry kohtaan Settings > Users (Asetukset > Käyttäjät)
3. Napsauta Add new user (Lisää uusi käyttäjä)

Vaihe 2: Luo käyttäjätili

1. Syötä login name (käyttäjätunnus) uudelle käyttäjälle (esim. "chatlab-api")
2. Täytä loput vaaditut tiedot
3. Määritä tälle tilille turvallinen password (salasana)

Vaihe 3: Määritä API-käyttöoikeudet

Määritä uudelle käyttäjälle seuraavat käyttöoikeusasetukset:

1. Ota käyttöön "Active API access" - tämä vaaditaan integraation toimimiseksi
2. Ota pois käytöstä "Active panel access" - käyttäjä ei tarvitse pääsyä hallintapaneeliin

Vaihe 4: Määritä käyttäjärooli ja käyttöoikeudet

Sinulla on kaksi vaihtoehtoa käyttäjäroolin määrittämiseen:

Vaihtoehto A: Administrator-rooli (yksinkertaisempi)

• Valitse rooliksi Administrator (Ylläpitäjä)
• Tämä myöntää laajat API-oikeudet myös silloin, kun paneelipääsy on poistettu käytöstä. Käytä mukautettua roolia, jos integraatio tarvitsee vain valikoituja lukutoimintoja.

Vaihtoehto B: Mukautettu käyttäjärooli (tarkempi)

Jos haluat tarkemman hallinnan, valitse Custom user (Mukautettu käyttäjä) ja määritä seuraavat moduulioikeudet:

• Reservations - Vain luku (Read-only, jos chatbotin tarvitsee vain hakea varaustietoja) tai Täysi pääsy (Full access, jos chatbot luo varauksia)
• Customers - Vain luku (Read-only)
• Offers - Vain luku (Read-only)

Mukautetuille käyttäjille on määritettävä myös sijaintioikeudet:

1. Vieritä osioon Location and accommodation permissions (Sijainti- ja majoitusoikeudet)
2. Valitse kohteet, jotka tämän chatbotin tulisi kattaa; myönnä pääsy kaikkiin vain, jos se on nimenomainen tarkoituksesi.

Vaihe 5: Poista tarpeettomat ilmoitukset käytöstä

Estääksesi API-käyttäjää vastaanottamasta toiminnallisia ilmoituksia poista seuraavat valinnat käytöstä:

• Notifications for property staff - Poista käytöstä
• Automatic email notifications - Poista käytöstä

Vaihe 6: Tallenna ja kerää yhteystiedot

1. Luo käyttäjätili napsauttamalla Save (Tallenna)
2. Kirjaa muistiin seuraavat tiedot - tarvitset niitä ChatLabin määrityksessä:

• Login - Luomasi käyttäjätunnus (esim. chatlab-api)
• Password - Asettamasi salasana
• Subdomain - IdoBooking-aliverkkotunnuksesi (esim. client3760)

Aliverkkotunnuksen löytäminen: Katso IdoBooking-paneelisi URL-osoitetta. Jos osoitteesi on esimerkiksi https://client3760.idosell.com, aliverkkotunnuksesi on client3760.

Osa 2: Integraation määrittäminen ChatLabissa

Vaihe 1: Siirry Connect-välilehdelle

1. Kirjaudu sisään ChatLab-hallintapaneeliisi
2. Valitse botti, jonka asetuksia haluat muuttaa
3. Siirry Connect-välilehdelle (Yhdistä)
4. Etsi ja napsauta IdoBooking integraatioluettelosta

Vaihe 2: Syötä yhteystiedot

Täytä yhteyslomake IdoBookingista kerätyillä tiedoilla:

• Client Subdomain - Syötä IdoBooking-aliverkkotunnuksesi (ilman koko URL-osoitetta). Esimerkki: client3760 (ei https://client3760.idosell.com)
• System Login - Syötä IdoBookingissa luomasi API-käyttäjän käyttäjätunnus
• System Password - Syötä API-käyttäjän salasana
• Default Currency - Valitse valuutta hintatiedoille
• Default Language - Valitse kieli kohteen kuvauksille

Vaihe 3: Yhdistä

1. Kun kaikki vaaditut kentät on täytetty, Connect-painike (Yhdistä) aktivoituu
2. Muodosta yhteys napsauttamalla Connect
3. Odota vahvistusviestiä
4. Kun yhteys on muodostettu, näet onnistumisilmoituksen

Onnistuneen yhteydenmuodostuksen jälkeen painikkeen teksti muuttuu muodosta "Connect" muotoon "Update Chatbot", ja näkyviin tulee "Disconnect"-painike, jos haluat poistaa integraation käytöstä myöhemmin.

---

AI-toimintojen määrittäminen

Kun IdoBooking-integraatiosi on yhdistetty (kummalla tahansa tavalla), voit määrittää, mitä AI-toimintoja chatbotisi voi suorittaa. Tarkista aktiiviset toiminnot kummankin käyttöönottotavan jälkeen. Varauksen luominen ei kytkeydy päälle automaattisesti.

Käytettävissä olevat AI-toiminnot

• Get Apartments - Listaa saatavilla olevat huoneistot ja majoitukset kuvauksineen, vuodekokoonpanoineen ja valokuvineen
• Find Available Apartments - Etsii saatavilla olevat huoneistot valitulle ajanjaksolle hintatietoineen
• Check Apartment Availability - Tarkistaa tietyn huoneiston saatavuuden valitulle ajanjaksolle
• Get Reservations - Hakee olemassa olevia varauksia tunnisteen (ID), tilan tai päivämäärävälin mukaan
• Create Reservation - Luo uusia varauksia vieraan tiedoilla ja varaustiedoilla
• AI room search - Vertaa vieraan toiveiden kuvausta huonekuvauksiisi päivämäärien tarkistamisen sijaan

AI room search ja Get Apartments ovat vaihtoehtoja toisilleen, eivät lisäyksiä. Kun AI room search on päällä, se korvaa tavallisen listaustyökalun ja Get Apartments poistetaan chatbotin käytöstä, jotta vain yksi huoneiden listaustyökalu on kerrallaan aktiivinen. Päivämääriin perustuviin toimintoihin tämä ei vaikuta.

Toimintojen ottaminen käyttöön ja mukauttaminen

1. Yhdistämisen jälkeen napsauta Configure AI Actions (Määritä AI-toiminnot) onnistumisikkunassa tai siirry kohtaan Settings > Actions (Asetukset > Toiminnot) ja etsi IdoBooking-kategoria
2. Kytke päälle toiminnot, jotka haluat ottaa käyttöön
3. Mukauta toiminnon nimikettä (käyttäjille näytettävä teksti toiminnon ollessa käynnissä) ja ohjeita tarpeen mukaan
4. Napsauta toimintoikkunassa Enable (Ota käyttöön) uudelle toiminnolle tai Update (Päivitä) olemassa olevalle toiminnolle.

"Find available apartments" -toiminnon määrittäminen

Toiminnossa Find available apartments on kaksi lisäsäädintä, jotka määrittävät, kuinka monta huoneistoa chatbot näyttää vieraan kysyessä saatavuutta ja mitkä huoneistot valikoituvat mukaan. Avaa toiminto kohdasta Settings > Actions > IdoBooking - find available apartments päästäksesi niihin käsiksi.

Näytettävien tarjousten määrä (Number of offers to show)

Liukusäädin, jonka asteikko on 3-10 (oletus 6). Se määrittää, kuinka monta huoneistoa chatbot palauttaa käyttäjälle yhdessä vastauksessa.

• Pienemmät arvot (3-4) pitävät vastauksen lyhyenä ja ytimekkäänä, mikä on hyödyllistä silloin, kun useimmat vieraat valitsevat vain muutaman suosikin väliltä.
• Suuremmat arvot (8-10) tarjoavat vieraille enemmän vaihtoehtoja vertailtavaksi, mikä on hyödyllistä kohteissa, joilla on laajempi valikoima.

Tarjousten valintastrategia (Offer selection strategy)

Pudotusvalikko, joka määrittää, mitkä huoneistot valitaan saatavilla olevien tulosten koko luettelosta päivämäärä- ja vierasmääräsuodatuksen jälkeen. Käytettävissä on neljä vaihtoehtoa:

• Cheapest offers (Halvimmat tarjoukset, oletus) - palauttaa huoneistot, joilla on alhaisin vähimmäishinta, lajiteltuna halvimmasta kalleimpaan. Hyvä vaihtoehto silloin, kun vieraat ovat hintatietoisia tai haluat tuoda edullisimmat vaihtoehdot ensin esille.
• Evenly distributed by price (Tasaisesti hinnan mukaan jaetut) - valitsee huoneistoja tasaisesti koko hintahaarukasta. Esimerkiksi 9 tarjouksen kohdalla tämä antaa karkeasti 3 halvinta, 3 keskihintaista ja 3 kalleinta. Hyödyllinen silloin, kun haluat vieraiden näkevän koko saatavilla olevan skaalan pelkän edullisen pään sijaan.
• Most expensive offers (Kalleimmat tarjoukset) - palauttaa korkeimman hintaluokan huoneistot lajiteltuna kalleimmasta halvimpaan. Hyvä vaihtoehto premium-kohteille tai silloin, kun haluat korostaa huipputason valikoimaasi.
• Random selection (Satunnainen valinta) - valitsee huoneistoja satunnaisesti suodatetuista tuloksista. Hyödyllinen silloin, kun haluat vaihdella keskusteluissa esille nostettavia huoneistoja ja välttää aina samojen suosittelemista.

Molemmat asetukset tallennetaan bottikohtaisesti yhdessä olemassa olevan mukautetun promptin ja toimintonimikkeen kanssa.

---

Testaa valmista asennusta

Avaa Overview (Yleiskatsaus) ja aloita uusi testikeskustelu. Pyydä huoneita tulevalle ajanjaksolle ja tietylle vierasmäärälle, avaa sitten palautettu varauslinkki ja vertaa päivämääriä, valuuttaa sekä hintaa IdoBookingin tietoihin. Testaa varaushakua sellaisella varauksella, jonka tarkasteluun sinulla on oikeus. Ota Create Reservation käyttöön ja testaa sitä vain silloin, kun aiot tehdä oikean varauksen; keskustelutesti voi tehdä kirjauksia varausjärjestelmääsi.

Parhaat käytännöt

Turvallisuussuositukset (manuaalinen asennus)

• Käytä erillistä API-käyttäjää - Luo erillinen käyttäjä nimenomaan ChatLab-integraatiota varten sen sijaan, että käyttäisit henkilökohtaista ylläpitäjätiliäsi
• Minimaaliset käyttöoikeudet - Myönnä vain käyttötapauksesi kannalta välttämättömät oikeudet. Käytä vain luku -oikeutta, jos chatbotin tarvitsee ainoastaan hakea tietoja
• Säännöllinen tunnistetietojen vaihtaminen - Päivitä API-käyttäjän salasana säännöllisesti ja päivitä sitten tiedot ChatLabiin

Chatbotin vastausten optimointi

• Kouluta bottisi majoitustiedoilla - Lisää majoituskohteidesi kuvaukset tietopohjaan, mukaan lukien mukavuudet, huoneiden ominaisuudet ja sijaintitiedot
• Määritä selkeät keskustelukulut - Määritä tervetuloviestit, jotka ohjaavat käyttäjiä kysymään saatavuudesta, ja käytä ehdotettuja kysymyksiä, kuten "Tarkista saatavuus" tai "Näytä huoneet"

---

Vianmääritys

• Yhteys epäonnistuu - Tarkista, että käyttäjälle on kytketty päälle "Active API access" IdoBookingissa
• "Access denied" -virheet (Pääsy estetty) - Tarkista, että käyttäjällä on oikeat moduulioikeudet
• Tietoja ei palauteta - Varmista, että käyttäjällä on pääsy kyseisiin sijainteihin ja kohteisiin
• Virheellinen aliverkkotunnus - Tarkista IdoBooking-URL-osoitteesi ja erota siitä vain aliverkkotunnuksen osuus (esim. client3760 osoitteesta https://client3760.idosell.com)

---

Huoneluettelo ja hotellin yleisnäkymä

Jos tililläsi näkyy Hotel-välilehti (Hotelli), käytä kohtaa Hotel > Rooms tarkistaaksesi huonevalikoiman ja koulutuksen tilan. AI room search on erillinen päivämääriin perustuvista saatavuustarkistuksista: se vertaa huonekuvauksia, kun taas saatavuustoiminnot tarkistavat pyydetyn majoitusajan. Automaattinen huoneiden indeksointi riippuu luettelon automaattisesta indeksoinnista ja määritetystä huonekapasiteetista; muussa tapauksessa käytä toimintoa Train rooms (Kouluta huoneet), kun se on käytettävissä. Tarkista käytössä olevat toiminnot ja odota koulutuksen valmistumista ennen kuin luotat AI room search -toimintoon.

Aiheeseen liittyvät artikkelit

• Chatbotin lisääminen verkkosivustollesi
• Chatbotin kouluttaminen
• Linkin lähettäminen chatbottiisi