Hostaway | ElevenLabs Documentation

Met de onderstaande webhooktool 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.

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.

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:

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.

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:

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.

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 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.

Voeg een procedure 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.