Hjälpcenter
Chatbot-integrationer

Integrering med Hostfully

Senast uppdaterad:

Hostfully är en fastighetsförvaltningsplattform för semesterbostäder och uthyrningsbyråer för korttidsboende. Genom att koppla den till ChatLab kan din chattbot svara på frågor om dina boenden, datum och priser direkt från dina realtidsdata i Hostfully, slå upp en gästs bokning och vidarebefordra bokningsförfrågningar till ditt team, i stället för att svara utifrån statisk text som du måste hålla uppdaterad.

Observera: Hostfully kräver motsvarande integrationsfunktion. Om den inte ingår i din plan visas en kort notis med en länk för att kontakta oss i stället för anslutningsformuläret när du öppnar Hostfully-rutan.

Exempelkonversation

Se det i en 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.

Exempel från ChatLabExempelkonversation

Besökare: Ett rum för två vuxna, 14-16 augusti.

Spela upp exemplet eller läs det nedan. Inga riktiga kunduppgifter används.
1 / 6

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
  1. Samla in önskemål för vistelsen.

    Besökare: Ett rum för två vuxna, 14-16 augusti.

  2. Fråga efter saknade datumuppgifter före sökningen.

    Assistent: Vilket år vill du boka för?

  3. Gästen anger året.

    Besökare: 2027.

  4. Gör en förfrågan till det anslutna boendesystemet.

    Kontrollerar rumstillgänglighet...

  5. Presentera erbjudandena som returnerades för vistelsen.

    Dubbelrum med havsutsikt, €280 / stay. Exempelerbjudande för två vuxna, två nätter.

  6. 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 visar gästens upplevelse. Vilka åtgärder som är tillgängliga och vilken information som returneras beror på denna integration och dina inställningar.

Vad integrationen erbjuder

När den är ansluten får chattbotten fem Hostfully-åtgärder. En separat åtgärd för AI room search är tillgänglig när chattbotten har motsvarande rumssökkapacitet.

Hostfully - get properties - listar din byrås boenden. För varje boende kan chattbotten visa namn, beskrivning, foto, maximalt antal gäster och länken till boendets sida i Hostfully. Beskrivningar hämtas på det innehållsspråk du väljer vid anslutningen.

Hostfully - find available properties - gästen anger ett datumintervall och antal gäster, och chattbotten returnerar de boenden som är lediga för dessa datum, tillsammans med priset för vistelsen och en bokningslänk för varje boende.

Hostfully - check availability - gästen frågar om ett specifikt boende. Chattbotten kontrollerar boendets kalender för de efterfrågade datumen, returnerar om det är ledigt, vilka datum som är upptagna om det inte är det, samt priset för det angivna antalet gäster och en bokningslänk.

Hostfully - get reservation status - en gäst som redan har bokat anger bokningsreferensen, och chattbotten läser av status, boende, gästens namn samt in- och utcheckningsdatum från Hostfully.

Hostfully - create booking request - chattbotten samlar in boende, datum, antal vuxna och barn samt gästens namn, e-postadress och telefonnummer, bekräftar dessa med gästen och skapar ett nytt lead i ditt Hostfully-konto. Gästen får ett referensnummer och ditt team tar över ärendet därifrån i Hostfully.

Datum förstås utifrån naturligt språk, så en gäst kan skriva "nästa helg" eller "12-15 juni" i stället för ett strikt datumformat.

Innan du börjar

Du behöver en chattbot att ansluta integrationen till. Om du inte har skapat någon ännu följer du först Hur du skapar din första ChatLab-chattbot.

Hämta sedan två värden från Hostfully. Båda finns på samma sida: logga in på Hostfully, klicka på ditt företagsnamn i huvudmenyn och välj Agency Settings.

  1. API Key - i avsnittet API Key på sidan Agency Settings. API-åtkomst är en funktion i Hostfully-kontot; om avsnittet saknas på ditt konto ber du Hostfullys support att aktivera det. Se Hostfully API authentication.
  2. Agency UID - längst ner på sidan Agency Settings.

Förbered eventuellt ett tredje värde:

  1. Booking URL format - adressen till din egen bokningssida, med platshållare som ChatLab fyller i för varje svar:

    • {web_link} - länken till boendets sida i Hostfully
    • {property_uid} - Hostfully-ID för boendet
    • {date_from} - incheckningsdatum
    • {date_to} - utcheckningsdatum
    • {guests} - antal gäster

    Till exempel:

    {web_link}?checkIn={date_from}&checkOut={date_to}&guests={guests}
    

    Om du lämnar detta fält tomt svarar chattbotten fortfarande på frågor om tillgänglighet och priser, och använder länken till boendets sida i Hostfully utan datum.

Steg 1: Anslut Hostfully

  1. Välj din chattbot och gå till fliken Connect (Anslut).
  2. Klicka på Connect (Anslut) på rutan Hostfully.

Fliken Connect med integrationsrutan för Hostfully markerad

  1. Klistra in din API Key och ditt Agency UID, välj Default content language (Standardspråk för innehåll) och fyll eventuellt i Booking URL format.

Formuläret för Hostfully-integration med fälten API Key, Agency UID, Default content language och Booking URL format

  1. Klicka på Connect (Anslut).

ChatLab sparar inställningarna och kör omedelbart ett testanrop som listar din byrås boenden. Om API-nyckeln eller Agency UID är felaktigt stängs integrationen av igen och felet visas i formuläret, så att en felaktig anslutning aldrig lämnas halvvägs aktiverad. När anslutningen lyckas läser ChatLab in dina boenden med tillhörande beskrivningar och foton i sin egen cache, så att framtida svar går snabbt.

Default content language avgör vilket språk ChatLab läser in boendenamn och beskrivningar på när Hostfully har dem på flera språk. Engelska, polska, tyska, spanska, franska och italienska är tillgängliga; standard är engelska.

Steg 2: Granska Hostfully-åtgärderna

När anslutningen är klar aktiveras fyra åtgärder automatiskt: get properties, check availability, find available properties och get reservation status. Create booking request förblir avstängd eftersom den sparar ett nytt lead i ditt Hostfully-konto; aktivera den när du vill att gäster ska kunna skicka bokningsförfrågningar direkt från chatten.

För att granska eller justera åtgärderna går du till Settings > Actions (Inställningar > Åtgärder) och tittar i gruppen Hostfully Actions. Du kan också klicka på Hostfully i panelen Filter by Platform (Filtrera efter plattform) till höger för att visa enbart denna grupp:

  • Hostfully - get properties - standardetikett för åtgärden: "Getting properties..."
  • Hostfully - check availability - standardetikett för åtgärden: "Checking availability..."
  • Hostfully - find available properties - standardetikett för åtgärden: "Searching available properties..."
  • Hostfully - get reservation status - standardetikett för åtgärden: "Checking reservation..."
  • Hostfully - create booking request - standardetikett för åtgärden: "Submitting request..."

Gruppen Hostfully Actions i Settings > Actions innan integrationen har anslutits

Skärmbilden ovan visar gruppen innan integrationen är ansluten: åtgärderna och den valfria funktionen för AI room search listas, men är märkta som Not connected och otillgängliga för chattbotten. AI room search beror på rumskapacitet och automatisk katalogindexering; det garanteras inte att den aktiveras vid varje anslutning. När AI room search är aktiverat tar den över sökningen av boenden och den vanliga åtgärden get properties kliver åt sidan.

För varje åtgärd kan du redigera:

  • Action Label - det korta meddelandet som gästen ser i chatten medan åtgärden körs.
  • Instructions - vad åtgärden gör, vilket AI:n använder för att avgöra när den ska anropas.
  • User Instructions - dina egna regler utöver detta, till exempel att fråga efter antal gäster före sökning, eller att nämna er minsta vistelsetid.

Du kan också stänga av en enskild åtgärd om du inte vill använda den. Du kan till exempel låta tillgänglighet och priser vara aktiverade men stänga av bokningsuppslag.

Åtgärden find available properties har också en inställning för antal resultat: 1-10 boenden, med standardvärdet 5. Den begränsar den returnerade listan, så ett svar är inte nödvändigtvis en fullständig lista över varje ledigt boende.

Steg 3: Testa den

Öppna Overview (Översikt), starta en ny testkonversation och prova frågor som motsvarar varje åtgärd:

  • "Vilka lägenheter har ni?" - utlöser Hostfully - get properties
  • "Vad är ledigt 12-15 juni nästa år för 2 vuxna?" - utlöser Hostfully - find available properties
  • "Är Seaside Loft ledigt nästa helg?" - utlöser Hostfully - check availability
  • "Vad är statusen för min bokning ABC123?" - utlöser Hostfully - get reservation status
  • "Jag vill boka Seaside Loft för dessa datum" - utlöser Hostfully - create booking request, om du har aktiverat den

Kontrollera att boendenamn och priser stämmer överens med dina data i Hostfully, att bokningslänkar öppnar din bokningssida med datumen redan ifyllda och att en testbokningsförfrågan dyker upp som ett nytt lead i Hostfully.

Hantera integrationen

Uppdatera inställningar - öppna rutan Hostfully under fliken Connect, ändra API-nyckel, Agency UID, innehållsspråk eller Booking URL format och klicka på Update Chatbot (Uppdatera chattbot). ChatLab kör testanropet igen och uppdaterar sin boendecache.

Koppla från - öppna rutan Hostfully och klicka på Disconnect (Koppla från). Hostfully-åtgärderna slutar vara tillgängliga för chattbotten och cachade boendedata raderas. Dina inställningar finns kvar i formuläret, så att ansluta igen senare kräver bara ett klick.

Tips

  • Fortsätt att träna din bot på webbplatsens innehåll. Hostfully-åtgärderna täcker boenden, datum och priser; allt annat som en gäst frågar om (incheckningstider, parkering, husregler, husdjur) hämtas från din kunskapsbas. Se Träna din chattbot - grunder och begränsningar.
  • Lägg in bokningsregler såsom minsta vistelsetid eller depositionspolicy i åtgärdens användarinstruktioner (User Instructions), så att chattbotten nämner dem tillsammans med tillgängligheten i stället för att gästen behöver ta reda på det senare.
  • Lägg till förslagsfrågor som "Kontrollera tillgänglighet" eller "Visa lägenheter" så att gästerna upptäcker vad chattbotten kan göra.
  • En bokningsförfrågan skapas i Hostfully först efter att chattbotten har fått gästens namn, e-postadress och telefonnummer och gästen har bekräftat uppgifterna. Om du även använder ett formulär för lead-insamling bör du hålla de två samstämda så att gästerna inte tillfrågas om samma uppgifter två gånger. Se Insamling av leads.
  • Varje svar som anropar en Hostfully-åtgärd förbrukar meddelandekrediter precis som alla andra chattsvar. Se Vad är en meddelandekredit.

Relaterade artiklar

Rumskatalog och hotellöversikt

Om ditt konto visar fliken Hotel använder du Hotel > Rooms för att granska rumskatalogen och träningsstatusen. AI room search är skild från datumbaserade tillgänglighetskontroller: den matchar boendebeskrivningar, medan tillgänglighetsåtgärder kontrollerar en efterfrågad vistelse. Automatisk boendeindexering beror på automatisk katalogindexering och tilldelad rumskapacitet; använd annars Train rooms (Träna rum) när det är tillgängligt. Granska de aktiverade åtgärderna och vänta tills träningen har slutförts innan du förlitar dig på AI room search.