Hostaway | ElevenLabs Documentation

Mit dem folgenden Webhook-Tool kann Ihr Rezeptionist den Kalender eines Hostaway-Listings für die vom Anrufer angefragten Daten prüfen und ihm mitteilen, ob die Hütte oder Unterkunft frei ist, wie hoch der Übernachtungspreis ist und wie lange der Mindestaufenthalt ist. Die öffentliche API von Hostaway stellt ein Zugriffstoken aus, das 24 Monate gültig ist. Daher ruft das Tool Hostaway direkt auf.

Ihr Rezeptionist kann keine Reservierungen erstellen oder bestehende nachschlagen. Er prüft den Kalender und nimmt die Buchungsanfrage entgegen. Ihr Team bestätigt den Aufenthalt über die Zusammenfassung nach dem Anruf.

Bevor Sie beginnen

API-Schlüssel erstellen

Öffnen Sie im Hostaway-Dashboard Settings → Hostaway API und erstellen Sie einen neuen API-Schlüssel. Nennen Sie ihn Reception.ai und wählen Sie Hostaway Public API als Partner. Kopieren Sie den Schlüssel: Hostaway zeigt ihn nur einmal an. Notieren Sie auch Ihre Account ID, die ebenfalls unter Settings angezeigt wird.

Zugriffstoken abrufen

Tauschen Sie den Schlüssel im Terminal gegen ein Zugriffstoken aus, indem Sie ACCOUNT_ID und API_KEY ersetzen:

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'

Kopieren Sie den Wert access_token aus der Antwort. Er ist 24 Monate gültig.

Das Zugriffstoken kann alles in Ihrem Hostaway-Konto lesen und ändern, einschließlich Gästedaten und Türcodes. Fügen Sie es nicht in freigegebene Dokumente oder Online-Tools ein. Falls es offengelegt wird, widerrufen Sie es und löschen Sie den API-Schlüssel in Hostaway.

Listing-IDs ermitteln

Listen Sie Ihre Listings mit dem Token auf, indem Sie YOUR_TOKEN ersetzen:

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

Jedes Listing in der Antwort hat eine id und einen name. Notieren Sie die ID jedes Listings, das Ihr Rezeptionist prüfen soll.

Tool erstellen

Gehen Sie zu Integrations, wählen Sie Add integration und dann Webhook Tool.

Feld	Wert
Name	`check_hostaway_calendar`
Beschreibung	”Prüfe, ob eine unserer Unterkünfte für die Daten des Anrufers frei ist, sowie den Übernachtungspreis und Mindestaufenthalt. Verwende das Tool, bevor du dem Anrufer sagst, dass eine Unterkunft verfügbar ist.”
Methode	GET
URL	`https://api.hostaway.com/v1/listings/{listing_id}/calendar`
Request Headers	`Authorization`: `Bearer` gefolgt von Ihrem Zugriffstoken, mit Type auf Secret gesetzt
Path Parameters	`listing_id` (string, erforderlich): “Verwende `11111` für die Cedar Cabin und `22222` für die Lakeside Cabin.”
Query Parameters	`startDate` (string, erforderlich): “Das Anreisedatum im Format JJJJ-MM-TT.” `endDate` (string, erforderlich): “Die letzte Übernachtung im Format JJJJ-MM-TT.” `includeResources` (string, fester Wert): `0`
Agents zuweisen	Receptionist

Ersetzen Sie die Namen und IDs der Hütten durch Ihre eigenen und fügen Sie pro Listing eine Zeile hinzu. Wählen Sie Enable.

Hostaway gibt einen Eintrag pro Nacht zurück. Eine Nacht ist frei, wenn status den Wert available hat. Jede Nacht enthält auch price und minimumStay.

Lassen Sie includeResources fest auf 0. Bei 1 fügt Hostaway die Reservierungen jeder Nacht, einschließlich Gastnamen, Telefonnummern und E-Mail-Adressen, zu den Daten hinzu, die Ihr Rezeptionist sieht.

Testen

Testen Sie Ihren Rezeptionisten, indem Sie nach einer Hütte für Daten fragen, von denen Sie wissen, dass sie gebucht sind, und danach für Daten, von denen Sie wissen, dass sie frei sind. Vergleichen Sie die Antworten mit Ihrem Hostaway-Kalender.

Fügen Sie einen Ablauf für Aufenthaltsanfragen hinzu: Fragen Sie nach Unterkunft, An- und Abreisedatum sowie Anzahl der Gäste, prüfen Sie den Kalender und erfassen Sie dann Name, Telefonnummer und E-Mail-Adresse des Anrufers für Ihr Team. Fügen Sie eine Regel hinzu, dass Ihr Rezeptionist niemals verspricht, ein Aufenthalt sei gebucht.

Einschränkungen

Ihr Rezeptionist kann keine Reservierungen erstellen, ändern oder stornieren. Ihr Team bestätigt jeden Aufenthalt.
Er prüft jeweils ein Listing. Um eine andere Hütte vorzuschlagen, prüft er jede einzeln.
Übernachtungspreise enthalten keine Reinigungsgebühren, Steuern oder Rabatte. Ihr Rezeptionist sollte sie daher nur als Orientierung nennen.
Das Tool sucht keine bestehenden Reservierungen. Die Reservierungs- und Listing-Datensätze von Hostaway enthalten Türcodes und WLAN-Passwörter. Daher stellt diese Anleitung sie Ihrem Rezeptionisten nicht bereit. Die Hostaway-App von Zapier gibt dieselben Datensätze zurück und bietet keine Aktionen für Buchungen oder Verfügbarkeit.
Ihr Zugriffstoken funktioniert nach 24 Monaten nicht mehr. Erstellen Sie vorher ein neues und aktualisieren Sie den Header.

Fehlerbehebung

Problem	Prüfen Sie
401 oder 403 von Hostaway	Der Header-Wert muss aus `Bearer`, einem Leerzeichen und dem Zugriffstoken bestehen, nicht aus dem API-Schlüssel. Prüfen Sie, ob er abgelaufen ist.
Die falsche Hütte wird geprüft	Prüfen Sie, ob die Listing-IDs in der Beschreibung von `listing_id` mit Ihren Listings übereinstimmen.
Eine gebuchte Nacht wird als frei angezeigt	Prüfen Sie den Kalender in Hostaway. Blockierte und reservierte Nächte haben einen anderen `status` als `available`.
Der Rezeptionist bietet einen zu kurzen Aufenthalt an	Weisen Sie ihn in der Tool-Beschreibung an, `minimumStay` für die Anreisenacht zu prüfen.