> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Hostaway Met de onderstaande [webhooktool](/docs/nl/reception-ai/integrations/webhooks) kan je receptionist de kalender van een Hostaway-accommodatie controleren voor de data waar een beller naar vraagt, en vertellen of de hut of unit beschikbaar is, wat de nachtprijs is en wat het minimumverblijf is. De openbare API van Hostaway geeft een toegangstoken uit dat 24 maanden geldig is, dus de tool roept Hostaway rechtstreeks aan. > **Note** > > Je receptionist kan geen reserveringen maken of bestaande reserveringen opzoeken. Deze controleert de kalender en > neemt het boekingsverzoek aan, waarna je team het verblijf bevestigt vanuit de [samenvatting na het gesprek](/docs/nl/reception-ai/features/notifications). ## Voordat je begint ### Een API-sleutel maken Open in het Hostaway-dashboard **Settings** → **Hostaway API** en maak een nieuwe API-sleutel. Geef deze de naam `Reception.ai` en kies **Hostaway Public API** als partner. Kopieer de sleutel: Hostaway toont deze maar één keer. Noteer ook je **Account ID**, dat eveneens wordt weergegeven in **Settings**. ### Een toegangstoken ophalen Wissel de sleutel in een terminal om voor een toegangstoken, waarbij je `ACCOUNT_ID` en `API_KEY` vervangt: ```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' ``` Kopieer de waarde van `access_token` uit de response. Deze is 24 maanden geldig. > **Warning** > > Het toegangstoken kan alles in je Hostaway-account lezen en wijzigen, inclusief gastgegevens > en deurcodes. Plak het niet in gedeelde documenten of online tools. Als het uitlekt, trek het dan in en > verwijder de API-sleutel in Hostaway. ### Je accommodatie-ID's zoeken Toon je accommodaties met het token, waarbij je `YOUR_TOKEN` vervangt: ```bash curl 'https://api.hostaway.com/v1/listings?limit=100' \ -H 'Authorization: Bearer YOUR_TOKEN' ``` Elke accommodatie in de response heeft een `id` en een `name`. Noteer de ID van elke accommodatie die je receptionist moet controleren. ## De tool maken Ga naar **Integrations**, selecteer **Add integration** en kies **Webhook Tool**. | Veld | Waarde | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Naam** | `check_hostaway_calendar` | | **Beschrijving** | "Controleer of een van onze accommodaties beschikbaar is voor de data van de beller, en wat de nachtprijs en het minimumverblijf zijn. Gebruik dit voordat je de beller vertelt dat een accommodatie beschikbaar is." | | **Methode** | GET | | **URL** | `https://api.hostaway.com/v1/listings/{listing_id}/calendar` | | **Requestheaders** | `Authorization`: `Bearer ` gevolgd door je toegangstoken, met **Type** ingesteld op **Secret** | | **Padparameters** | `listing_id` (string, verplicht): "Gebruik `11111` voor de Cedar Cabin en `22222` voor de Lakeside Cabin." | | **Queryparameters** | `startDate` (string, verplicht): "De aankomstdatum, als JJJJ-MM-DD." `endDate` (string, verplicht): "De laatste nacht van het verblijf, als JJJJ-MM-DD." `includeResources` (string, vaste waarde): `0` | | **Toewijzen aan agents** | **Receptionist** | Vervang de namen en ID's van de hutten door je eigen gegevens en voeg één regel per accommodatie toe. Selecteer **Enable**. Hostaway retourneert één vermelding per nacht. Een nacht is beschikbaar wanneer `status` gelijk is aan `available`. Elke nacht heeft ook een `price` en `minimumStay`. > **Warning** > > Houd `includeResources` vast ingesteld op `0`. Met `1` voegt Hostaway de reserveringen per nacht toe, > inclusief gastnamen, telefoonnummers en e-mailadressen, aan wat je receptionist ziet. ### Testen [Test je receptionist](/docs/nl/reception-ai/receptionist/testing) door te vragen naar een hut op data waarvan je weet dat deze geboekt zijn, en daarna op data waarvan je weet dat deze beschikbaar zijn. Vergelijk de antwoorden met je Hostaway-kalender. > **Tip** > > Voeg een [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe voor verblijfsverzoeken: vraag naar > de accommodatie, de aankomst- en vertrekdatum en het aantal gasten, controleer de kalender en vraag vervolgens naar de > naam, het telefoonnummer en het e-mailadres van de beller voor je team. Voeg een regel toe dat je receptionist nooit > belooft dat een verblijf is geboekt. ## Beperkingen * Je receptionist kan geen reserveringen maken, wijzigen of annuleren. Je team bevestigt elk verblijf. * Deze controleert één accommodatie tegelijk. Om een andere hut voor te stellen, controleert deze ze één voor één. * Nachtprijzen zijn exclusief schoonmaakkosten, belastingen en kortingen, dus je receptionist moet deze alleen als richtlijn geven. * De tool zoekt geen bestaande reserveringen op. De reserverings- en accommodatiegegevens van Hostaway bevatten deurcodes en wifiwachtwoorden, dus deze handleiding toont ze niet aan je receptionist. De Hostaway-app van Zapier retourneert dezelfde gegevens en heeft geen acties voor boekingen of beschikbaarheid. * Je toegangstoken werkt na 24 maanden niet meer. Maak vóór die tijd een nieuw token en werk de header bij. ## Problemen oplossen | Probleem | Wat je moet controleren | | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | 401 of 403 van Hostaway | De headerwaarde moet `Bearer`, een spatie en het toegangstoken zijn, niet de API-sleutel. Controleer of het niet is verlopen. | | De verkeerde hut wordt gecontroleerd | Controleer of de accommodatie-ID's in de beschrijving van `listing_id` overeenkomen met je accommodaties. | | Een geboekte nacht wordt als beschikbaar weergegeven | Controleer de kalender in Hostaway. Geblokkeerde en gereserveerde nachten hebben een andere `status` dan `available`. | | De receptionist biedt een te kort verblijf aan | Vertel deze in de toolbeschrijving om `minimumStay` op de aankomstnacht te controleren. |