Guesty
Integratie
Begin de integratie door in te loggen op je Guesty-account via https://app.guesty.com/auth/login.
Wanneer je bent ingelogd, open je rechtsboven op het scherm het menu “Integrations” en selecteer je “Marketplace”.
Typ in de zoekbalk van Marketplace Tedee en selecteer de Tedee-integratie uit de gefilterde resultaten.
Klik op de knop “Connect” aan de rechterkant van het scherm.
Het Guesty-platform genereert vervolgens je unieke API-sleutel – een code die nodig is voor integratie tussen de Guesty- en Tedee-platformen.
Je hebt nu 3 uur om de integratie in het Tedee Portal in te stellen. Kopieer de Guesty API-sleutel naar het klembord van je computer.
Opmerking: Als je binnen deze 3 uur na het genereren opnieuw toegang nodig hebt tot de Guesty API-sleutel, klik dan op “View API key (integration token)” om deze opnieuw te bekijken.
Als het niet lukt om de platformen binnen 3 uur te integreren, klik dan op “Disconnect” en vervolgens opnieuw op “Connect” om een nieuwe code te genereren, geldig voor de volgende 3 uur.
Je kunt de platformen ook op elk moment loskoppelen en de automatisering voor toegangsbeheer deactiveren.
Zodra je Guesty API-sleutel is gegenereerd, ga je naar het Tedee Portal via https://portal.tedee.com en log je in met je Tedee-account.
Selecteer vervolgens in het linkermenu in de zijbalk de optie “Short-term rentals” en kies “Guesty”.
Plak in het menu van de zijbalk de eerder gegenereerde Guesty API-sleutel en klik op “Connect”.
Guesty en Tedee worden nu geïntegreerd en je verhuuradvertenties worden gesynchroniseerd.
Je wordt doorgestuurd naar de weergave “Accommodations”. Alle accommodaties worden automatisch gesynchroniseerd vanuit het platform voor kortetermijnverhuur.
Accommodations-pagina
De pagina “Accommodations” toont alle gesynchroniseerde verhuurappartementen van de gebruiker, over alle gekoppelde verhuurdiensten heen.
Het tabblad “Accommodations” bevat accommodaties die correct aan het Tedee-systeem zijn gekoppeld. Dit betekent dat ze klaar zijn om nieuwe boekingen te ontvangen en dat de automatisering correct werkt.
| Naam | Actie | |
| 1 | Pictogram filterbalk tonen/verbergen | Toont/verbergt de filterbalk |
| 2 | Knop handmatige synchronisatie | Maakt het mogelijk om de synchronisatie van je accommodatie met een gekoppelde aanbieder van reserveringsdiensten te forceren |
| 3 | Filteren op trefwoord | Toont alle accommodaties gefilterd op het geselecteerde trefwoord |
| 4 | Filteren op automatisering | Filtert de lijst op geautomatiseerde/niet-geautomatiseerde accommodaties |
| 5 | Filteren op platform | Filtert de lijst op gekoppelde verhuurplatformen |
| 6 | Kolom appartementnaam | De appartementnaam die is gesynchroniseerd vanuit de integratie voor kortetermijnverhuur. Het wordt aanbevolen dat de namen van de objecten van elkaar verschillen – dit maakt het hele proces eenvoudiger te beheren |
| 7 | Kolom slot | Naam van het slot dat aan het appartement is gekoppeld |
| 8 | Kolom platform | Logo van het platform voor kortetermijnverhuur waarmee het appartement is gekoppeld |
| 9 | Appartementnaam | Naam van het appartement dat aan het slot is gekoppeld |
| 10 | Contextmenu | Toont het contextmenu voor de geselecteerde accommodatie |
| 11 | Accommodatie bewerken | Opent de zijbalk met de geselecteerde accommodatie waar gebruikers accommodaties kunnen synchroniseren of accommodatiewaarden kunnen bewerken |
| 12 | Boekingen tonen | Stuurt de gebruiker door naar de boekingsweergave voor het geselecteerde appartement |
| 13 | Optie “Load more” | Als er meer records zijn, moeten ze na het scrollen verschijnen |
| 14 | Alle filters wissen | Reset de status van alle geselecteerde filters |
Weergave “No bookings found”
In de weergave “Accommodations” kun je gegevens filteren op twee kolommen: Appartementnaam en Platform.
De gebruiker kan op twee manieren filteren:
- selecteer de optie “Filter by name”
- selecteer “Platform” en klik in de vervolgkeuzelijst op een channel management system
Het belangrijkste doel van synchronisatie is om dezelfde status te behouden op het platform voor kortetermijnverhuur en in het Tedee Portal.
Vanuit het perspectief van de Tedee Portal-gebruiker is het synchronisatieproces van accommodaties eenvoudig. Het ververst de lijst met beschikbare accommodaties van het platform voor kortetermijnverhuur naar het Tedee Portal. Na het klikken op de knop “Sync” start het synchronisatieproces. Het Tedee-systeem moet alle updates weerspiegelen die zijn gemaakt op het platform voor kortetermijnverhuur. Zo moeten alle verwijderde accommodaties uit de lijst in het Tedee Portal verdwijnen en nieuw aangemaakte accommodaties op hun plaats verschijnen.
Instellingen voor verhuurautomatisering
Na het klikken op de rij met de naam van de accommodatie verschijnt er rechts op het scherm een paneel. Dit bevat de instellingen voor verhuurautomatisering die de gebruiker kan aanpassen.
Verhuuropties die de gebruiker kan wijzigen zijn:
- Het koppelen/ontkoppelen van de verhuuraccommodatie en het smart lock. Het koppelen van het smart lock is verplicht om de automatisering tussen het channel management system en het Tedee-systeem correct te laten werken. De gebruiker ziet alleen de sloten die hij/zij bezit. Om het slot aan de accommodatie te koppelen, moet het gekoppeld zijn met de bridge en de keypad.
- Hoeveel dagen vóór de start van de boeking de gast de toegangsgegevens moet ontvangen.
- Beheer van meldingen.
Het ontkoppelen van het slot van het verhuursysteem annuleert alle reserveringen en de voor deze reserveringen verleende toegang.
| Naam | Actie | |
| 1 | Naam van de accommodatie | Naam van de accommodatie gesynchroniseerd vanuit het kortetermijnverhuursysteem (alleen-lezen veld) |
| 2 | Gekoppeld smart lock | De naam van het smart lock dat aan de accommodatie is toegewezen |
| 3 | Sectie ‘Dagen vóór boeking voor toegang verlenen’ | Het aantal dagen vóór de boeking waarop gasten toegang tot het slot ontvangen vanuit het Tedee-systeem |
| 4 | Meldingen voor eigenaar | Opties voor meldingen voor de eigenaar |
| 5 | Meldingen voor gast | Opties voor meldingen voor de gast |
| 6 | Knop “Apply” of “Cancel” | De gebruiker kan de aangebrachte wijzigingen accepteren door op “Apply” te klikken en ze verwerpen door op “Cancel” te klikken |
Bookings-pagina
Het tabblad “Bookings” toont alle boekingen die door gasten zijn gemaakt (externe gebruikers van het platform voor kortetermijnverhuur).
In de boekingsweergave kun je controleren of de automatisering correct werkt, wat de boekingsstatus is, of de gebruiker de accommodatie succesvol heeft betreden en of de boeking is voltooid.
Portaalgebruikers kunnen PIN-toegangsdetails bekijken en bijwerken.
Hoewel het systeem de boekingslijst automatisch synchroniseert met de verhuurplatformen, kunnen gebruikers de synchronisatie handmatig forceren als ze merken dat de gegevens verouderd zijn.
| Naam | Actie | |
| 1 | Knop handmatige synchronisatie | Maakt het mogelijk om de synchronisatie van je accommodatie met een gekoppelde aanbieder van reserveringsdiensten te forceren |
| 2 | Pictogram filterbalk tonen/verbergen | Toont/verbergt de filterbalk |
| 3 | Filteren op trefwoord | Toont alle boekingen waarvan de kolommen ID/e-mail overeenkomen met het trefwoord |
| 4 | Accommodatie selecteren | Toont alle boekingen voor een geselecteerd verhuurobject |
| 5 | Kolom Booking ID | Booking ID van het externe platform voor kortetermijnverhuur |
| 6 | Gast-kolom | E-mailadres van de gast |
| 7 | Appartement-kolom | Appartementnaam waarin de boeking is aangemaakt |
| 8 | Kolom boeking start | Check-in-datum – toegang in het Tedee-systeem start vanaf deze datum |
| 9 | Kolom boeking eindigt | Check-out-datum – na deze datum eindigt de toegang in het Tedee-systeem |
| 10 | Statusbalk | Toont een statusbalk met informatie over de huidige boekingsstatus |
| 11 | Opties “Load more” | Als er meer records zijn, moeten ze na het scrollen verschijnen |
Statusbalk
| Naam | Actie | |
| 1 | Stap: automatiseringsschema | Toont informatie over het automatiseringsschema.
Twee statussen zijn beschikbaar:
|
| 2 | Stap: toegang verlenen | Toont gedetailleerde informatie over de status van verleende toegang.
Drie statussen zijn beschikbaar:
Het verlenen van toegang kan mislukken door drie fouten:
Als er een fout optreedt, plant de applicatie automatisch de volgende verbindingspoging (de datum van de volgende poging wordt weergegeven). Wanneer het maximale aantal pogingen is bereikt, stopt het systeem met deze actie en verbergt het informatie over de volgende poging. |
| 3 | Stap: check-in | Toont informatie over of de klant in de accommodatie heeft ingecheckt.
Twee statussen zijn beschikbaar:
|
Automatische toegang verlenen
Automatisch toegang verlenen start wanneer een nieuwe boeking wordt aangemaakt op het platform voor kortetermijnverhuur. Alle automatisering is gebaseerd op de configuratie die door de gebruiker is gekozen.
Let op: toegang tot het Tedee-slot wordt niet op hetzelfde moment aangemaakt als de boeking.
Het proces voor het automatisch verlenen van toegang is als volgt:
- Het Tedee-systeem ontvangt informatie over een nieuwe boeking die is aangemaakt in het channel management system.
- De boekingsinformatie wordt opgeslagen in het Tedee-systeem.
- De eigenaar of beheerder van het slot bepaalt het moment waarop de bezoeker de toegangsgegevens ontvangt.
- Een geselecteerd aantal dagen vóór de start van de reservering ontvangt de gast toegangsinformatie voor het Tedee-slot — toegangsgegevens worden automatisch per e-mail verzonden. Hieronder staat een sjabloon van een voorbeeldbericht:
- De sloteigenaar kan meldingen inschakelen voor de eerste keer dat de gast de deur ontgrendelt — zodat hij/zij de exacte check-in-datum kent.
- Bij check-out verliest de gast toegang tot de accommodatie en kan de PIN niet opnieuw gebruiken.
API-sleutel van het channel management system bewerken
Door de API-sleutel van het channel management system te bewerken kan de gebruiker de integratie vernieuwen wanneer de vorige sleutel is verlopen, of wanneer een dienst is losgekoppeld door een niet-gespecificeerde fout. Deze actie kan worden uitgevoerd vanuit de weergave voor verbindingsbeheer — de lijst met gekoppelde verhuurdiensten moet bovenaan de zijbalk zichtbaar zijn. Om de bewerkingspagina te openen, klik je op het pictogram met de drie puntjes rechtsboven (1) en selecteer je Manage connections > tandwielpictogram. Nadat je de sleutel hebt geplakt (2), rond je het proces af door op Apply (3) te klikken.
Channel management system loskoppelen van Tedee-account
Het loskoppelen van accounts verwijdert automatisch alle gerelateerde accommodaties die aan het Tedee Portal zijn gekoppeld. Ga hiervoor naar Accommodations > Manage connections, klik op het prullenbakpictogram naast het logo van het channel management system en bevestig het verwijderen.
Annulering van toegang
Annulering van toegang vindt plaats telkens wanneer een boeking uit het Tedee-systeem wordt verwijderd.
Dit gebeurt wanneer:
- De reservering op het platform voor kortetermijnverhuur wordt geannuleerd.
- De reservering op het platform voor kortetermijnverhuur is voltooid.
- De accommodatie op het platform voor kortetermijnverhuur wordt verwijderd.
- Het Tedee-slot wordt losgekoppeld van de accommodatie.
Het proces voor het automatisch annuleren van toegang is als volgt:
- Een van de bovenstaande situaties doet zich voor.
- De boekingsinformatie wordt uit het Tedee-systeem verwijderd.
- Als toegang tot een Tedee-slot alleen gepland is en in afwachting is, wordt deze geannuleerd.
- Als toegang tot het Tedee-slot al is verleend, wordt deze ingetrokken.
