Hostaway | ElevenLabs Documentation

Med webhook-verktyget nedan kan din receptionist kontrollera kalendern för en Hostaway-annons på de datum en uppringare frågar om och berätta om stugan eller boendet är ledigt, nattpriset och minsta vistelsetid. Hostaways offentliga API utfärdar en åtkomsttoken som gäller i 24 månader, så verktyget anropar Hostaway direkt.

Din receptionist kan inte skapa reservationer eller söka upp befintliga reservationer. Den kontrollerar kalendern och tar emot bokningsförfrågan, och ditt team bekräftar vistelsen från sammanfattningen efter samtalet.

Innan du börjar

Skapa en API-nyckel

Öppna Settings → Hostaway API i Hostaways kontrollpanel och skapa en ny API-nyckel. Döp den till Reception.ai och välj Hostaway Public API som partner. Kopiera nyckeln: Hostaway visar den bara en gång. Notera ditt Account ID, som också visas i Settings.

Hämta en åtkomsttoken

Byt nyckeln mot en åtkomsttoken i en terminal genom att ersätta ACCOUNT_ID och API_KEY:

curl -X POST 'https://api.hostaway.com/v1/accessTokens' \
  -H 'Content-type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials&client_id=ACCOUNT_ID&client_secret=API_KEY&scope=general'

Kopiera värdet för access_token från svaret. Det är giltigt i 24 månader.

Åtkomsttokenen kan läsa och ändra allt i ditt Hostaway-konto, inklusive gästuppgifter och dörrkoder. Klistra inte in den i delade dokument eller onlineverktyg. Om den läcker ska du återkalla den och ta bort API-nyckeln i Hostaway.

Hitta dina annons-ID:n

Lista dina annonser med tokenen genom att ersätta YOUR_TOKEN:

curl 'https://api.hostaway.com/v1/listings?limit=100' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Varje annons i svaret har ett id och ett name. Notera ID:t för varje annons som din receptionist ska kontrollera.

Skapa verktyget

Gå till Integrations, välj Add integration och välj Webhook Tool.

Fält	Värde
Namn	`check_hostaway_calendar`
Beskrivning	”Kontrollera om ett av våra boenden är ledigt på uppringarens datum samt nattpriset och minsta vistelsetid. Använd det innan du säger till uppringaren att ett boende är tillgängligt.”
Metod	GET
URL	`https://api.hostaway.com/v1/listings/{listing_id}/calendar`
Begärandehuvuden	`Authorization`: `Bearer` följt av din åtkomsttoken, med Type inställt på Secret
Sökvägsparametrar	`listing_id` (sträng, obligatoriskt): “Använd `11111` för Cedar Cabin och `22222` för Lakeside Cabin.”
Frågeparametrar	`startDate` (sträng, obligatoriskt): “Ankomstdatumet i formatet ÅÅÅÅ-MM-DD.” `endDate` (sträng, obligatoriskt): “Den sista natten av vistelsen i formatet ÅÅÅÅ-MM-DD.” `includeResources` (sträng, fast värde): `0`
Tilldela till agenter	Receptionist

Ersätt stugnamnen och ID:na med dina egna och lägg till en rad per annons. Välj Enable.

Hostaway returnerar en post per natt. En natt är ledig när status är available. Varje natt har också sitt price och minimumStay.

Håll includeResources fast på 0. Med 1 lägger Hostaway till reservationerna för varje natt, inklusive gästnamn, telefonnummer och e-postadresser, i det din receptionist ser.

Testa

Testa din receptionist genom att fråga om en stuga på datum som du vet är bokade och sedan på datum som du vet är lediga. Jämför svaren med din Hostaway-kalender.

Lägg till en procedur för vistelseförfrågningar: be om boendet, ankomst- och avresedatum samt antal gäster, kontrollera kalendern och ta sedan emot uppringarens namn, telefonnummer och e-postadress för ditt team. Lägg till en regel om att din receptionist aldrig lovar att en vistelse är bokad.

Begränsningar

Din receptionist kan inte skapa, ändra eller avboka reservationer. Ditt team bekräftar varje vistelse.
Den kontrollerar en annons i taget. För att föreslå en annan stuga kontrollerar den var och en i tur och ordning.
Nattpriser inkluderar inte städavgifter, skatter eller rabatter, så din receptionist bör bara ange dem som vägledning.
Verktyget söker inte upp befintliga reservationer. Hostaways reservations- och annonsregister innehåller dörrkoder och Wi-Fi-lösenord, så den här guiden visar dem inte för din receptionist. Zapiers Hostaway-app returnerar samma register och har inga åtgärder för bokning eller tillgänglighet.
Din åtkomsttoken slutar fungera efter 24 månader. Skapa en ny och uppdatera huvudet innan dess.

Felsökning

Problem	Kontrollera
401 eller 403 från Hostaway	Huvudvärdet måste vara `Bearer`, ett mellanslag och åtkomsttokenen, inte API-nyckeln. Kontrollera att den inte har gått ut.
Fel stuga kontrolleras	Kontrollera att annons-ID:na i beskrivningen för `listing_id` stämmer med dina annonser.
En bokad natt visas som ledig	Kontrollera kalendern i Hostaway. Blockerade och reserverade nätter har ett annat `status` än `available`.
Receptionisten erbjuder en för kort vistelse	Säg till den i verktygsbeskrivningen att kontrollera `minimumStay` för ankomstnatten.