> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Hostaway Mit dem folgenden [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) 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. > **Note** > > 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](/docs/de/reception-ai/features/notifications). ## 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: ```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' ``` Kopieren Sie den Wert `access_token` aus der Antwort. Er ist 24 Monate gültig. > **Warning** > > 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: ```bash 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`. > **Warning** > > 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](/docs/de/reception-ai/receptionist/testing), 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. > **Tip** > > Fügen Sie einen [Ablauf](/docs/de/reception-ai/receptionist/rules-and-procedures) 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. |