Anslut din ChatLab-chattbot till ditt bokningssystem IdoBooking för att ge dina webbplatsbesökare tillgänglighetsinformation i realtid och bokningshjälp.
Vad integrationen erbjuder
När IdoBooking-integrationen är aktiverad kan din chattbot:
- Visa tillgängliga lägenheter och boenden med beskrivningar och foton
- Kontrollera tillgänglighet för specifika datum
- Hitta lediga lägenheter för ett visst datumintervall tillsammans med priser
- Söka efter befintliga bokningar utifrån ID, status eller datumintervall
- Skapa nya bokningar med gästuppgifter
Det finns två sätt att konfigurera den här integrationen - via IdoBooking Marketplace (rekommenderas) eller manuellt via ChatLabs administratörspanel.
Alternativ A: Konfiguration via IdoBooking Marketplace (rekommenderas)
Det snabbaste sättet att ansluta ChatLab till IdoBooking är via IdoBooking Marketplace. Den här metoden hanterar API-uppgifter automatiskt och aktiverar alla AI-åtgärder för din chattbot.
Steg 1: Installera ChatLab från IdoBooking Marketplace
- Logga in på din administrationspanel i IdoBooking
- Gå till sektionen 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 IdoBooking-bokningsintegrationen (lägenhetssökning, tillgänglighetskontroll, bokningar) kräver en STANDARD- eller PREMIUM-plan.
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 konfigurationen
Guiden utför följande steg automatiskt:
- Kopplar dina IdoBooking-uppgifter till den valda chattbotten
- Aktiverar alla tillgängliga AI-åtgärder (lägenhetssökning, tillgänglighetskontroller, bokningar)
- Omdirigerar dig tillbaka till IdoBooking eller till ChatLabs administratörspanel
När du har slutfört guiden är din chattbot redo att hantera bokningsförfrågningar. Du kan finjustera enskilda AI-åtgärder under Bot Settings > Actions (Botinstä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 behöver du skapa en dedikerad användare med API-åtkomst i din IdoBooking-panel.
Steg 1: Navigera 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 (inloggningsnamn) för den nya användaren (t.ex. "chatlab-api")
- Fyll i övrig obligatorisk information
- Ange ett säkert password (lösenord) för kontot
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 ha tillgång till administrationspanelen
Steg 4: Ange användarroll och behörigheter
Du har två alternativ för att konfigurera användarrollen:
Alternativ A: Administratörsroll (enklare)
- Välj Administrator som roll
- Eftersom användaren inte har tillgång till panelen är detta ett säkert alternativ som ger fullständiga API-behörigheter
Alternativ B: Anpassad användarroll (mer detaljerad)
Om du föredrar mer detaljerad kontroll väljer du Custom user och konfigurerar följande modulbehörigheter:
- Reservations - Skrivskydd (Read-only om chattbotten endast ska hämta bokningsinformation) eller Full åtkomst (Full access om chattbotten ska skapa bokningar)
- Customers - Skrivskydd (Read-only)
- Offers - Skrivskydd (Read-only)
För anpassade användare behöver du även konfigurera platsbehörigheter:
- Bläddra till sektionen Location and accommodation permissions
- Vi rekommenderar att du väljer Select all för att ge åtkomst till alla anläggningar
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 - Inaktivera
- Automatic email notifications - 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 - Användarnamnet du skapade (t.ex. chatlab-api)
- Password - Lösenordet du angav
- Subdomain - Din underdomän i IdoBooking (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änclient3760.
Del 2: Konfigurera integrationen i ChatLab
Steg 1: Navigera till fliken Connect
- Logga in på ChatLabs administratörspanel
- Välj den bot du vill konfigurera
- Gå till fliken Connect (Anslut)
- Leta upp och klicka på IdoBooking i integrationslistan
Steg 2: Ange anslutningsuppgifter
Fyll i anslutningsformuläret med uppgifterna du samlade in från IdoBooking:
- Client Subdomain - Ange din IdoBooking-underdomän (utan hela webbadressen). 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 prisinformationen
- Default Language - Välj språk för boendebeskrivningarna
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 bekräftelsemeddelande
Efter att anslutningen har lyckats ändras knappen från "Connect" till "Update Chatbot", och en "Disconnect"-knapp 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. Om du använde marknadsplatskonfigurationen är alla åtgärder aktiverade som standard.
Tillgängliga AI-åtgärder
- Get Apartments - Visar lediga lägenheter och boenden med beskrivningar, sängkonfigurationer och foton
- Find Available Apartments - Söker efter lediga lägenheter för ett visst datumintervall med prisinformation
- Check Apartment Availability - Kontrollerar tillgängligheten för en specifik lägenhet och ett visst datumintervall
- Get Reservations - Söker efter befintliga bokningar utifrån ID, status eller datumintervall
- Create Reservation - Skapar nya bokningar med gästuppgifter och bokningsinformation
Aktivera och anpassa åtgärder
- Efter anslutningen klickar du på Configure AI Actions i framgångsmodalen, eller navigerar till Bot 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å Save för att spara ändringarna
Konfigurera "Find available apartments"
Åtgärden Find available apartments har två extra kontroller som avgör 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 Bot Settings > Actions > IdoBooking - find available apartments för att komma åt dem.
Antal erbjudanden som ska visas
Ett skjutreglage från 3 till 10 (standard 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 ett bredare urval att jämföra, vilket passar anläggningar med en större katalog.
Urvalsstrategi för erbjudanden
En rullgardinsmeny som bestämmer vilka lägenheter som väljs ut från hela listan över tillgängliga alternativ efter att filtrering på datum och antal gäster har gjorts. Fyra alternativ är tillgängliga:
- Cheapest offers (Billigaste erbjudandena, standard) - returnerar lägenheterna med lägst minimipris, sorterade från billigast till dyrast. Bra när gästerna är prismedvetna eller om du vill lyfta fram de mest tillgängliga alternativen först.
- Evenly distributed by price (Jämnt fördelat efter pris) - väljer lägenheter jämnt fördelade över hela prisintervallet. Med exempelvis 9 erbjudanden ger detta ungefär 3 av de billigaste, 3 i mellanprisklassen och 3 av de dyraste. Praktiskt när du vill att gästerna ska se hela bredden av utbudet snarare än bara budgetsegmentet.
- Most expensive offers (Dyraste erbjudandena) - returnerar de högst prissatta lägenheterna, sorterade från dyrast till billigast. Passar premiumanläggningar eller när du vill framhäva ditt toppsegment.
- Random selection (Slumpmässigt urval) - väljer lägenheter slumpmässigt från de filtrerade resultaten. Användbart om du vill variera vilka lägenheter som lyfts fram mellan olika konversationer och undvika att alltid rekommendera samma.
Båda inställningarna sparas per bot, tillsammans med befintlig anpassad prompt och åtgärdsetikett.
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
- Minsta möjliga behörigheter - Ge endast de behörigheter som krävs för ditt användningsområde. Använd skrivskyddad åtkomst om chattbotten endast behöver hämta information
- Regelbunden uppdatering av inloggningsuppgifter - Byt ut 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ändare att fråga om lediga datum, och använd förslagna 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
- Felet "Access denied" (Åtkomst nekad) - Kontrollera att användaren har rätt modulbehörigheter
- Ingen data returneras - Säkerställ att användaren har åtkomst till relevanta platser och anläggningar
- Felaktig underdomän - Kontrollera din IdoBooking-URL och ta endast med själva underdomänen (t.ex.
client3760frånhttps://client3760.idosell.com)