Integraatio IdoBookingin kanssa

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

Mitä integraatio tarjoaa

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

• Listata saatavilla olevat huoneistot ja majoitukset kuvauksineen ja kuvineen
• Tarkistaa saatavuuden tietyille päivämäärille
• Etsiä saatavilla olevat huoneistot valitulle ajanjaksolle hintatietoineen
• Hakea olemassa olevia varauksia tunnuksen, tilan tai ajanjakson mukaan
• Luoda uusia varauksia vierastietojen kera

Integraation käyttöönottoon on kaksi tapaa - IdoBooking Marketplacen kautta (suositeltu) tai manuaalisesti ChatLabin hallintapaneelista.

---

Vaihtoehto A: Asennus IdoBooking Marketplacen kautta (suositeltu)

Nopein tapa yhdistää ChatLab IdoBookingiin on IdoBooking Marketplacen kautta. Tämä menetelmä käsittelee API-tunnukset automaattisesti ja ottaa käyttöön kaikki chatbotisi tekoälytoiminnot.

Vaihe 1: Asenna ChatLab IdoBooking Marketplacesta

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

IdoBooking lähettää API-tunnuksesi automaattisesti ChatLabille - erillistä API-käyttäjää ei tarvitse luoda eikä tunnuksia tarvitse kopioida manuaalisesti.

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

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

Vaihe 3: Valitse tilauspaketti

Valitse tarpeisiisi sopiva tilauspaketti. IdoBooking-varausintegraation ominaisuudet (huoneistohaku, saatavuuden tarkistus, varaukset) vaativat STANDARD- tai PREMIUM-paketin.

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-tunnuksesi valittuun debottiin
• Ottaa käyttöön kaikki saatavilla olevat tekoälytoiminnot (huoneistohaku, saatavuustarkistukset, varaukset)
• Ohjaa sinut takaisin IdoBookingiin tai ChatLabin hallintapaneeliin

Kun olet suorittanut ohjatun toiminnon loppuun, chatbotisi on valmis käsittelemään varauskyselyitä. Voit hienosäätää yksittäisiä tekoälytoimintoja kohdassa Bot Settings > Actions (Botin asetukset > Toiminnot).

---

Vaihtoehto B: Manuaalinen asennus

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

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

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

Vaihe 1: Siirry käyttäjähallintaan

1. Kirjaudu 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ä uudelle käyttäjälle käyttäjätunnus (esim. "chatlab-api")
2. Täytä loput vaaditut tiedot
3. Määritä tilille vahva 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 oikeudet

Käyttäjäroolin määrittämiseen on kaksi vaihtoehtoa:

Vaihtoehto A: Ylläpitäjän rooli (yksinkertaisempi)

• Valitse rooliksi Administrator (Ylläpitäjä)
• Koska käyttäjällä ei ole pääsyä paneeliin, tämä on turvallinen vaihtoehto, joka myöntää täydet API-oikeudet

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

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

• Reservations - Vain luku (jos chatbotin tarvitsee vain hakea varaustietoja) tai Täydet oikeudet (jos chatbot luo varauksia)
• Customers - Vain luku
• Offers - Vain luku

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

1. Vieritä osioon Location and accommodation permissions
2. Suosittelemme valitsemaan Select all, jotta pääsy myönnetään kaikkiin kohteisiin

Vaihe 5: Ota tarpeettomat ilmoitukset pois käytöstä

Estääksesi API-käyttäjää vastaanottamasta toiminnallisia ilmoituksia ota seuraavat vaihtoehdot pois käytöstä:

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

Vaihe 6: Tallenna ja kerää yhteystiedot

1. Napsauta Save (Tallenna) luodaksesi käyttäjätilin
2. Kirjaa seuraavat tiedot muistiin - tarvitset niitä ChatLabin määrityksessä:

• Login - Luomasi käyttäjätunnus (esim. chatlab-api)
• Password - Määrittämäsi 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 ChatLab-hallintapaneeliisi
2. Valitse botti, jonka asetuksia haluat muokata
3. Siirry Connect (Yhdistä) -välilehdelle
4. Etsi ja napsauta integraatioluettelosta IdoBooking

Vaihe 2: Syötä yhteystiedot

Täytä yhteyslomakkeeseen IdoBookingista kerätyt tiedot:

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

Vaihe 3: Yhdistä

1. Kun kaikki vaaditut kentät on täytetty, Connect-painike aktivoituu
2. Napsauta Connect muodostaaksesi yhteyden
3. Odota vahvistusviestiä
4. Kun yhteys on muodostettu, näet onnistumisilmoituksen

Onnistuneen yhdistämisen jälkeen painikkeen tekstiksi vaihtuu "Connect"-tekstin tilalle "Update Chatbot", ja näkyviin tulee "Disconnect"-painike siltä varalta, että haluat poistaa integraation käytöstä myöhemmin.

---

Tekoälytoimintojen määrittäminen

Kun IdoBooking-integraatiosi on yhdistetty (kummalla tahansa menetelmällä), voit määrittää, mitä tekoälytoimintoja chatbotisi voi suorittaa. Jos käytit marketplace-asennusta, kaikki toiminnot ovat oletuksena käytössä.

Saatavilla olevat tekoälytoiminnot

• Get Apartments - Listaa saatavilla olevat huoneistot ja majoitukset kuvauksineen, vuodejärjestelyineen ja kuvineen
• 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 tunnuksen, tilan tai ajanjakson mukaan
• Create Reservation - Luo uusia varauksia vierastietojen ja varaustietojen kera

Toimintojen ottaminen käyttöön ja mukauttaminen

1. Yhdistämisen jälkeen napsauta onnistumisikkunassa Configure AI Actions, tai siirry kohtaan Bot Settings > Actions ja etsi IdoBooking-kategoria
2. Ota haluamasi toiminnot käyttöön valintakytkimillä
3. Mukauta toiminnon nimikettä (käyttäjille näytettävä teksti toiminnon ollessa käynnissä) ja ohjeita tarpeen mukaan
4. Tallenna muutokset napsauttamalla Save

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

Find available apartments -toiminnossa on kaksi lisäsäädintä, jotka määrittävät, kuinka monta huoneistoa chatbot näyttää vieraan kysyessä saatavuutta ja mitkä huoneistot valikoituvat mukaan. Pääset säätimiin avaamalla toiminnon kohdasta Bot Settings > Actions > IdoBooking - find available apartments.

Näytettävien tarjousten määrä

Liukusäädin, jonka arvo on 3-10 (oletusarvo 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ä, kun useimmat vieraat valitsevat vain muutaman suosikin väliltä.
• Suuremmat arvot (8-10) tarjoavat vieraille enemmän vaihtoehtoja vertailtavaksi, mikä on hyödyllistä kohteille, joilla on laajempi valikoima.

Tarjousten valintastrategia

Pudotusvalikko, joka määrittää, mitkä huoneistot valitaan kaikkien saatavilla olevien tulosten luettelosta päivämäärien ja vierasmäärän suodattamisen jälkeen. Valittavissa on neljä vaihtoehtoa:

• Cheapest offers (oletus) - palauttaa huoneistot, joilla on alhaisin vähimmäishinta, lajiteltuna halvimmasta kalleimpaan. Hyvä vaihtoehto silloin, kun vieraat ovat hintatietoisia tai haluat esitellä edullisimmat vaihtoehdot ensin.
• Evenly distributed by price - valitsee huoneistoja tasaisesti koko hintahaarukasta. Esimerkiksi 9 tarjouksen kohdalla tämä antaa karkeasti 3 halvinta, 3 keskihintaista ja 3 kalleinta. Hyödyllinen, kun haluat vieraiden näkevän koko tarjonnan kirjon pelkän edullisimman pään sijaan.
• Most expensive offers - palauttaa korkeimman hintaluokan huoneistot lajiteltuna kalleimmasta halvライフmman suuntaan. Sopii ensiluokkaisille kohteille tai silloin, kun haluat nostaa kärkeen parhaat tilasi.
• Random selection - valitsee huoneistoja satunnaisesti suodatetuista tuloksista. Hyödyllinen, kun haluat vaihdella keskustelujen välillä sitä, mitä huoneistoja nostetaan esiin, ja välttää aina samojen kohteiden suosittelemista.

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

---

Parhaat käytännöt

Turvallisuussuositukset (manuaalinen asennus)

• Käytä erillistä API-käyttäjää - Luo erillinen käyttäjä nimenomaan ChatLab-integraatiota varten henkilökohtaisen ylläpitäjätilisi käyttämisen sijaan
• Vähimmäisoikeudet - Myönnä vain käyttötarkoitukseesi välttämättömät oikeudet. Käytä vain luku -oikeuksia, jos chatbotin tarvitsee vain hakea tietoja
• Säännöllinen tunnusten vaihtaminen - Päivitä API-käyttäjän salasana säännöllisesti ja päivitä uudet tunnukset sen jälkeen ChatLabiin

Chatbotin vastausten optimointi

• Kouluta bottisi kiinteistötiedoilla - Lisää majoitustilojesi kuvaukset tietopohjaan, mukaan lukien mukavuudet, huoneiden ominaisuudet ja sijaintitiedot
• Määritä selkeät keskustelupolun kulut - Määritä tervetuloviestejä, 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 - Varmista, että "Active API access" on otettu käyttöön käyttäjälle IdoBookingissa
• "Access denied" -virheet - 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-osoitteesi ja erota siitä vain aliverkkotunnusosa (esim. client3760 osoitteesta https://client3760.idosell.com)

---