Koppla ihop din ChatLab-chattbot med ditt IdoBooking-bokningssystem för att ge dina webbplatsbesökare tillgång till tillgänglighetsinformation och bokningshjälp i realtid.
Exempel på konversation
Från resedatum till rumserbjudanden
Kräver en boendeintegration som stöds och en aktiverad tillgänglighetsåtgärd. Ett erbjudande eller en förfrågan bekräftar inte en bokning.
Besökare: Ett rum för två vuxna, 14-16 augusti.
Spela upp exemplet eller läs det nedan. Inga riktiga kunduppgifter används.Samla in önskemål för vistelsen.
Uppspelningen pausas när exemplet inte längre visas på skärmen. Detta är en simulering, inte en livechatt. Widgetens kontroller i uppspelningen är inte interaktiva.Läs hela exemplet
- Samla in önskemål för vistelsen.
Besökare: Ett rum för två vuxna, 14-16 augusti.
- Fråga efter saknade datumuppgifter före sökningen.
Assistent: Vilket år vill du boka för?
- Gästen anger året.
Besökare: 2027.
- Gör en förfrågan till det anslutna boendesystemet.
Kontrollerar rumstillgänglighet...
- Presentera erbjudandena som returnerades för vistelsen.
Dubbelrum med havsutsikt, €280 / stay. Exempelerbjudande för två vuxna, två nätter.
- Fortsätt med bokningsvägen som stöds av din integration.
Assistent: Se bokningssidan för slutgiltigt pris och villkor. Ingen reservation har gjorts i denna demonstration.
Exemplet illustrerar kundupplevelsen. Tillgängliga åtgärder och returnerad information beror på denna integration och din konfiguration.
Innan du börjar
Skapa eller välj en chattbot först. Du behöver behörighet att hantera dess integrationer och åtkomst till det externa kontots anslutningsinställningar. Om Connect-rutan visar en uppmaning om uppgradering eller kontakt kontrollerar du att din prenumeration inkluderar denna integration. Håll API-uppgifterna hemliga; klistra aldrig in dem i webbplatsens inbäddningskod.
Vad integrationen ger
När IdoBooking-integrationen är aktiverad kan din chattbot:
- Visa en lista över tillgängliga lägenheter och boenden med beskrivningar och foton
- Kontrollera tillgänglighet för specifika datum
- Hitta tillgängliga lägenheter för ett visst datumintervall med priser
- Söka efter befintliga bokningar efter ID, status eller datumintervall
- Skapa nya bokningar med gästuppgifter
Det finns två sätt att konfigurera integrationen - via IdoBooking Marketplace (rekommenderas) eller manuellt via ChatLabs adminpanel.
Alternativ A: Konfiguration via IdoBooking Marketplace (rekommenderas)
Det snabbaste sättet att ansluta ChatLab till IdoBooking är via IdoBooking Marketplace. Denna metod hanterar API-uppgifterna automatiskt och aktiverar läsåtgärder för din chattbot.
Steg 1: Installera ChatLab från IdoBooking Marketplace
- Logga in på din administrationspanel i IdoBooking
- Gå till avsnittet Marketplace
- Leta upp ChatLab och klicka på Install (Installera)
IdoBooking skickar dina API-uppgifter till ChatLab automatiskt - du behöver inte skapa en separat API-användare eller kopiera inloggningsuppgifter manuellt.
Steg 2: Skapa eller logga in på ditt ChatLab-konto
När du har aktiverat ChatLab på marknadsplatsen omdirigeras du till en guidad installationsguide. Om du redan har ett ChatLab-konto loggar du in. Annars skapar du ett nytt konto.
Steg 3: Välj en prenumerationsplan
Välj en prenumerationsplan som passar dina behov. Funktionerna för IdoBookings bokningsintegration (lägenhetssökning, tillgänglighetskontroll, bokningar) kräver IdoBooking-integrationsfunktionen. Om din prenumeration inte inkluderar den följer du uppmaningen om uppgradering eller kontakt.
Steg 4: Välj en chattbot
Välj en befintlig chattbot som ska anslutas till IdoBooking, eller skapa en ny. Guiden kan skapa en ny bot åt dig automatiskt.
Steg 5: Slutför installationen
Guiden utför följande steg automatiskt:
- Kopplar dina IdoBooking-uppgifter till den valda chattbotten
- Aktiverar lägenhetssökning, tillgänglighetskontroller och bokningssökning. Att skapa bokningar aktiveras inte automatiskt.
- Omdirigerar dig tillbaka till IdoBooking eller till ChatLabs adminpanel
När guiden är klar kan din chattbot hantera bokningsförfrågningar direkt. Du kan finjustera enskilda AI-åtgärder i Settings > Actions (Inställningar > Åtgärder).
Alternativ B: Manuell konfiguration
Om du föredrar att konfigurera integrationen manuellt följer du dessa steg.
Del 1: Skapa en API-användare i IdoBooking
Innan du ansluter ChatLab till ditt IdoBooking-system måste du skapa en dedikerad användare med API-åtkomst i din IdoBooking-panel.
Steg 1: Gå till användarhanteringen
- Logga in på din administrationspanel i IdoBooking
- Gå till Settings > Users (Inställningar > Användare)
- Klicka på Add new user (Lägg till ny användare)
Steg 2: Skapa användarkonto
- Ange ett login name (användarnamn) för den nya användaren (t.ex. "chatlab-api")
- Fyll i återstående obligatoriska uppgifter
- Välj ett säkert password (lösenord) för detta konto
Steg 3: Konfigurera API-åtkomst
Konfigurera följande åtkomstinställningar för den nya användaren:
- Aktivera "Active API access" - detta krävs för att integrationen ska fungera
- Inaktivera "Active panel access" - användaren behöver inte åtkomst till adminpanelen
Steg 4: Ange användarroll och behörigheter
Du har två alternativ när du konfigurerar användarrollen:
Alternativ A: Administratörsroll (enklare)
- Välj Administrator (Administratör) som roll
- Detta ger breda API-behörigheter även om panelåtkomsten är inaktiverad. Använd en anpassad roll om integrationen endast behöver utvalda läsåtgärder.
Alternativ B: Anpassad användarroll (mer detaljerad)
Om du föredrar mer detaljerad kontroll väljer du Custom user (Anpassad användare) och konfigurerar följande modulbehörigheter:
- Reservations (Bokningar) - Read-only (Skrivskyddad, om chattbotten endast ska hämta bokningsinformation) eller Full access (Full åtkomst, om chattbotten ska skapa bokningar)
- Customers (Kunder) - Read-only (Skrivskyddad)
- Offers (Erbjudanden) - Read-only (Skrivskyddad)
För anpassade användare behöver du även konfigurera platsspecifika behörigheter:
- Bläddra till avsnittet Location and accommodation permissions (Plats- och boendebehörigheter)
- Välj de fastigheter som chattbotten ska täcka; ge endast åtkomst till alla om det är ditt avsiktliga omfång.
Steg 5: Inaktivera onödiga aviseringar
För att förhindra att API-användaren tar emot operativa aviseringar inaktiverar du följande alternativ:
- Notifications for property staff (Aviseringar för boendepersonal) - Inaktivera
- Automatic email notifications (Automatiska e-postaviseringar) - Inaktivera
Steg 6: Spara och samla in anslutningsuppgifter
- Klicka på Save (Spara) för att skapa användarkontot
- Anteckna följande information - du behöver den för konfigurationen i ChatLab:
- Login - Det användarnamn du skapade (t.ex. chatlab-api)
- Password - Lösenordet du angav
- Subdomain - Din IdoBooking-underdomän (t.ex. client3760)
Hitta din underdomän: Titta på webbadressen till din IdoBooking-panel. Om din URL till exempel är https://client3760.idosell.com är din underdomän client3760.
Del 2: Konfigurera integrationen i ChatLab
Steg 1: Gå till fliken Connect
- Logga in på din ChatLab-adminpanel
- Välj den bot du vill konfigurera
- Gå till fliken Connect (Anslut)
- Leta upp och klicka på IdoBooking i listan över integrationer
Steg 2: Ange anslutningsuppgifter
Fyll i anslutningsformuläret med den information du samlade in från IdoBooking:
- Client Subdomain - Ange din IdoBooking-underdomän (utan hela URL:en). Exempel:
client3760(intehttps://client3760.idosell.com) - System Login - Ange användarnamnet för API-användaren du skapade i IdoBooking
- System Password - Ange lösenordet för API-användaren
- Default Currency - Välj valuta för prisinformation
- Default Language - Välj språk för boendebeskrivningar
Steg 3: Anslut
- När du har fyllt i alla obligatoriska fält blir knappen Connect (Anslut) aktiv
- Klicka på Connect för att upprätta anslutningen
- Vänta på bekräftelsemeddelandet
- När anslutningen är klar visas ett framgångsmeddelande
Efter en lyckad anslutning ändras knappen från "Connect" till "Update Chatbot", och knappen "Disconnect" visas om du behöver inaktivera integrationen senare.
Konfigurera AI-åtgärder
När din IdoBooking-integration är ansluten (oavsett metod) kan du konfigurera vilka AI-åtgärder din chattbot ska kunna utföra. Granska de aktiva åtgärderna efter genomförd konfiguration. Att skapa bokningar aktiveras inte automatiskt.
Tillgängliga AI-åtgärder
- Get Apartments - Visar tillgängliga lägenheter och boenden med beskrivningar, sängkonfigurationer och foton
- Find Available Apartments - Söker efter tillgängliga lägenheter för ett givet datumintervall med prisinformation
- Check Apartment Availability - Kontrollerar tillgänglighet för en specifik lägenhet och ett visst datumintervall
- Get Reservations - Söker efter befintliga bokningar efter ID, status eller datumintervall
- Create Reservation - Skapar nya bokningar med gästuppgifter och bokningsinformation
- AI room search - Matchar en gästs önskemål mot dina rumsbeskrivningar i stället för att kontrollera specifika datum
AI room search och Get Apartments är alternativ till varandra, inte tillägg. När AI room search är aktiverat ersätter det det vanliga listningsverktyget och Get Apartments tas bort från chattbotten, så att endast ett rumslistningsverktyg är aktivt åt gången. De datumbaserade åtgärderna påverkas inte.
Aktivera och anpassa åtgärder
- Efter anslutningen klickar du på Configure AI Actions (Konfigurera AI-åtgärder) i bekräftelserutan, eller går till Settings > Actions och letar upp kategorin IdoBooking
- Aktivera eller inaktivera de åtgärder du vill använda
- Anpassa åtgärdsetiketten (texten som visas för användare medan åtgärden körs) och instruktionerna efter behov
- Klicka på Enable (Aktivera) för en ny åtgärd eller Update (Uppdatera) för en befintlig åtgärd i åtgärdsfönstret.
Konfigurera "Find available apartments"
Åtgärden Find available apartments har två extra reglage som styr hur många lägenheter chattbotten visar när en gäst frågar om tillgänglighet, samt vilka lägenheter som väljs ut. Öppna åtgärden från Settings > Actions > IdoBooking - find available apartments för att komma åt dem.
Number of offers to show (Antal erbjudanden som ska visas)
Ett skjutreglage från 3 till 10 (standardvärde 6). Det styr hur många lägenheter chattbotten returnerar till användaren i ett och samma svar.
- Lägre värden (3-4) håller svaret kort och fokuserat, vilket är praktiskt när de flesta gäster väljer mellan ett fåtal favoriter.
- Högre värden (8-10) ger gästerna fler alternativ att jämföra, vilket passar boenden med ett bredare utbud.
Offer selection strategy (Strategi för urval av erbjudanden)
En rullgardinsmeny som avgör vilka lägenheter som väljs ut från den fullständiga listan över tillgängliga resultat efter filtrering på datum och antal gäster. Fyra alternativ finns tillgängliga:
- Cheapest offers (standard) - returnerar lägenheterna med lägst minimipris, sorterade från billigast till dyrast. Bra när gäster är prismedvetna eller om du vill lyfta fram de mest prisvärda alternativen först.
- Evenly distributed by price - väljer lägenheter jämnt fördelade över prisintervallet. Med 9 erbjudanden ger detta till exempel ungefär 3 billigast, 3 i mellanprisklassen och 3 dyrast. Praktiskt när du vill att gästerna ska se hela utbudet i stället för bara budgetalternativen.
- Most expensive offers - returnerar lägenheterna med högst pris, sorterade från dyrast till billigast. Passar premiumanläggningar eller när du vill framhäva dina mest exklusiva boenden.
- Random selection - väljer lägenheter slumpmässigt bland de filtrerade resultaten. Användbart när du vill variera vilka lägenheter som lyfts fram i olika konversationer och undvika att alltid rekommendera samma alternativ.
Båda inställningarna sparas per bot, tillsammans med den befintliga anpassade prompten och åtgärdsetiketten.
Testa den färdiga konfigurationen
Öppna Overview (Översikt) och starta en ny testkonversation. Fråga efter rum för ett framtida datumintervall och ett specifikt antal gäster, öppna sedan den returnerade bokningslänken och jämför datum, valuta och pris med IdoBooking. Testa bokningssökning med en bokning som du har behörighet att granska. Aktivera och testa endast Create Reservation om du faktiskt avser att skapa en riktig bokning; ett chattest kan skriva data direkt till ditt bokningssystem.
Bästa praxis
Säkerhetsrekommendationer (manuell konfiguration)
- Använd en dedikerad API-användare - Skapa en separat användare specifikt för ChatLab-integrationen i stället för att använda ditt personliga administratörskonto
- Minimala behörigheter - Ge endast de behörigheter som är nödvändiga för ditt användningsområde. Använd skrivskyddad åtkomst om chattbotten endast behöver hämta information
- Regelbunden rotation av inloggningsuppgifter - Uppdatera API-användarens lösenord med jämna mellanrum och uppdatera sedan uppgifterna i ChatLab
Optimera chattbottens svar
- Träna din bot med boendeinformation - Lägg till beskrivningar av dina boenden i kunskapsbasen, inklusive bekvämligheter, rumsdetaljer och information om läget
- Skapa tydliga konversationsflöden - Konfigurera välkomstmeddelanden som vägleder användarna att fråga om tillgänglighet, och använd föreslagna frågor som "Kontrollera tillgänglighet" eller "Visa rum"
Felsökning
- Anslutningen misslyckas - Kontrollera att "Active API access" är aktiverat för användaren i IdoBooking
- Felmeddelandet "Access denied" - Kontrollera att användaren har rätt modulbehörigheter
- Inga data returneras - Se till att användaren har åtkomst till relevanta platser och boenden
- Felaktig underdomän - Kontrollera din IdoBooking-URL och extrahera endast underdomändelen (t.ex.
client3760frånhttps://client3760.idosell.com)
Rumskatalog och hotellöversikt
Om ditt konto visar fliken Hotel (Hotell) använder du Hotel > Rooms (Hotell > Rum) för att granska rumskatalogen och träningsstatusen. AI room search är skild från datumbaserade tillgänglighetskontroller: den matchar rumsbeskrivningar, medan tillgänglighetsåtgärder kontrollerar en efterfrågad vistelse. Automatisk rumsindexering beror på automatisk katalogindexering och tilldelad rumskapacitet; annars använder du Train rooms (Träna rum) när det är tillgängligt. Granska de aktiverade åtgärderna och vänta tills träningen är klar innan du förlitar dig på AI room search.