Guesty
Integration
Beginnen Sie die Integration, indem Sie sich in Ihr Guesty-Konto unter https://app.guesty.com/auth/login einloggen.
Öffnen Sie nach dem Einloggen in der rechten oberen Ecke des Bildschirms das Menü „Integrations“ und wählen Sie „Marketplace“ aus.
Geben Sie in der Suchleiste des Marketplace „Tedee“ ein und wählen Sie die Tedee-Integration aus den gefilterten Ergebnissen aus.
Klicken Sie auf der rechten Seite des Bildschirms auf die Schaltfläche „Connect“.
Die Guesty-Plattform generiert anschließend Ihren eindeutigen API-Schlüssel – einen Code, der für die Integration zwischen den Plattformen Guesty und Tedee erforderlich ist.
Sie haben jetzt 3 Stunden Zeit, um die Integration im Tedee Portal einzurichten. Kopieren Sie den Guesty-API-Schlüssel in die Zwischenablage Ihres Computers.
Hinweis: Wenn Sie während dieser 3 Stunden nach der Generierung erneut auf den Guesty-API-Schlüssel zugreifen müssen, klicken Sie auf „View API key (integration token)“, um ihn erneut anzuzeigen.
Wenn es Ihnen nicht gelingt, die Plattformen innerhalb von 3 Stunden zu integrieren, klicken Sie auf „Disconnect“ und anschließend erneut auf „Connect“, um einen neuen Code zu generieren, der für die nächsten 3 Stunden gültig ist.
Sie können die Plattformen außerdem jederzeit trennen und die Automatisierung der Zugriffsverwaltung deaktivieren.
Nachdem Ihr Guesty-API-Schlüssel generiert wurde, gehen Sie zum Tedee Portal unter https://portal.tedee.com und melden Sie sich mit Ihrem Tedee-Konto an.
Wählen Sie dann im linken Seitenmenü die Option „Short-term rentals“ und anschließend „Guesty“.
Fügen Sie im Seitenmenü den zuvor generierten Guesty-API-Schlüssel ein und klicken Sie auf „Connect“.
Guesty und Tedee werden nun integriert und Ihre Mietangebote werden synchronisiert.
Sie werden zur Ansicht „Accommodations“ weitergeleitet. Alle Unterkünfte werden automatisch von der Kurzzeitvermietungsplattform synchronisiert.
Accommodations-Seite
Die Seite „Accommodations“ listet alle synchronisierten Mietapartments des Nutzers über alle verbundenen Vermietungsdienste hinweg auf.
Die Registerkarte „Accommodations“ enthält Objekte, die korrekt mit dem Tedee-System verknüpft wurden. Das bedeutet, dass sie bereit sind, neue Buchungen anzunehmen, und die Automatisierung korrekt funktioniert.
| Name | Aktion | |
| 1 | Symbol zum Ein-/Ausblenden der Filterleiste | Zeigt/verbirgt die Filterleiste |
| 2 | Schaltfläche für manuelle Synchronisierung | Ermöglicht das Erzwingen der Synchronisierung Ihrer Unterkunft mit einem verbundenen Anbieter von Reservierungsdiensten |
| 3 | Nach Stichwort filtern | Zeigt alle Unterkünfte gefiltert nach dem ausgewählten Stichwort an |
| 4 | Nach Automatisierung filtern | Filtert die Liste nach automatisierten/nicht automatisierten Unterkünften |
| 5 | Nach Plattform filtern | Filtert die Liste nach verbundenen Vermietungsplattformen |
| 6 | Spalte „Apartmentname“ | Der aus der Kurzzeitvermietungsintegration synchronisierte Apartmentname. Es wird empfohlen, dass sich die Namen der Objekte unterscheiden – das erleichtert die Verwaltung des gesamten Prozesses |
| 7 | Spalte „Schloss“ | Name des mit dem Apartment verknüpften Schlosses |
| 8 | Spalte „Plattform“ | Logo der Kurzzeitvermietungsplattform, mit der das Apartment verknüpft ist |
| 9 | Apartmentname | Name des mit dem Schloss verknüpften Apartments |
| 10 | Kontextmenü | Zeigt das Kontextmenü für die ausgewählte Unterkunft an |
| 11 | Unterkunft bearbeiten | Öffnet die Seitenleiste mit der ausgewählten Unterkunft, in der Nutzer Unterkünfte synchronisieren oder Unterkunftseigenschaften bearbeiten können |
| 12 | Buchungen anzeigen | Leitet den Nutzer zur Buchungsansicht der ausgewählten Unterkunft weiter |
| 13 | Option „Load more“ | Wenn weitere Einträge vorhanden sind, sollten sie nach dem Scrollen erscheinen |
| 14 | Alle Filter löschen | Setzt den Status aller ausgewählten Filter zurück |
Ansicht „No bookings found“
In der Ansicht „Accommodations“ können Daten nach zwei Spalten gefiltert werden: Apartmentname und Plattform.
Der Nutzer kann die Filterung auf zwei Arten durchführen:
- Wählen Sie die Option „Filter by name“
- Wählen Sie „Platform“ und klicken Sie in der Dropdown-Liste auf ein Channel-Management-System
Das Hauptziel der Synchronisierung ist es, in der Kurzzeitvermietungsplattform und im Tedee Portal denselben Status beizubehalten.
Aus Sicht des Tedee-Portal-Nutzers ist der Synchronisierungsprozess der Unterkünfte einfach. Er aktualisiert die Liste der verfügbaren Unterkünfte von der Kurzzeitvermietungsplattform im Tedee Portal. Nach dem Klicken auf die Schaltfläche „Sync“ startet der Synchronisierungsprozess. Das Tedee-System sollte alle Aktualisierungen widerspiegeln, die in der Kurzzeitvermietungsplattform vorgenommen wurden. Beispielsweise sollten alle gelöschten Unterkünfte aus der Liste im Tedee Portal verschwinden und neu erstellte an ihrer Stelle erscheinen.
Einstellungen der Vermietungsautomatisierung
Nachdem Sie auf die Zeile mit dem Objektnamen geklickt haben, erscheint rechts auf dem Bildschirm ein Panel. Es enthält die Einstellungen der Vermietungsautomatisierung, die der Nutzer ändern kann.
Vermietungsoptionen, die der Nutzer ändern kann, sind:
- Verknüpfen/Trennen der Unterkunft und des smart lock. Die Verknüpfung des smart lock ist erforderlich, damit die Automatisierung zwischen dem Channel-Management-System und dem Tedee-System korrekt funktioniert. Der Nutzer sieht nur die Schlösser, die ihm gehören. Um das Schloss mit der Unterkunft zu verknüpfen, muss es mit der Bridge und dem Keypad gekoppelt sein.
- Wie viele Tage vor Beginn der Buchung der Gast die Zugangsdaten erhalten soll.
- Verwaltung von Benachrichtigungen.
Das Trennen des Schlosses vom Vermietungssystem storniert alle Reservierungen sowie den für diese Reservierungen gewährten Zugang.
| Name | Aktion | |
| 1 | Unterkunftsname | Aus dem Kurzzeitvermietungssystem synchronisierter Unterkunftsname (schreibgeschütztes Feld) |
| 2 | Verknüpftes smart lock | Name des der Unterkunft zugewiesenen smart lock |
| 3 | Abschnitt „Tage vor der Buchung für Zugang“ | Die Anzahl der Tage, vor denen Gäste den Zugang zum Schloss aus dem Tedee-System erhalten |
| 4 | Benachrichtigungen für Eigentümer | Optionen für Benachrichtigungen an den Eigentümer |
| 5 | Benachrichtigungen für Gäste | Optionen für Benachrichtigungen an Gäste |
| 6 | Schaltfläche „Apply“ oder „Cancel“ | Der Nutzer kann die vorgenommenen Änderungen durch Klicken auf „Apply“ übernehmen oder sie durch Klicken auf „Cancel“ verwerfen |
Bookings-Seite
Die Registerkarte „Bookings“ zeigt alle von Gästen vorgenommenen Buchungen an (externe Nutzer der Kurzzeitvermietungsplattform).
In der Buchungsansicht können Sie prüfen, ob die Automatisierung korrekt funktioniert, den Buchungsstatus einsehen, ob der Nutzer die Unterkunft erfolgreich betreten hat und ob die Buchung abgeschlossen wurde.
Portalnutzer können die PIN-Zugangsdetails ansehen und aktualisieren.
Obwohl das System die Buchungsliste automatisch mit den Vermietungsplattformen synchronisiert, können Nutzer die Synchronisierung manuell erzwingen, wenn sie feststellen, dass die Daten veraltet sind.
| Name | Aktion | |
| 1 | Schaltfläche für manuelle Synchronisierung | Ermöglicht das Erzwingen der Synchronisierung Ihrer Unterkunft mit einem verbundenen Anbieter von Reservierungsdiensten |
| 2 | Symbol zum Ein-/Ausblenden der Filterleiste | Zeigt/verbirgt die Filterleiste |
| 3 | Nach Stichwort filtern | Zeigt alle Buchungen an, deren Spalten ID/E-Mail dem Suchbegriff entsprechen |
| 4 | Unterkunft auswählen | Zeigt alle Buchungen für ein ausgewähltes Mietobjekt an |
| 5 | Spalte „Booking ID“ | Buchungs-ID aus der externen Kurzzeitvermietungsplattform |
| 6 | Spalte „Gast“ | E-Mail-Adresse des Gasts |
| 7 | Spalte „Apartment“ | Name des Apartments, in dem die Buchung erstellt wurde |
| 8 | Spalte „Buchungsbeginn“ | Check-in-Datum – der Zugang im Tedee-System beginnt ab diesem Datum |
| 9 | Spalte „Buchungsende“ | Check-out-Datum – nach diesem Datum endet der Zugang im Tedee-System |
| 10 | Statusleiste | Zeigt eine Statusleiste mit Informationen zum aktuellen Buchungsstatus an |
| 11 | Option „Load more“ | Wenn weitere Einträge vorhanden sind, sollten sie nach dem Scrollen erscheinen |
Statusleiste
| Name | Aktion | |
| 1 | Schritt „Automatisierungszeitplan“ | Zeigt Informationen zum Automatisierungszeitplan an.
Zwei Zustände sind verfügbar:
|
| 2 | Schritt „Zugang vergeben“ | Zeigt detaillierte Informationen zum Status des vergebenen Zugangs an.
Drei Zustände sind verfügbar:
Die Vergabe des Zugangs kann aus drei Gründen fehlschlagen:
Tritt ein Fehler auf, plant die Anwendung automatisch den nächsten Verbindungsversuch (das Datum des nächsten Versuchs wird angezeigt). Wenn die maximale Anzahl an Wiederholungen erreicht ist, führt das System diese Aktion nicht weiter aus und blendet die Information über den nächsten Versuch aus. |
| 3 | Schritt „Check-in“ | Zeigt Informationen dazu an, ob der Kunde im Zimmer eingecheckt hat.
Zwei Zustände sind verfügbar:
|
Automatische Zugriffsvergabe
Die automatische Zugriffsvergabe startet, wenn auf der Kurzzeitvermietungsplattform eine neue Buchung erstellt wird. Die gesamte Automatisierung basiert auf der vom Nutzer gewählten Konfiguration.
Beachten Sie, dass der Zugang zum Tedee-Schloss nicht gleichzeitig mit der Buchung erstellt wird.
Der Prozess der automatischen Zugriffsvergabe ist wie folgt:
- Das Tedee-System erhält Informationen über eine neue Buchung, die im Channel-Management-System erstellt wurde.
- Die Buchungsinformationen werden im Tedee-System gespeichert.
- Der Eigentümer oder Administrator des Schlosses legt fest, wann der Besucher die Zugangsdaten erhält.
- Eine festgelegte Anzahl von Tagen vor Beginn der Reservierung erhält der Gast die Zugangsinformationen zum Tedee-Schloss – die Zugangsdaten werden automatisch per E-Mail versendet. Hier ist eine Vorlage für eine Beispielnachricht:
- Der Schlossbesitzer kann Benachrichtigungen für das erste Entsperren der Tür durch den Gast aktivieren – so kennt er das genaue Check-in-Datum.
- Beim Check-out verliert der Gast den Zugang zur Unterkunft und kann seinen PIN nicht erneut verwenden.
Bearbeiten des API-Schlüssels des Channel-Management-Systems
Durch das Bearbeiten des API-Schlüssels des Channel-Management-Systems kann der Nutzer die Integration aktualisieren, wenn der vorherige Schlüssel abgelaufen ist oder wenn ein Dienst aufgrund eines nicht näher spezifizierten Fehlers getrennt wurde. Diese Aktion kann in der Verbindungsverwaltungsansicht durchgeführt werden – die Liste der verbundenen Vermietungsdienste sollte oben in der Seitenleiste sichtbar sein. Um die Bearbeitungsseite zu öffnen, klicken Sie auf das Drei-Punkte-Symbol in der rechten oberen Ecke (1) und wählen Sie Manage connections > Zahnrad-Symbol. Nachdem Sie den Schlüssel eingefügt haben (2), schließen Sie den Vorgang ab, indem Sie auf „Apply“ klicken (3).
Trennen des Channel-Management-Systems vom Tedee-Konto
Das Trennen der Konten entfernt automatisch alle zugehörigen Unterkünfte, die mit dem Tedee Portal verknüpft sind. Gehen Sie dazu zu Accommodations > Manage connections, klicken Sie auf das Papierkorb-Symbol neben dem Logo des Channel-Management-Systems und bestätigen Sie das Löschen.
Stornierung des Zugangs
Eine Stornierung des Zugangs erfolgt jedes Mal, wenn eine Buchung aus dem Tedee-System entfernt wird.
Dies passiert, wenn:
- Die Reservierung auf der Kurzzeitvermietungsplattform storniert wird.
- Die Reservierung auf der Kurzzeitvermietungsplattform abgeschlossen ist.
- Die Unterkunft auf der Kurzzeitvermietungsplattform gelöscht wird.
- Das Tedee-Schloss von der Unterkunft getrennt wird.
Der Prozess der automatischen Stornierung des Zugangs ist wie folgt:
- Eine der oben genannten Situationen tritt ein.
- Die Buchungsinformationen werden aus dem Tedee-System gelöscht.
- Wenn der Zugang zu einem Tedee-Schloss nur geplant ist und aussteht, wird er storniert.
- Wenn der Zugang zum Tedee-Schloss bereits vergeben wurde, wird er widerrufen.
