> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Hostaway Med [webhook-verktyget](/docs/sv/reception-ai/integrations/webhooks) 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. > **Note** > > 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](/docs/sv/reception-ai/features/notifications). ## 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`: ```bash 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. > **Warning** > > Å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`: ```bash 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`. > **Warning** > > 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](/docs/sv/reception-ai/receptionist/testing) 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. > **Tip** > > Lägg till en [procedur](/docs/sv/reception-ai/receptionist/rules-and-procedures) 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. |