Connect Hostfully to Houfy - Complete Integration Guide

Dieser Leitfaden behandelt, wie man sich verbindet, was importiert wird und wie die fortlaufende Synchronisierung funktioniert.

Was Sie erhalten, wenn Sie sich verbinden

• Alle Ihre aktiven Hostfully-Angebote werden als Angebote, die Sie vollständig besitzen und kontrollieren, in Houfy importiert

• Inhalt der Angebote (Beschreibungen, Fotos, Annehmlichkeiten, Schlafzimmer, Gebühren, Rabatte) aus Hostfully befüllt

• Preise und Verfügbarkeit werden jederzeit für die nächsten 60 Tage synchronisiert

• Reservierungen von Hostfully werden importiert und über Webhooks synchron gehalten

• Ein-Klick-Umschalter, ob neue Hostfully-Angebote künftig automatisch importiert werden

• Keine Doppelbuchungen. Houfy blockiert die gleichen Daten, die Hostfully reserviert hat (und umgekehrt)

Wie man sich verbindet

1. Melden Sie sich bei Ihrem Houfy-Konto an.

2. Gehen Sie zu https://www.houfy.com/p/hostfully

3. Klicken Sie auf Mit Hostfully verbinden. Sie werden zur Autorisierungsseite von Hostfully weitergeleitet.

4. Melden Sie sich bei Hostfully an (falls noch nicht geschehen) und genehmigen Sie den Zugriff von Houfy auf Ihr Konto.

5. Hostfully leitet Sie zurück zu Houfy.

6. Sie landen auf Ihrer Houfy-Angebotsseite. Aktive Hostfully-Angebote erscheinen hier innerhalb von ein oder zwei Minuten, während der erste Import läuft.

Wenn Sie sich jemals trennen müssen, können Sie dies von Ihrer Seite der Softwarepartner tun: https://www.houfy.com/channel-managers

Was in Houfy synchronisiert wird

Wenn ein Angebot importiert wird (erster Anschluss oder spätere Synchronisierung), zieht Houfy Folgendes von Hostfully:

Inhalt der Angebote

- Objektname, Zusammenfassung und vollständige Beschreibung

- Haustyp (Wohnung, Villa, Eigentumswohnung, Hütte usw.) zu Houfys Kategorieliste zugeordnet

- Fotos. Original-URLs werden importiert und dann auf Houfys CDN für schnellere Seitenladezeiten neu gehostet (asynchron verarbeitet)

- Annehmlichkeiten. Hostfullys Annehmlichkeiten werden Houfys Annehmlichkeits-Taxonomie zugeordnet

- Schlafzimmer. Anzahl der Schlafzimmer, Betttypen pro Zimmer, Anzahl der Badezimmer

- Objektbeschreibungen. Notizen zur Nachbarschaft, der Raum, Fortbewegung, Interaktion mit Gästen, Hausregeln

- Check-in und Check-out Zeiten, einschließlich aller benutzerdefinierten Check-in-Anweisungen

Standort

- Straße, Stadt, Bundesland, Land, Postleitzahl

- Geokodierte Breiten- und Längengrade

Preise und Tarife

- Nächtlicher Basispreis (Preisgestaltung pro Objekt)

- Preisfaktoren. Hostfully's Tagespreise, Wochenendpreise, saisonale Anpassungen

- Währung

Gebühren und Rabatte

- Reinigungsgebühr

- Gebühren für zusätzliche Gäste und Übernachtungen

- Haustiergebühren (sofern in Hostfully konfiguriert)

- Rabatte für längere Aufenthalte (wöchentlich, monatlich)

- Last-Minute- und Frühbucherrabatte (sofern in Hostfully eingerichtet)

Verfügbarkeit

- Synchronisiert für die nächsten 60 Tage bei jeder Aktualisierung

- Gebuchte Daten aus Hostfully-Reservierungen

- Eigentümerblockierungen und Wartungsreservierungen

Reservierungen

- Alle aktuellen und bevorstehenden Hostfully-Buchungen importiert

- Jede Reservierung verlinkt zurück zu ihrer Hostfully-Buchungs-ID

Wie die laufende Synchronisierung funktioniert

Nach dem ersten Import hält Houfy alles auf zwei Arten aktuell:

1. Geplante vollständige Synchronisierung (läuft nach einem regelmäßigen Zeitplan)

Houfy synchronisiert automatisch jede verbundene Anzeige nach einem wiederkehrenden Zeitplan. Jeder Durchlauf:

- Aktualisiert den Inhalt der Anzeige (falls Sie Fotos, Beschreibungen usw. in Hostfully aktualisiert haben)

- Zieht die nächsten 60 Tage an Preisen und Verfügbarkeiten

- Importiert alle neuen Reservierungen

- Führt die Fotoimport-Pipeline für Anzeigen, deren Fotos sich geändert haben, erneut aus

Dies läuft im Hintergrund. Keine Aktion von Ihnen erforderlich - vorausgesetzt, Ihre Anzeigen wurden beim ersten Mal erfolgreich importiert. Wenn keine angezeigt wurden, siehe Wenn Ihre Anzeigen unten nicht erscheinen. Wenn Sie eine Änderung in Hostfully vornehmen, wird dies spätestens beim nächsten geplanten Sync in Houfy reflektiert, oft jedoch früher über Webhooks (siehe unten).

2. Echtzeit-Webhooks

Wenn sich etwas in Hostfully ändert, wie z.B. eine neue Reservierung, die eingeht, ein Gast, der storniert, oder Preisänderungen, sendet Hostfully einen Webhook an Houfy. Houfy stellt das Ereignis in die Warteschlange und verarbeitet es innerhalb von Sekunden:

- Neue Reservierungen werden in Houfy importiert

- Reservierungsaktualisierungen (Änderungen des Datums, Gästeanzahl, Status) werden in Houfy reflektiert

- Stornierungen geben den Houfy-Kalender frei

- Änderungen an der Anzeige lösen einen frischen Sync dieser Anzeige aus

Webhooks stellen sicher, dass Reservierungen am selben Tag in Houfy angezeigt werden, ohne auf den nächsten geplanten Sync zu warten.

Wenn Ihre Anzeigen nicht erscheinen

Der erste Durchlauf kann leer zurückkommen. Der häufigste Grund ist, dass das Hostfully-Konto, das zur Autorisierung der Verbindung verwendet wurde, keinen Zugriff auf die Immobilie hat. Nichts versucht dies von selbst erneut - der geplante Sync aktualisiert nur Anzeigen, die bereits mindestens einmal eingegangen sind, also wenn keine eingegangen sind, gibt es nichts, was aktualisiert werden kann.

Um es selbst erneut auszuführen, gehen Sie zu https://www.houfy.com/channel-managers?channel=hostfully&step=2 und klicken Sie auf Neue Anzeigen abrufen.

Wenn Sie eine Nachricht sehen, dass keine Immobilien für das Konto zurückgegeben wurden, stellen Sie die Verbindung von https://www.houfy.com/p/hostfully wieder her und melden Sie sich bei Hostfully als Eigentümer oder Administrator an, der Zugriff auf die Immobilie hat.

Manuelle Sync-Option

Wenn Sie jetzt sofort eine Aktualisierung erzwingen möchten, anstatt auf den nächsten geplanten Durchlauf zu warten:

1. Gehen Sie zu Ihrer Houfy-Anzeigenseite.

2. Finden Sie die von Hostfully importierte Anzeige, die Sie aktualisieren möchten.

3. Klicken Sie auf die Anzeige und wählen Sie Resync von Hostfully (in den Anzeigenaktionen).

Dies führt die gleiche Importlogik aus, die der geplante Job verwendet, nur für eine Anzeige auf Abruf. Nützlich direkt nachdem Sie eine große Änderung in Hostfully vorgenommen haben und nicht warten möchten.

Häufig gestellte Fragen

Wird die Verbindung zu Hostfully die Anzeigen überschreiben, die ich bereits auf Houfy erstellt habe?

Nein. Hostfully-Anzeigen werden als neue Houfy-Anzeigen importiert. Ihre bestehenden Houfy-Anzeigen bleiben unberührt. Sie können die Option „Vorhandene Anzeigen zuordnen“ wählen, wenn Sie diese Ihren bestehenden Anzeigen zuordnen möchten.

Was passiert, wenn ich Hostfully später trenne?

Ihre importierten Einträge bleiben auf Houfy. Sie erhalten einfach keine Updates mehr von Hostfully. Preise, Verfügbarkeit und neue Reservierungen fließen nicht mehr ein.

Kann ich einen direkt auf Houfy importierten Eintrag bearbeiten?

Ja, aber jedes Feld, das Hostfully gehört, wird beim nächsten Sync überschrieben. Beste Praxis: Bearbeiten Sie den Inhalt des Eintrags in Hostfully und die nur auf Houfy spezifischen Felder (wie Houfy-spezifische Marketingtexte, soziale Beschreibungen) auf Houfy.

Wie weiß ich, wann der letzte Sync durchgeführt wurde?

Der Verbindungsstatus auf der Hostfully-Seite in Houfy zeigt den Zeitstempel des letzten Syncs pro Eintrag an.

Was passiert, wenn ein Sync fehlschlägt?

Houfy versucht es automatisch erneut. Anhaltende Fehler (wie ein widerrufenes Token) lösen eine E-Mail-Benachrichtigung an die mit Ihrem Houfy-Konto verbundene E-Mail-Adresse aus, die Sie auffordert, die Verbindung wiederherzustellen.

Kann ich nur einige meiner Hostfully-Einträge synchronisieren?

Ja. Während der Einrichtung können Sie auswählen, welche Einträge importiert werden sollen, und Sie können einzelne Einträge jederzeit ein- oder ausschalten.