> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Hostaway

> Lass deinen Assistenten Gäste erkennen und Fragen zu ihrem Aufenthalt aus Hostaway beantworten.

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.

> [!WARNING]
>
> 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.

> [!WARNING]
>
> 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](https://docs.famulor.io/de/assistants/variables.md).

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.

```bash theme={null}
famulor connect-integration hostaway --fields '{"account_id":"12345","api_key":"'"$HOSTAWAY_API_KEY"'"}' --name hostaway
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectIntegration({
  path: { provider: 'hostaway' },
  body: {
    fields: { account_id: '12345', api_key: process.env.HOSTAWAY_API_KEY },
    name: 'hostaway',
  },
});
console.log(tool.id);
```

## 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](https://api.hostaway.com/documentation)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.