# Hostaway verbinden

Wenn Hostaway verbunden ist, wird jede Reservierung (von Airbnb, Booking.com, Vrbo, Direktbuchung …) automatisch in Ihr Gästeportal importiert: Daten, Anzahl der Gäste, Name und Kontaktdaten des Gastes. Stornierungen und Datumsänderungen werden übernommen. Ihre Check-in-Daten, Zahlungen und Notizen werden vom Import nie überschrieben.

## 1. Hostaway-API-Schlüssel erstellen

1. Melden Sie sich in Ihrem Hostaway-Dashboard an.
2. Öffnen Sie **Settings → Hostaway API**.
3. Klicken Sie auf **Create**, um einen neuen API-Schlüssel anzulegen, vergeben Sie einen Namen (zum Beispiel *Gästeportal*) und speichern Sie.
4. Kopieren Sie die **Account ID** und den **API key** (bei Hostaway „client secret“ genannt). Der Schlüssel wird nur einmal angezeigt.

## 2. Hostaway in Ihrem Dashboard verbinden

1. Öffnen Sie **Settings → Channels → Hostaway**.
2. Fügen Sie die **Account ID** und den **API key (client secret)** ein.
3. Lassen Sie **API base URL** leer – dann wird `https://api.hostaway.com/v1` verwendet. Füllen Sie das Feld nur aus, wenn Sie einen Hostaway-kompatiblen Endpunkt nutzen möchten (zum Beispiel einen CodeB-Endpunkt); es muss eine öffentliche https-Adresse sein.
4. Aktivieren Sie **Enabled** und klicken Sie auf **Test** (dabei wird zuerst gespeichert). Sie sollten *Hostaway: connected* sehen.

![Settings → Channels](/site/img/docs/d-settings-channels.webp "Settings → Channels")

## 3. Unterkünfte verknüpfen

1. Klicken Sie in der Hostaway-Karte auf **Show listings**. Sie sehen jedes Inserat mit seiner ID und ob es bereits verknüpft ist.
2. **Neu im Gästeportal?** Lassen Sie die Inserate angehakt und klicken Sie auf **Add selected as properties**. Jedes Inserat wird zu einer Unterkunft mit Name, Adresse, Ort, Land, Zeitzone sowie Check-in- und Check-out-Zeiten aus Hostaway, wird verknüpft und seine Buchungen werden sofort importiert.
3. **Unterkunft bereits von Hand angelegt?** Entfernen Sie den Haken bei diesem Inserat (das geschieht automatisch, wenn eine Unterkunft denselben Namen hat) und tragen Sie die Listing-ID stattdessen unter **Settings → Properties → Settings → Hostaway listing ID** ein, damit keine Kopie entsteht.

![Show listings: Inserate zum Hinzufügen anhaken – verknüpfte Inserate und Unterkünfte mit gleichem Namen werden erkannt](/site/img/docs/d-channels-listings.webp "Show listings: Inserate zum Hinzufügen anhaken – verknüpfte Inserate und Unterkünfte mit gleichem Namen werden erkannt")

Die Karte zeigt den Fortschritt, und das Dashboard aktualisiert sich von selbst, sobald die Buchungen da sind. Auch die **Fotos** der Inserate werden importiert (bis zu 12 pro Unterkunft, gespeichert auf dem eigenen Server des Gästeportals); das erste wird zum Titelfoto. Ein anderes Titelfoto wählen Sie unter **Guide editor → Property & welcome → Photos from Hostaway**. Für früher verknüpfte Unterkünfte klicken Sie in der Hostaway-Karte auf **Import photos** – es werden nur fehlende Fotos geholt, Sie können also bedenkenlos erneut klicken (zum Beispiel nach einem Serverneustart).

![Während die Buchungen importiert werden, zeigt die Karte den Fortschritt und aktualisiert das Dashboard, sobald sie da sind](/site/img/docs/d-channels-progress.webp "Während die Buchungen importiert werden, zeigt die Karte den Fortschritt und aktualisiert das Dashboard, sobald sie da sind")

Vervollständigen Sie dann jede Unterkunft: WLAN, Türcodes, MTA-Lizenz, Touristensteuer und Zahlungen.

## 4. Import

Klicken Sie auf **Import now**, um Reservierungen sofort abzurufen. Danach laufen Importe automatisch alle 30 Minuten für Aufenthalte von vor 30 Tagen bis etwa 18 Monate im Voraus.

### Sofortige Aktualisierung (Webhook)

Statt bis zu 30 Minuten auf den nächsten Import zu warten, kann Hostaway das Gästeportal innerhalb von Sekunden über neue und geänderte Reservierungen informieren:

1. Klicken Sie unter **Settings → Channels → Hostaway** auf **Set up instant updates** und dann auf **Copy**, um die Adresse zu kopieren.
2. Öffnen Sie im Hostaway-Dashboard **Settings → Integrations → Webhooks** (Unified Webhooks), fügen Sie einen Webhook mit dieser URL hinzu und speichern Sie. Lassen Sie Login und Passwort leer – die Adresse selbst ist der Schlüssel.
3. Die Karte zeigt, wann Hostaway zuletzt aufgerufen hat und was passiert ist. Der regelmäßige Import läuft als Absicherung weiter.

![Sofortige Aktualisierung: die geheime Webhook-Adresse und der letzte Aufruf](/site/img/docs/d-channels-instant.webp "Sofortige Aktualisierung: die geheime Webhook-Adresse und der letzte Aufruf")

Die Adresse ist geheim: Jeder, der sie kennt, kann das Gästeportal bitten, eine Buchung erneut zu prüfen (die Buchung selbst wird immer mit Ihrem API-Schlüssel von Hostaway abgerufen). **New address** ersetzt sie, falls sie einmal in falsche Hände gerät – fügen Sie dann die neue Adresse in Hostaway ein.

## 5. Gäste einladen

Importierte Buchungen erhalten sofort ihren eigenen Portallink. Sie können ihn senden:

- per E-Mail aus der Buchung (**Email portal link to guest**);
- **im Chat des Kanals** – **Send portal link via Airbnb** (oder Booking.com, Vrbo …) in der Buchung. Die Nachricht geht über Hostaway in das Postfach des Gastes auf der Plattform, über die er gebucht hat;
- automatisch einige Tage vor der Anreise: **Settings → Email** – *Email the portal link to new guests automatically* und/oder *Also send it through the booking channel's chat*.

## 6. Gästen Nachrichten senden

Der Bereich **Messages** der Buchung zeigt die Unterhaltung aus Hostaway (Nachrichten des Gastes und Ihre) und ermöglicht Antworten im Chat des Kanals. Nachrichten werden genau so gesendet, wie sie geschrieben sind – Platzhalter wie `[guest_name]` werden nicht ausgefüllt, daher wird eine Nachricht, die noch einen enthält, abgelehnt. Details: [E-Mail und Benachrichtigungen](/docs/email-and-notifications).

## Häufige Fragen

### Welche Daten kommen von Hostaway und welche bleiben hier?

Anfragen, ausstehende und unbestätigte Anfragen (zum Beispiel eine Vrbo-Buchungsanfrage), abgelaufene oder abgelehnte Anfragen und Eigentümeraufenthalte werden nicht importiert – nur echte Aufenthalte. Hostaway ist maßgeblich für Daten, Status, Gästezahlen und Kontaktdaten aus der Buchung – außer Gästezahlen, die Sie in der Buchung korrigiert haben (**Guests → Change**); diese behalten spätere Importe bei. Online-Check-in-Daten, Zahlungen, Kautionsstatus, Türcodes und Ihre Notizen liegen im Gästeportal und werden nie überschrieben.

### Wie aktualisiere ich die Fotos einer einzelnen Unterkunft?

**Settings → Properties → Settings → Photos → Refresh photos** holt neue Fotos, entfernt solche, die Hostaway nicht mehr listet, und lädt nie ein Foto doppelt herunter. **Refresh and use the first as cover** setzt zusätzlich das Titelfoto zurück.

![Einstellungen der Unterkunft: Fotos einer Unterkunft aktualisieren](/site/img/docs/d-property-photos.webp "Einstellungen der Unterkunft: Fotos einer Unterkunft aktualisieren")

### Was passiert, wenn eine Reservierung in Hostaway storniert wird?

Die Buchung wird beim nächsten Import als storniert markiert; das Gästeportal zeigt die Stornierung an und die Tage werden frei.

### Manche Gäste haben keine E-Mail-Adresse?

Kanäle verbergen oft die echte E-Mail-Adresse. Senden Sie den Portallink stattdessen über den Chat des Kanals – **Send portal link via …** in der Buchung – oder aktivieren Sie die automatische Chat-Einladung unter **Settings → Email**.