Hjælpecenter
Chatbot-integrationer

Integration med Hostfully

Sidst opdateret:

Hostfully er en ejendomsadministrationsplatform til ferieboliger og bureauer for korttidsudlejning. Når du forbinder den med ChatLab, kan din chatbot besvare spørgsmål om dine boliger, datoer og priser ud fra dine live Hostfully-data, slå en gæsts reservation op og videresende reservationsforespørgsler til dit team i stedet for at svare ud fra statisk tekst, som du selv skal holde opdateret.

Bemærk: Hostfully kræver den tilsvarende integrationsfunktion. Hvis din plan ikke inkluderer den, viser et klik på Hostfully-feltet en kort besked med et link til at kontakte os i stedet for forbindelsesformularen.

Eksempelsamtale

Se det i en samtale

Fra rejsedatoer til værelsestilbud

Kræver en understøttet overnatningsintegration og en aktiveret tilgængelighedshandling. Et tilbud eller en forespørgsel bekræfter ikke en reservation.

ChatLab-eksempelIllustrativ samtale

Besøgende: Et værelse til to voksne, 14. til 16. august.

Afspil eksemplet, eller læs det nedenfor. Der bruges ingen rigtige kundedata.
1 / 6

Indsaml krav til opholdet.

Afspilningen sættes på pause, når dette eksempel forlader skærmen. Dette er en simulation, ikke en livechat. Widget-knapperne i afspilningen er ikke interaktive.
Læs hele eksemplet
  1. Indsaml krav til opholdet.

    Besøgende: Et værelse til to voksne, 14. til 16. august.

  2. Spørg efter manglende datodetaljer før søgning.

    Assistent: Hvilket år ønsker du at bo her?

  3. Gæsten oplyser året.

    Besøgende: 2027.

  4. Forespørg det tilkoblede overnatningssystem.

    Tjekker ledige værelser...

  5. Vis tilbuddene, der blev fundet for det ophold.

    Dobbeltværelse med havudsigt, €280 / stay. Eksempeltilbud for to voksne, to nætter.

  6. Fortsæt via bookingprocessen, der understøttes af din integration.

    Assistent: Tjek bookingsiden for den endelige pris og betingelser. Der er ikke foretaget en reservation i denne demonstration.

Eksemplet illustrerer gæstens oplevelse. De tilgængelige handlinger og de returnerede oplysninger afhænger af denne integration og din konfiguration.

Hvad integrationen tilbyder

Når forbindelsen er oprettet, får din chatbot fem Hostfully-handlinger. En separat AI room search-handling er tilgængelig, hvis din chatbot har den tilsvarende kapacitet til værelsessøgning.

Hostfully - get properties - viser oversigten over dit bureaus boliger. For hver enkelt kan din chatbot vise navn, beskrivelse, foto, maksimalt antal gæster og linket til boligens Hostfully-side. Beskrivelser hentes på det indholdssprog, du vælger under opsætningen.

Hostfully - find available properties - gæsten angiver et datointerval og antallet af gæster, og din chatbot returnerer de boliger, der er ledige på de pågældende datoer, sammen med prisen for opholdet og et bookinglink til hver bolig.

Hostfully - check availability - gæsten spørger om en specifik bolig. Din chatbot tjekker boligens kalender for de ønskede datoer, oplyser om den er ledig, hvilke datoer der er optaget, hvis den ikke er, samt prisen for det angivne antal gæster plus et bookinglink.

Hostfully - get reservation status - en gæst, der allerede har booket, oplyser reservationsreferencen, og din chatbot aflæser status, bolig, gæstens navn samt indtjeknings- og udtjekningsdatoer fra Hostfully.

Hostfully - create booking request - din chatbot indsamler bolig, datoer, antal voksne og børn samt gæstens navn, e-mailadresse og telefonnummer, bekræfter dem med gæsten og opretter et nyt lead på din Hostfully-konto. Gæsten modtager et referencenummer, og dit team overtager derefter sagen i Hostfully.

Datoer forstås ud fra naturligt sprog, så en gæst kan skrive "næste weekend" eller "12-15 juni" i stedet for et strengt datoformat.

Før du går i gang

Du skal bruge en chatbot, som du kan forbinde integrationen med. Hvis du ikke har oprettet en endnu, kan du starte med at følge How to create your first ChatLab chatbot (Sådan opretter du din første ChatLab-chatbot).

Find derefter to værdier i Hostfully. De findes begge på samme side: Log ind på Hostfully, klik på dit firmanavn i hovednavigationen, og vælg Agency Settings (Bureauindstillinger).

  1. API Key (API-nøgle) - i sektionen API Key på siden Agency Settings. API-adgang er en funktion på din Hostfully-konto; hvis sektionen mangler på din konto, skal du bede Hostfully-support om at aktivere den. Se Hostfully API authentication.
  2. Agency UID (Bureau-UID) - helt nederst på siden Agency Settings.

Forbered eventuelt en tredje værdi:

  1. Booking URL format (Format for booking-URL) - adressen på din egen bookingside med pladsholdere, som ChatLab udfylder for hvert svar:

    • {web_link} - linket til boligens Hostfully-side
    • {property_uid} - boligens identifikator i Hostfully
    • {date_from} - indtjekningsdato
    • {date_to} - udtjekningsdato
    • {guests} - antal gæster

    For eksempel:

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

    Hvis du lader dette felt stå tomt, svarer din chatbot stadig om ledighed og priser, men bruger linket til boligens Hostfully-side uden datoer.

Trin 1: Forbind Hostfully

  1. Vælg din chatbot, og gå til fanen Connect (Forbind).
  2. Klik på Connect (Forbind) på Hostfully-feltet.

Fanen Connect med Hostfully-integrationsfeltet fremhævet

  1. Indsæt din API Key og din Agency UID, vælg Default content language (Standardsprog for indhold), og udfyld eventuelt Booking URL format.

Hostfully-integrationsformular med felterne API Key, Agency UID, Default content language og Booking URL format

  1. Klik på Connect.

ChatLab gemmer indstillingerne og udfører straks et testkald, der viser dit bureaus boliger. Hvis din API-nøgle eller Agency UID er forkert, slås integrationen fra igen, og fejlen vises i formularen, så en defekt forbindelse aldrig efterlades halvt aktiveret. Ved succes indlæser ChatLab dine boliger med beskrivelser og billeder i sin egen cache, så efterfølgende svar leveres hurtigt.

Default content language afgør, hvilket sprog ChatLab henter bolignavne og beskrivelser på, når Hostfully har dem tilgængelige på flere sprog. Engelsk, polsk, tysk, spansk, fransk og italiensk er tilgængelige; standardsproget er engelsk.

Trin 2: Gennemgå Hostfully-handlingerne

Når forbindelsen oprettes, aktiveres fire handlinger automatisk: get properties, check availability, find available properties og get reservation status. Create booking request forbliver deaktiveret, da den opretter et nyt lead på din Hostfully-konto; slå den til, når du ønsker, at gæster skal kunne sende reservationsforespørgsler direkte fra chatten.

Gå til Settings > Actions (Indstillinger > Handlinger) og kig på gruppen Hostfully Actions for at gennemgå eller justere handlingerne. Du kan også klikke på Hostfully i panelet Filter by Platform (Filtrer efter platform) til højre for kun at få vist denne gruppe:

  • Hostfully - get properties - standardetiket: "Getting properties..."
  • Hostfully - check availability - standardetiket: "Checking availability..."
  • Hostfully - find available properties - standardetiket: "Searching available properties..."
  • Hostfully - get reservation status - standardetiket: "Checking reservation..."
  • Hostfully - create booking request - standardetiket: "Submitting request..."

Gruppen Hostfully Actions i Settings > Actions, før integrationen er forbundet

Skærmbilledet ovenfor viser gruppen, før integrationen er forbundet: Handlingerne og den valgfrie AI-værelsessøgning er oplistet, men markeret som Not connected (Ikke forbundet) og utilgængelige for din chatbot. AI room search afhænger af værelseskapacitet og automatisk katalogindeksering; det er ikke garanteret, at den aktiveres ved enhver oprettet forbindelse. Når AI room search er slået til, overtager den visningen af boliger, og den almindelige handling get properties træder i baggrunden.

For hver handling kan du redigere:

  • Action Label (Handlingsetiket) - den korte besked, gæsten ser i chatten, mens handlingen kører.
  • Instructions (Instruktioner) - hvad handlingen gør, hvilket AI'en bruger til at afgøre, hvornår den skal kaldes.
  • User Instructions (Brugerinstruktioner) - dine egne supplerende regler, for eksempel at bede om antallet af gæster før søgning eller at nævne minimumophold.

Du kan også slå en individuel handling fra, hvis du ikke ønsker at bruge den. Du kan for eksempel lade ledighed og priser være aktiveret, men slå reservationsopslag fra.

Handlingen find available properties har desuden en indstilling for antal resultater: 1 til 10 boliger, med 5 som standard. Dette begrænser den returnerede liste, så et svar ikke nødvendigvis er en udtømmende oversigt over samtlige ledige boliger.

Trin 3: Test det

Åbn Overview (Oversigt), start en ny testsamtale, og afprøv spørgsmål, der matcher hver handling:

  • "Hvilke lejligheder har I?" - udløser Hostfully - get properties
  • "Hvad er ledigt fra 12. til 15. juni næste år til 2 voksne?" - udløser Hostfully - find available properties
  • "Er Seaside Loft ledig i næste weekend?" - udløser Hostfully - check availability
  • "Hvad er status på min reservation ABC123?" - udløser Hostfully - get reservation status
  • "Jeg vil gerne booke Seaside Loft på de datoer" - udløser Hostfully - create booking request, hvis du har slået den til

Kontroller, at bolignavne og priser stemmer overens med dine data i Hostfully, at bookinglinks åbner din bookingside med datoerne udfyldt på forhånd, og at en testforespørgsel dukker op som et nyt lead i Hostfully.

Administration af integrationen

Opdatering af indstillinger - åbn Hostfully-feltet under fanen Connect, rediger API-nøglen, Agency UID, indholdssproget eller Booking URL format, og klik på Update Chatbot (Opdater chatbot). ChatLab kører testkaldet igen og opdaterer sin boligcache.

Afbrydelse af forbindelse - åbn Hostfully-feltet, og klik på Disconnect (Afbryd forbindelse). Hostfully-handlingerne er ikke længere tilgængelige for din chatbot, og de cachede boligdata slettes. Dine indstillinger gemmes i formularen, så du senere kan genoprette forbindelsen med et enkelt klik.

Gode råd

  • Bliv ved med at træne din bot på indholdet fra dit website. Hostfully-handlingerne tager sig af boliger, datoer og priser; alt andet, som en gæst måtte spørge om (indtjekningstidspunkter, parkering, husregler, kæledyr), hentes fra din vidensbase. Se Training your chatbot - basics and limits (Træning af din chatbot - grundlæggende principper og grænser).
  • Tilføj bookingregler som for eksempel minimumophold eller depositumvilkår i handlingens brugerinstruktioner, så din chatbot oplyser om dem sammen med ledigheden i stedet for at lade gæsten opdage det senere.
  • Tilføj forslåede spørgsmål som f.eks. "Tjek ledighed" eller "Vis lejligheder", så gæsterne nemt kan se, hvad din chatbot kan hjælpe med.
  • En reservationsforespørgsel oprettes først i Hostfully, når din chatbot har fået gæstens navn, e-mailadresse og telefonnummer, og gæsten har bekræftet oplysningerne. Hvis du også bruger en leadformular, bør du sikre, at de to stemmer overens, så gæster ikke bliver bedt om de samme oplysninger to gange. Se Lead collection (Leadindsamling).
  • Hvert svar, der kalder en Hostfully-handling, forbruger beskedkreditter ligesom ethvert andet chatbotsvar. Se What is a message credit (Hvad er en beskedkredit).

Relaterede artikler

Room Catalog and Hotel Overview

Hvis din konto viser fanen Hotel, kan du bruge Hotel > Rooms til at gennemgå værelseskataloget og træningsstatussen. AI room search er adskilt fra datobaserede ledighedstjek: Den matcher boligbeskrivelser, mens ledighedshandlinger undersøger et specifikt ønsket ophold. Automatisk indeksering af boliger afhænger af automatisk katalogindeksering og tildelt værelseskapacitet; ellers kan du bruge Train rooms (Træn værelser), når funktionen er tilgængelig. Gennemgå de aktiverede handlinger, og vent på, at træningen er færdig, før du forlader dig på AI room search.