Guesty
Integrazione
Avvia l’integrazione effettuando l’accesso al tuo account Guesty all’indirizzo https://app.guesty.com/auth/login.
Una volta effettuato l’accesso, nell’angolo in alto a destra dello schermo, apri il menu “Integrations” e seleziona “Marketplace”.
Nella barra di ricerca del Marketplace, digita Tedee e seleziona l’integrazione Tedee dai risultati filtrati.
Fai clic sul pulsante “Connect” sul lato destro dello schermo.
La piattaforma Guesty genererà quindi la tua chiave API univoca, un codice necessario per l’integrazione tra le piattaforme Guesty e Tedee.
Hai ora 3 ore per configurare l’integrazione nel Tedee Portal. Copia la chiave API di Guesty negli appunti del tuo computer.
Nota: Se hai bisogno di accedere di nuovo alla chiave API di Guesty durante queste 3 ore dopo la sua generazione, fai clic su “View API key (integration token)” per visualizzarla di nuovo.
Se non riesci a integrare le piattaforme entro 3 ore, fai clic su “Disconnect”, quindi su “Connect” di nuovo per generare un nuovo codice, valido per le successive 3 ore.
Puoi anche disconnettere le piattaforme in qualsiasi momento e disattivare l’automazione di gestione degli accessi.
Una volta generata la chiave API di Guesty, vai al Tedee Portal all’indirizzo https://portal.tedee.com ed effettua l’accesso con il tuo account Tedee.
Poi, nel menu della barra laterale sinistra, seleziona l’opzione “Short-term rentals” e scegli “Guesty”.
Nel menu della barra laterale, incolla la chiave API di Guesty generata in precedenza e fai clic su “Connect”.
Guesty e Tedee si integreranno ora e sincronizzeranno i tuoi annunci di affitto.
Verrai reindirizzato alla vista “Accommodations”. Tutti gli alloggi saranno sincronizzati automaticamente dalla piattaforma di affitti a breve termine.
Pagina “Accommodations”
La pagina “Accommodations” elenca tutti gli appartamenti in affitto sincronizzati dell’utente su tutti i servizi di affitto collegati.
La scheda “Accommodations” contiene le proprietà che sono state correttamente collegate al sistema Tedee. Ciò significa che sono pronte ad accettare nuove prenotazioni e che l’automazione funziona correttamente.
| Nome | Azione | |
| 1 | Icona mostra/nascondi barra dei filtri | Mostra/nasconde la barra dei filtri |
| 2 | Pulsante di sincronizzazione manuale | Consente di forzare la sincronizzazione del tuo alloggio con un fornitore di servizi di prenotazione collegato |
| 3 | Filtra per parola chiave | Mostra tutti gli alloggi filtrati in base alla parola chiave selezionata |
| 4 | Filtra per automazione | Filtra l’elenco per alloggi automatizzati/non automatizzati |
| 5 | Filtra per piattaforma | Filtra l’elenco per piattaforme di affitto collegate |
| 6 | Colonna nome appartamento | Il nome dell’appartamento sincronizzato dall’integrazione per affitti a breve termine. Si consiglia che i nomi delle strutture siano diversi: questo renderà l’intero processo più facile da gestire |
| 7 | Colonna serratura | Nome della serratura collegata all’appartamento |
| 8 | Colonna piattaforma | Logo della piattaforma di affitti a breve termine a cui è collegato l’appartamento |
| 9 | Nome appartamento | Nome dell’appartamento collegato alla serratura |
| 10 | Menu contestuale | Mostra il menu contestuale per l’alloggio selezionato |
| 11 | Modifica alloggio | Apre la barra laterale con l’alloggio selezionato, dove gli utenti possono sincronizzare o modificare le proprietà dell’alloggio |
| 12 | Mostra prenotazioni | Reindirizza l’utente alla vista delle prenotazioni dell’appartamento selezionato |
| 13 | Opzione “Load more” | Se ci sono più record, dovrebbero apparire dopo lo scorrimento |
| 14 | Cancella tutti i filtri | Reimposta lo stato di tutti i filtri selezionati |
Vista “No bookings found”
La vista “Accommodations” consente di filtrare i dati in base a due colonne: Nome appartamento e Piattaforma.
L’utente può filtrare in due modi:
- selezionare l’opzione “Filter by name”
- selezionare “Platform” e fare clic su un sistema di gestione dei canali nell’elenco a discesa
L’obiettivo principale della sincronizzazione è mantenere lo stesso stato nella piattaforma di affitti a breve termine e nel Tedee Portal.
Dal punto di vista dell’utente del Tedee Portal, il processo di sincronizzazione degli alloggi è semplice. Aggiorna l’elenco degli alloggi disponibili dalla piattaforma di affitti a breve termine nel Tedee Portal. Dopo aver fatto clic sul pulsante “Sync”, inizia il processo di sincronizzazione. Il sistema Tedee dovrebbe riflettere tutti gli aggiornamenti effettuati sulla piattaforma di affitti a breve termine. Ad esempio, tutti gli alloggi eliminati dovrebbero scomparire dall’elenco nel Tedee Portal e quelli appena creati dovrebbero apparire al loro posto.
Impostazioni di automazione dell’affitto
Dopo aver fatto clic sulla riga con il nome della struttura, apparirà un pannello sul lato destro dello schermo. Contiene le impostazioni di automazione dell’affitto che l’utente può modificare.
Le opzioni di affitto che l’utente può modificare sono:
- Collegare/scollegare l’alloggio e la smart lock. Il collegamento della smart lock è obbligatorio affinché l’automazione tra il sistema di gestione dei canali e il sistema Tedee funzioni correttamente. L’utente vedrà solo le serrature di cui è proprietario. Per collegare la serratura all’alloggio, deve essere abbinata al bridge e al keypad.
- Quanti giorni prima dell’inizio della prenotazione l’ospite deve ricevere i dati di accesso.
- Gestione delle notifiche.
Scollegare la serratura dal sistema di affitto annulla tutte le prenotazioni e l’accesso concesso per tali prenotazioni.
| Nome | Azione | |
| 1 | Nome alloggio | Nome dell’alloggio sincronizzato dal sistema di affitti a breve termine (campo di sola lettura) |
| 2 | Smart lock collegata | Il nome della smart lock assegnata all’alloggio |
| 3 | Sezione “Giorni prima della prenotazione per concedere l’accesso” | Il numero di giorni prima del quale gli ospiti riceveranno l’accesso alla serratura dal sistema Tedee |
| 4 | Notifiche del proprietario | Opzioni di notifica del proprietario |
| 5 | Notifiche dell’ospite | Opzioni di notifica dell’ospite |
| 6 | Pulsante “Apply” o “Cancel” | L’utente può accettare le modifiche introdotte facendo clic su “Apply” e annullarle facendo clic su “Cancel” |
Pagina “Bookings”
La scheda “Bookings” mostra tutte le prenotazioni effettuate dagli ospiti (utenti esterni della piattaforma di affitti a breve termine).
La vista delle prenotazioni consente di verificare se l’automazione funziona correttamente, lo stato della prenotazione, se l’utente è entrato correttamente nella struttura e se la prenotazione è stata completata.
Gli utenti del portale possono visualizzare i dettagli di accesso tramite PIN e aggiornarli.
Sebbene il sistema sincronizzi automaticamente l’elenco delle prenotazioni con le piattaforme di affitto, gli utenti possono forzare la sincronizzazione manualmente se notano che i dati non sono aggiornati.
| Nome | Azione | |
| 1 | Pulsante di sincronizzazione manuale | Consente di forzare la sincronizzazione del tuo alloggio con un fornitore di servizi di prenotazione collegato |
| 2 | Icona mostra/nascondi barra dei filtri | Mostra/nasconde la barra dei filtri |
| 3 | Filtra per parola chiave | Mostra tutte le prenotazioni le cui colonne ID/e-mail corrispondono alla parola chiave |
| 4 | Selezione alloggio | Mostra tutte le prenotazioni per un elemento di affitto selezionato |
| 5 | Colonna Booking ID | Booking ID dalla piattaforma esterna di affitti a breve termine |
| 6 | Colonna ospite | E-mail dell’ospite |
| 7 | Colonna appartamento | Nome dell’appartamento in cui viene creata la prenotazione |
| 8 | Colonna inizio prenotazione | Data di check-in – l’accesso al sistema Tedee inizierà da questa data |
| 9 | Colonna fine prenotazione | Data di check-out – dopo questa data, l’accesso al sistema Tedee terminerà |
| 10 | Barra di stato | Mostra una barra di stato con informazioni sullo stato attuale della prenotazione |
| 11 | Opzioni “Load more” | Se ci sono più record, dovrebbero apparire dopo lo scorrimento |
Barra di stato
| Nome | Azione | |
| 1 | Passaggio di pianificazione dell’automazione | Mostra informazioni sulla pianificazione dell’automazione.
Sono disponibili due stati:
|
| 2 | Passaggio di concessione dell’accesso | Mostra informazioni dettagliate sullo stato dell’accesso concesso.
Sono disponibili tre stati:
La concessione dell’accesso può non riuscire a causa di tre errori:
In caso di errore, l’applicazione pianificherà automaticamente il prossimo tentativo di connessione (mostrerà la data del prossimo tentativo). Quando viene raggiunto il numero massimo di tentativi, il sistema interromperà questa azione e nasconderà le informazioni sul prossimo tentativo. |
| 3 | Passaggio di check-in | Mostra informazioni sul fatto che il cliente abbia effettuato il check-in.
Sono disponibili due stati:
|
Concessione automatica dell’accesso
La concessione automatica dell’accesso inizia quando viene creata una nuova prenotazione sulla piattaforma di affitti a breve termine. Tutta l’automazione si basa sulla configurazione scelta dall’utente.
Nota che l’accesso alla serratura Tedee non viene creato nello stesso momento in cui viene effettuata la prenotazione.
Il processo di concessione automatica dell’accesso è il seguente:
- Il sistema Tedee riceve informazioni su una nuova prenotazione creata nel sistema di gestione dei canali.
- Le informazioni della prenotazione vengono salvate nel sistema Tedee.
- Il proprietario o l’amministratore della serratura stabilisce il momento in cui il visitatore riceve i dati di accesso.
- Un numero selezionato di giorni prima dell’inizio della prenotazione, l’ospite riceve le informazioni di accesso alla serratura Tedee — i dettagli di accesso vengono inviati automaticamente via e-mail. Ecco un modello di messaggio di esempio:
- Il proprietario della serratura può attivare le notifiche per la prima volta in cui l’ospite sblocca la porta — così conosce la data esatta del check-in.
- Al check-out, l’ospite perde l’accesso alla proprietà e non può utilizzare di nuovo il proprio PIN.
Modifica della chiave API del sistema di gestione dei canali
La modifica della chiave API del sistema di gestione dei canali consente all’utente di aggiornare l’integrazione quando la chiave precedente è scaduta o quando un servizio è stato disconnesso a causa di un errore non specificato. Questa azione può essere eseguita dalla vista di gestione delle connessioni: l’elenco dei servizi di affitto collegati dovrebbe essere visibile nella parte superiore della barra laterale. Per aprire la pagina di modifica, fai clic sull’icona con i tre puntini nell’angolo in alto a destra (1) e seleziona Manage connections > icona dell’ingranaggio. Dopo aver incollato la chiave (2), completa il processo facendo clic su Apply (3).
Scollegamento del sistema di gestione dei canali dall’account Tedee
Lo scollegamento degli account rimuoverà automaticamente tutti gli alloggi correlati collegati al Tedee Portal. Per farlo, vai su Accommodations > Manage connections, fai clic sull’icona del cestino accanto al logo del sistema di gestione dei canali e conferma l’eliminazione.
Annullamento dell’accesso
L’annullamento dell’accesso si verifica ogni volta che una prenotazione viene rimossa dal sistema Tedee.
Questo accade quando:
- La prenotazione sulla piattaforma di affitti a breve termine viene annullata.
- La prenotazione sulla piattaforma di affitti a breve termine viene completata.
- L’alloggio sulla piattaforma di affitti a breve termine viene eliminato.
- La serratura Tedee viene scollegata dall’alloggio.
Il processo di annullamento automatico dell’accesso è il seguente:
- Si verifica una delle situazioni sopra indicate.
- Le informazioni della prenotazione vengono eliminate dal sistema Tedee.
- Se l’accesso a una serratura Tedee è solo pianificato e in sospeso, viene annullato.
- Se l’accesso alla serratura Tedee è già stato concesso, viene revocato.
