Zum Hauptinhalt springen
Dein Assistent erkennt Gäste, beantwortet Fragen zu ihrem Aufenthalt und gibt Check-in-Details aus deinem Hostaway-Konto weiter. Die Verbindung liest nur: In Hostaway wird nichts angelegt, geändert oder storniert. Ein Beispiel: Um 22 Uhr ruft ein Gast an: „Ich stehe vor der Tür, wie lautet der Türcode?“ Der Assistent findet die Buchung, prüft, ob sie bestätigt ist und ob der Aufenthalt morgen beginnt oder schon läuft, und liest den Code langsam vor.

Konto verbinden

  1. Öffne in Hostaway Settings → Hostaway API und wähle Create. Vergib einen beliebigen Namen und wähle den Partner Hostaway Public API. Hostaway zeigt die Account ID und den API Key nur einmal an. Kopiere beides, bevor du das Fenster schließt.
  2. Öffne Agent Tools → Marketplace → Hostaway. Gib die Konto-ID und den API-Schlüssel ein.
  3. Wähle Hinzufügen. Die Anmeldung wird geprüft, bevor die Verbindung gespeichert wird, und das Konto braucht mindestens eine Unterkunft. Weise die Verbindung danach deinem Assistenten zu.
Hostaway-Schlüssel haben immer vollen Zugriff auf das Konto und lassen sich nicht auf „nur lesen“ beschränken. Diese Verbindung liest nur. Halte den Schlüssel trotzdem geheim und widerrufe ihn in Hostaway, falls er in falsche Hände gerät.
Um das Konto oder den Schlüssel später zu ändern, entferne das Tool und verbinde es erneut.

Das kann der Assistent

Standardmäßig aktiv:
  • Unterkunftsinformationen: Adresse, Check-in- und Check-out-Zeiten in Ortszeit, Hausregeln, Kapazität und Ausstattung. WLAN, Türcodes und Kontaktdaten der Eigentümer gehören nicht dazu.
  • Reservierung finden: findet die laufende oder kommende Reservierung eines Gasts mit Nachname und Buchungscode (Bestätigungscode von Airbnb oder Booking.com, Code eines anderen Kanals oder Hostaway-Reservierungsnummer).
  • Reservierungsdetails: Status, Daten, Check-in- und Check-out-Zeiten der eigenen Reservierung des Anrufers.
  • WLAN teilen und Türcodes teilen: siehe unten.
Optional, wähle es unter Bearbeiten:
  • Verfügbarkeit und Preis: prüft, ob eine Unterkunft für bestimmte Daten frei ist, und nennt den Preis. Es ist ein Angebot, keine Buchung.
Hausregeln werden jedem Anrufer vorgelesen. Halte WLAN-Passwörter und Schlüsselfach-Codes in den WLAN- und Türcode-Feldern in Hostaway, nicht in den Hausregeln.

Anrufer erkennen

Vor der Begrüßung vergleicht Famulor die Nummer des Anrufers mit den Aufenthalten, die laufen oder in den nächsten 30 Tagen beginnen. Bei genau einem Treffer kennt der Assistent Vornamen, Unterkunft, Daten, Check-in-Zeiten und Buchungsstatus als Variablen mit dem Präfix hostaway_ und kann den Gast mit Namen begrüßen. Siehe Variablen. Gehört die Nummer zu mehreren Aufenthalten, teilen sich mehrere Gäste eine Nummer oder steht sie nicht in Hostaway, fragt der Assistent nach Nachname und Buchungscode und nutzt Reservierung finden. Unterdrückte Nummern laufen genauso. Im Gespräch findet Reservierungsdetails den Aufenthalt ebenfalls über die Nummer des Anrufers.

Türcodes und WLAN

Der Assistent gibt diese Details nur für bestätigte Buchungen weiter, vom Tag vor der Anreise bis zum Abreisetag, in der Zeitzone der Unterkunft. Anfragen, Eigentümeraufenthalte und stornierte Buchungen bekommen sie nie. Ruft ein Gast früher an, erfährt er, ab welchem Tag sie verfügbar sind.
  • WLAN ist verfügbar, wenn die Nummer des Anrufers genau zu einem Aufenthalt passt, oder nach Nachname und Buchungscode.
  • Türcode, Schlüsselübergabe und Anreisehinweise brauchen zusätzlich Nachname und Buchungscode. Nach drei falschen Versuchen in einem Gespräch prüft der Assistent nicht weiter. Jede fehlgeschlagene Prüfung bekommt dieselbe Antwort, damit niemand erfährt, ob eine Buchung existiert.
Beides schaltest du unter Bearbeiten über die Tools Türcodes teilen und WLAN teilen aus. Standardmäßig sind beide an.

Was in Hostaway unverändert bleibt

Es wird nichts angelegt, geändert oder storniert, und es geht keine Nachricht an einen Gast. Der Assistent liest Buchungen, Unterkünfte und Preise.

Sicher testen

Lege in Hostaway eine Test-Reservierung an und frage den Assistenten mit Nachname und Buchungscode danach (Reservierung finden). Ein echtes Gespräch liest echte Codes vor. Nutze deshalb eine Test-Unterkunft oder eine Buchung, für die das erlaubt ist.

Kanäle

Am Telefon arbeitet der Assistent mit der Nummer, von der angerufen wird. Im Web-Chat gibt es keine Nummer, deshalb fragt er nach Nachname und Buchungscode. WhatsApp und SMS erkennen Gäste an ihrer Telefonnummer. In E-Mail zählt die verifizierte Absenderadresse.

Automationen

Verbinde Hostaway unter Automationen → Verbindungen oder importiere die Agent-Tool-Verbindung. Jedes Tool steht als Aktion bereit: Unterkunftsinformationen, Reservierung finden, Reservierungsdetails, WLAN teilen, Türcodes teilen und Verfügbarkeit und Preis. Eine Automation, die ein Anruf oder eine Textunterhaltung (SMS, WhatsApp) startet, kennt die Nummer der Gegenseite aus diesem Anruf selbst. Andere Läufe (Webhook, Zeitplan) haben keinen Anrufer. Reservierungsdetails und WLAN teilen brauchen dort deshalb eine Reservierungs-Referenz aus einem vorherigen Schritt Reservierung finden.

API, MCP, CLI & SDK

POST /api/v1/tools/integrations/hostaway · MCP connect_integration · CLI famulor connect-integration hostaway. client.api.connectIntegration braucht famulor-sdk 0.2.12 oder neuer. Aktualisiere die CLI mit npm install --global famulor, bevor du connect-integration verwendest.

Grenzen

  • Hostaway begrenzt Anfragen pro Konto und pro IP-Adresse. Das Limit teilst du dir mit deinen anderen Hostaway-Integrationen. Viel Betrieb dort kann den Assistenten bremsen.
  • Konten mit mehr als 300 Aufenthalten in den nächsten 30 Tagen werden vor der Begrüßung unter Umständen nicht erkannt. Ab 500 Aufenthalten reicht die Nummer des Anrufers auch im Gespräch nicht. Der Assistent fragt dann nach Nachname und Buchungscode.
  • Preise stehen in der Währung der Unterkunft.
  • Hostaway-Schlüssel und -Tokens laufen nach 24 Monaten ab. Lege einen neuen Schlüssel an und verbinde das Konto erneut, wenn die Verbindung nicht mehr funktioniert.
Hostaway-API-Dokumentation