Kanäle · für Gastgeber

Hostaway verbinden

Hostaway-Reservierungen automatisch importieren, Unterkünfte mit Inseraten verknüpfen und Gästen den Portallink im Airbnb- oder Booking.com-Chat senden.

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.

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.

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).

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.

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.

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.

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.