Guesty
Integracja
Rozpocznij integrację, logując się do konta Guesty pod adresem https://app.guesty.com/auth/login.
Po zalogowaniu, w prawym górnym rogu ekranu otwórz menu „Integrations” i wybierz „Marketplace”.
W pasku wyszukiwania Marketplace wpisz Tedee i wybierz integrację Tedee z przefiltrowanych wyników.
Kliknij przycisk „Connect” po prawej stronie ekranu.
Platforma Guesty wygeneruje wtedy unikalny klucz API – kod wymagany do integracji między platformami Guesty i Tedee.
Masz teraz 3 godziny na skonfigurowanie integracji w Tedee Portal. Skopiuj klucz API Guesty do schowka na komputerze.
Uwaga: Jeśli w ciągu tych 3 godzin po wygenerowaniu chcesz ponownie uzyskać dostęp do klucza API Guesty, kliknij „View API key (integration token)”, aby wyświetlić go ponownie.
Jeśli nie zintegrujesz platform w ciągu 3 godzin, kliknij „Disconnect”, a następnie „Connect” ponownie, aby wygenerować nowy kod, ważny przez kolejne 3 godziny.
Możesz też rozłączyć platformy w dowolnym momencie i dezaktywować automatyzację zarządzania dostępem.
Gdy masz już wygenerowany klucz API Guesty, przejdź do Tedee Portal pod adresem https://portal.tedee.com i zaloguj się na swoje konto Tedee.
Następnie w menu po lewej stronie wybierz opcję „Short-term rentals” i wskaż „Guesty”.
W menu bocznym wklej wcześniej wygenerowany klucz API Guesty i kliknij „Connect”.
Guesty i Tedee zostaną teraz zintegrowane, a Twoje oferty wynajmu zostaną zsynchronizowane.
Zostaniesz przekierowany do widoku „Accommodations”. Wszystkie obiekty zostaną automatycznie zsynchronizowane z platformy wynajmu krótkoterminowego.
Strona „Accommodations”
Strona „Accommodations” wyświetla wszystkie zsynchronizowane apartamenty użytkownika ze wszystkich podłączonych usług wynajmu.
Zakładka „Accommodations” zawiera obiekty, które zostały prawidłowo powiązane z systemem Tedee. Oznacza to, że są gotowe do przyjmowania nowych rezerwacji, a automatyzacja działa poprawnie.
| Nazwa | Działanie | |
| 1 | Ikona przełączania paska filtrów | Pokazuje/ukrywa pasek filtrów |
| 2 | Przycisk ręcznej synchronizacji | Umożliwia wymuszenie synchronizacji obiektu z podłączonym dostawcą usług rezerwacyjnych |
| 3 | Filtruj według słowa kluczowego | Wyświetla wszystkie obiekty przefiltrowane według wybranego słowa kluczowego |
| 4 | Filtruj według automatyzacji | Filtruje listę według obiektów z automatyzacją/bez automatyzacji |
| 5 | Filtruj według platformy | Filtruje listę według podłączonych platform wynajmu |
| 6 | Kolumna z nazwą obiektu | Nazwa obiektu zsynchronizowana z integracji wynajmu krótkoterminowego. Zaleca się, aby nazwy obiektów różniły się – ułatwi to zarządzanie całym procesem |
| 7 | Kolumna zamka | Nazwa zamka powiązanego z obiektem |
| 8 | Kolumna platformy | Logo platformy wynajmu krótkoterminowego, z którą obiekt jest powiązany |
| 9 | Nazwa apartamentu | Nazwa apartamentu powiązanego z zamkiem |
| 10 | Menu kontekstowe | Wyświetla menu kontekstowe dla wybranego obiektu |
| 11 | Edytuj obiekt | Otwiera panel boczny z wybranym obiektem, w którym użytkownicy mogą zsynchronizować lub edytować właściwości obiektu |
| 12 | Pokaż rezerwacje | Przekierowuje użytkownika do widoku rezerwacji dla wybranego apartamentu |
| 13 | Opcja „Load more” | Jeśli są kolejne rekordy, powinny pojawić się po przewinięciu |
| 14 | Wyczyść wszystkie filtry | Resetuje stan wszystkich wybranych filtrów |
Widok „No bookings found”
Widok „Accommodations” umożliwia filtrowanie danych według dwóch kolumn: „Apartment name” i „Platform”.
Użytkownik może filtrować na dwa sposoby:
- wybierz opcję „Filter by name”
- wybierz „Platform” i z listy rozwijanej kliknij system zarządzania kanałami
Głównym celem synchronizacji jest utrzymanie tego samego statusu na platformie wynajmu krótkoterminowego i w Tedee Portal.
Z perspektywy użytkownika Tedee Portal proces synchronizacji obiektów jest prosty. Odświeża on listę dostępnych obiektów z platformy wynajmu krótkoterminowego w Tedee Portal. Po kliknięciu przycisku „Sync” rozpoczyna się proces synchronizacji. System Tedee powinien odzwierciedlać wszystkie aktualizacje wprowadzone na platformie wynajmu krótkoterminowego. Na przykład wszystkie usunięte obiekty powinny zniknąć z listy w Tedee Portal, a nowo utworzone powinny pojawić się w ich miejsce.
Ustawienia automatyzacji wynajmu
Po kliknięciu w wiersz z nazwą obiektu po prawej stronie ekranu pojawi się panel. Zawiera ustawienia automatyzacji wynajmu, które użytkownik może modyfikować.
Opcje wynajmu, które użytkownik może zmienić, to:
- Łączenie/odłączanie obiektu wynajmu i smart locka. Powiązanie smart locka jest wymagane, aby automatyzacja między systemem zarządzania kanałami a systemem Tedee działała poprawnie. Użytkownik zobaczy tylko zamki, których jest właścicielem. Aby powiązać zamek z obiektem, musi on być sparowany z bridge’em i keypad’em.
- Ile dni przed rozpoczęciem rezerwacji gość ma otrzymać dane dostępowe.
- Zarządzanie powiadomieniami.
Odłączenie zamka od systemu wynajmu anuluje wszystkie rezerwacje oraz przyznane do nich dostępy.
| Nazwa | Działanie | |
| 1 | Nazwa obiektu | Nazwa obiektu zsynchronizowana z systemu wynajmu krótkoterminowego (pole tylko do odczytu) |
| 2 | Powiązany smart lock | Nazwa smart locka przypisanego do obiektu |
| 3 | Sekcja liczby dni przed rezerwacją na przyznanie dostępu | Liczba dni, przed którą goście otrzymają dostęp do zamka z systemu Tedee |
| 4 | Powiadomienia właściciela | Opcje powiadomień właściciela |
| 5 | Powiadomienia gościa | Opcje powiadomień gościa |
| 6 | Przyciski „Apply” i „Cancel” | Użytkownik może zaakceptować wprowadzone zmiany, klikając „Apply”, lub je odrzucić, klikając „Cancel” |
Strona „Bookings”
Zakładka „Bookings” wyświetla wszystkie rezerwacje dokonane przez gości (użytkowników zewnętrznych z platformy wynajmu krótkoterminowego).
Widok rezerwacji pozwala sprawdzić, czy automatyzacja działa poprawnie, jaki jest status rezerwacji, czy użytkownik pomyślnie wszedł do obiektu oraz czy rezerwacja została zakończona.
Użytkownicy portalu mogą przeglądać szczegóły dostępu PIN i je aktualizować.
Chociaż system automatycznie synchronizuje listę rezerwacji z platformami wynajmu, użytkownicy mogą wymusić synchronizację ręcznie, jeśli zauważą, że dane są nieaktualne.
| Nazwa | Działanie | |
| 1 | Przycisk ręcznej synchronizacji | Umożliwia wymuszenie synchronizacji obiektu z podłączonym dostawcą usług rezerwacyjnych |
| 2 | Ikona przełączania paska filtrów | Pokazuje/ukrywa pasek filtrów |
| 3 | Filtruj według słowa kluczowego | Wyświetla rezerwacje, których kolumny ID/e-mail zawierają podane słowo kluczowe |
| 4 | Wybór obiektu | Wyświetla wszystkie rezerwacje dla wybranego obiektu wynajmu |
| 5 | Kolumna Booking ID | ID rezerwacji z zewnętrznej platformy wynajmu krótkoterminowego |
| 6 | Kolumna gościa | Adres e-mail gościa |
| 7 | Kolumna apartamentu | Nazwa apartamentu, dla którego utworzono rezerwację |
| 8 | Kolumna rozpoczęcia rezerwacji | Data zameldowania – dostęp w systemie Tedee zacznie obowiązywać od tej daty |
| 9 | Kolumna zakończenia rezerwacji | Data wymeldowania – po tej dacie dostęp w systemie Tedee zakończy się |
| 10 | Pasek statusu | Wyświetla pasek statusu z informacjami o bieżącym stanie rezerwacji |
| 11 | Opcja „Load more” | Jeśli są kolejne rekordy, powinny pojawić się po przewinięciu |
Pasek statusu
| Nazwa | Działanie | |
| 1 | Krok: harmonogram automatyzacji | Wyświetla informacje o harmonogramie automatyzacji.Dostępne są dwa stany:
|
| 2 | Krok: przyznawanie dostępu | Wyświetla szczegółowe informacje o statusie przyznanego dostępu.Dostępne są trzy stany:
Przyznanie dostępu może się nie powieść z powodu trzech błędów:
Jeśli wystąpi błąd, aplikacja automatycznie zaplanuje kolejną próbę połączenia (wyświetli datę następnej próby). Po osiągnięciu maksymalnej liczby ponowień system przestanie wykonywać tę czynność i ukryje informację o następnej próbie. |
| 3 | Krok: check-in | Wyświetla informacje o tym, czy klient zameldował się w obiekcie.Dostępne są dwa stany:
|
Automatyczne przyznawanie dostępu
Automatyczne przyznawanie dostępu rozpoczyna się, gdy na platformie wynajmu krótkoterminowego zostanie utworzona nowa rezerwacja. Cała automatyzacja opiera się na konfiguracji wybranej przez użytkownika.
Pamiętaj, że dostęp do zamka Tedee nie jest tworzony w tym samym momencie, co utworzenie rezerwacji.
Proces automatycznego przyznawania dostępu wygląda następująco:
- System Tedee otrzymuje informację o nowej rezerwacji utworzonej w systemie zarządzania kanałami.
- Informacje o rezerwacji są zapisywane w systemie Tedee.
- Właściciel lub administrator zamka ustala moment, w którym odwiedzający otrzyma dane dostępowe.
- Określoną liczbę dni przed rozpoczęciem rezerwacji gość otrzymuje informację o dostępie do zamka Tedee — szczegóły dostępu są wysyłane automatycznie e-mailem. Poniżej znajduje się szablon przykładowej wiadomości:
- Właściciel zamka może włączyć powiadomienia o pierwszym otwarciu drzwi przez gościa — dzięki temu zna dokładną datę zameldowania.
- Po wymeldowaniu gość traci dostęp do obiektu i nie może ponownie użyć swojego PIN-u.
Edycja klucza API systemu zarządzania kanałami
Edycja klucza API systemu zarządzania kanałami pozwala użytkownikowi odświeżyć integrację, gdy poprzedni klucz wygasł lub gdy usługa została odłączona z powodu nieokreślonego błędu. Tę czynność można wykonać w widoku zarządzania połączeniami — lista podłączonych usług wynajmu powinna być widoczna u góry panelu bocznego. Aby otworzyć stronę edycji, kliknij ikonę trzech kropek w prawym górnym rogu (1), a następnie wybierz Manage connections > ikonę koła zębatego. Po wklejeniu klucza (2) zakończ proces, klikając „Apply” (3).
Odłączanie systemu zarządzania kanałami od konta Tedee
Odłączenie kont spowoduje automatyczne usunięcie wszystkich powiązanych obiektów noclegowych z Tedee Portal. Aby to zrobić, przejdź do Accommodations > Manage connections, kliknij ikonę kosza obok logo systemu zarządzania kanałami i potwierdź usunięcie.
Anulowanie dostępu
Anulowanie dostępu następuje za każdym razem, gdy rezerwacja zostaje usunięta z systemu Tedee.
Dzieje się tak, gdy:
- Rezerwacja na platformie wynajmu krótkoterminowego zostaje anulowana.
- Rezerwacja na platformie wynajmu krótkoterminowego zostaje zakończona.
- Obiekt na platformie wynajmu krótkoterminowego zostaje usunięty.
- Zamek Tedee zostaje odłączony od obiektu.
Proces automatycznego anulowania dostępu wygląda następująco:
- Występuje jedna z powyższych sytuacji.
- Informacje o rezerwacji zostają usunięte z systemu Tedee.
- Jeśli dostęp do zamka Tedee jest tylko zaplanowany i oczekujący, zostaje anulowany.
- Jeśli dostęp do zamka Tedee został już przyznany, zostaje odebrany.
