Panoramica
Quando apri la pagina "Integrazione Marketplace" in Guesty per un'integrazione già connessa, vedrai un pulsante con l'etichetta "Visualizza chiave API (token integrazione)". Cliccando su questo pulsante, viene visualizzato l'ultimo token generato per l'integrazione.
Questo articolo spiega a cosa serve questo token, perché scade e cosa fare se è necessario generarne uno nuovo.
A cosa serve il token di integrazione?
Il token di integrazione (chiave API) viene utilizzato solo per la connessione/autorizzazione iniziale tra Guesty e la piattaforma del Partner. Una volta stabilita correttamente l'integrazione tramite questo token, il suo compito è terminato: non viene utilizzato per mantenere l'integrazione attiva in modo continuativo.
Perché il token scade dopo 4 ore?
Per motivi di sicurezza, ogni token di integrazione scade automaticamente 4 ore dopo la sua generazione. Questo intervallo di 4 ore ti dà il tempo di copiare il token e inserirlo sul lato del Partner per completare la connessione.
Se visualizzi il token dopo che sono trascorse queste 4 ore, vedrai un messaggio che indica che il token è scaduto.
Importante: un token scaduto non significa che l'integrazione sia disconnessa o non funzioni. Significa semplicemente che quello specifico token non è più valido e non può essere utilizzato/non verrà più accettato dal Partner; ciò non ha alcuna influenza sulla connessione attiva in corso tra Guesty e il Partner.
Quando hai effettivamente bisogno di un nuovo token?
È necessario generare un nuovo token di integrazione solo se si riscontra un problema di connessione, ad esempio:
- Stai configurando l'integrazione per la prima volta e non hai ancora finito di inserire il token dal lato del Partner, oppure
- Nella dashboard del Partner viene visualizzato un messaggio che indica che l'integrazione è disconnessa o che è necessaria una nuova chiave API.
Se l'integrazione funziona correttamente, un token scaduto visualizzato in questa pagina non richiede alcuna azione.
Come generare un nuovo token integrazione
Se hai bisogno di un nuovo token, segui questi passaggi:
- Accedi alla pagina integrazione pertinente in Guesty.
- Fai clic su Disconnetti.
- Nella finestra a comparsa, seleziona la casella per confermare di aver letto il messaggio > fai clic su Disconnetti.
- Aggiorna forzatamente la pagina.
- Fai clic su Connetti. Questo avvierà la generazione di un nuovo token integrazione da Guesty.
- Copia il nuovo token e inseriscilo nel campo appropriato sull'app del Partner oppure condividilo con il team di supporto del Partner, se necessario.
Nota: il nuovo token scadrà 4 ore dopo la sua generazione, pertanto si consiglia di completare la connessione lato Partner il prima possibile dopo averlo generato.