> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trellistech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guesty

> Colleghi Trellis a Guesty per la sincronizzazione completa di proprietà, prenotazioni e messaggi

Colleghi il Suo account Guesty a Trellis e mantenga coordinati proprietà, prenotazioni, dati degli ospiti e messaggi supportati tramite aggiornamenti Guesty e sincronizzazioni manuali.

## Cosa viene sincronizzato

| Entità                | Direzione        | Cosa include                                                                            |
| --------------------- | ---------------- | --------------------------------------------------------------------------------------- |
| Proprietà             | Guesty → Trellis | Annunci con servizi, foto e indirizzi                                                   |
| Prenotazioni          | Guesty → Trellis | Prenotazioni con informazioni ospite, date e dati finanziari                            |
| Ospiti                | Guesty → Trellis | Profili contatto con email e telefono                                                   |
| Messaggi              | Guesty ↔ Trellis | Le conversazioni con ospiti, fornitori e proprietari fluiscono in entrambe le direzioni |
| Campi personalizzati  | Guesty → Trellis | Campi personalizzati a livello di proprietà e prenotazione                              |
| Recensioni            | Guesty → Trellis | Recensioni degli ospiti con valutazioni                                                 |
| Proprietari           | Guesty → Trellis | Dettagli di contatto dei proprietari degli immobili                                     |
| Richieste informative | Guesty → Trellis | Richieste pre-prenotazione dagli ospiti                                                 |
| Blocchi calendario    | Trellis ↔ Guesty | Blocco e sblocco date con note opzionali                                                |

<Tip>
  I messaggi vengono sincronizzati in entrambe le direzioni - risponda a un ospite in Trellis e apparirà in Guesty, e viceversa. Anche le conversazioni con i proprietari vengono sincronizzate, così può gestire tutta la comunicazione da un'unica posta in arrivo.
</Tip>

## Configurazione

<Steps>
  <Step title="Apra la pagina Integrazioni">
    In Trellis, vada su **Impostazioni > Integrazioni** e selezioni **Guesty**.
  </Step>

  <Step title="Ottenga le credenziali API Guesty">
    Nella Sua dashboard Guesty, vada su **Marketplace > API Keys**. Copi la Sua API key e il secret.
  </Step>

  <Step title="Inserisca le credenziali in Trellis">
    Incolli la Sua API key e il secret di Guesty nei campi forniti, poi clicchi su **Connetti**.
  </Step>

  <Step title="Attenda la sincronizzazione iniziale">
    Trellis importerà le proprietà e le prenotazioni recenti supportate dal provider. I tempi dipendono dal volume API di Guesty, dallo stato dell'integrazione e dalle dimensioni del portafoglio.
  </Step>

  <Step title="Verifichi i dati">
    Controlli le pagine **Proprietà** e **Prenotazioni** in Trellis per confermare che tutto sia stato importato correttamente.
  </Step>
</Steps>

## Cosa aspettarsi dopo la connessione

* Le **proprietà supportate** appaiono in Trellis dopo la sincronizzazione iniziale, complete di foto, servizi e indirizzi
* Le **nuove prenotazioni** vengono sincronizzate automaticamente man mano che arrivano da Guesty
* I **messaggi di ospiti, fornitori e proprietari** appaiono nella Sua posta in arrivo Trellis in modo che il Suo team possa rispondere da un unico posto
* I **campi personalizzati** di Guesty sono disponibili in Trellis per consultazione (con prefisso `gy_cf_` per chiarezza)
* Le **note sulle prenotazioni** di Guesty vengono sincronizzate come note interne sulla prenotazione in Trellis

<Note>
  Dopo la sincronizzazione iniziale, gli aggiornamenti del provider e le sincronizzazioni manuali mantengono aggiornati i record supportati. I tempi dipendono dal volume API di Guesty, dallo stato dell'integrazione e dalle dimensioni del portafoglio.
</Note>

## Sincronizzazione manuale

Può attivare una sincronizzazione manuale in qualsiasi momento da **Impostazioni > Integrazioni > Guesty**. Clicchi sul pulsante **Sincronizza** per aprire la finestra di sincronizzazione, dove sceglie quanto indietro importare i dati.

Opzioni disponibili:

| Opzione        | Cosa viene importato                                              |
| -------------- | ----------------------------------------------------------------- |
| 7 giorni fa    | Prenotazioni dell'ultima settimana                                |
| 30 giorni fa   | Prenotazioni degli ultimi 30 giorni                               |
| 90 giorni fa   | Prenotazioni degli ultimi 90 giorni                               |
| Personalizzato | Un numero personalizzato di giorni specificato da Lei (fino a 90) |

<Tip>
  Utilizzi l'opzione **Personalizzato** per inserire un numero esatto di giorni. Ad esempio, inserisca `45` per importare tutte le prenotazioni degli ultimi 45 giorni.
</Tip>

<Note>
  Le sincronizzazioni Guesty supportano un intervallo massimo di 90 giorni. Per un'importazione storica più ampia, esegua più sincronizzazioni con intervalli di date diversi o contatti il supporto.
</Note>

## Blocco e sblocco del calendario

Può bloccare e sbloccare date sul Suo calendario Guesty direttamente da Trellis - anche attraverso l'[agente AI](/it/platform/ai-agent). Utile per soggiorni del proprietario, periodi di manutenzione o qualsiasi periodo in cui deve togliere un annuncio dal mercato.

Quando blocca delle date, può includere un **motivo** e una **nota**:

* **Motivo** - scelga tra le categorie standard di Guesty (ad esempio, "Blocco proprietario" o "Manutenzione")
* **Nota** - aggiunga dettagli in testo libero che spiegano perché le date sono bloccate (ad esempio, "Ristrutturazione cucina fino al 15")

<Tip>
  Se il motivo del blocco non corrisponde a una delle categorie predefinite di Guesty, Trellis salva automaticamente il testo come nota in modo che venga sempre conservato nel calendario di Guesty.
</Tip>

Per **sbloccare** delle date, chieda all'agente AI o utilizzi il calendario in Trellis per rimuovere un blocco esistente. La modifica viene inviata a Guesty dopo l'elaborazione da parte di Trellis.

***

## Buono a sapersi

* I campi personalizzati attualmente vengono sincronizzati **da Guesty a Trellis** (una sola direzione). La modifica dei campi personalizzati in Trellis non invierà le modifiche a Guesty per il momento.
* Tutte le note sulle prenotazioni da Guesty vengono importate come note interne - sono visibili al Suo team ma non agli ospiti.
* Se aggiunge una nuova proprietà in Guesty, apparirà automaticamente in Trellis durante il prossimo ciclo di sincronizzazione.

<Warning>
  Si assicuri che la Sua API key di Guesty abbia i permessi corretti. Se le proprietà o le prenotazioni non si sincronizzano, verifichi le impostazioni della API key nel Marketplace di Guesty.
</Warning>

## Domande frequenti

<AccordionGroup>
  <Accordion title="Quanto tempo richiede la sincronizzazione iniziale?">
    I tempi della sincronizzazione iniziale dipendono dal volume API di Guesty, dallo stato dell'integrazione e dalle dimensioni del portafoglio. I portafogli grandi possono richiedere piu tempo.
  </Accordion>

  <Accordion title="Posso rispondere a ospiti e proprietari da Trellis?">
    Sì! I messaggi vengono sincronizzati in entrambe le direzioni per le conversazioni con ospiti, fornitori e proprietari. Quando risponde in Trellis, il messaggio appare anche in Guesty.
  </Accordion>

  <Accordion title="Cosa succede se aggiorno una prenotazione in Guesty?">
    Le modifiche apportate in Guesty - come cambi di date, aggiornamenti degli ospiti o cambi di stato - vengono sincronizzate automaticamente con Trellis.
  </Accordion>

  <Accordion title="I campi personalizzati sono modificabili in Trellis?">
    I campi personalizzati da Guesty sono attualmente in sola lettura in Trellis. Può visualizzarli, ma le modifiche devono essere effettuate in Guesty.
  </Accordion>

  <Accordion title="Posso bloccare e sbloccare date da Trellis?">
    Sì. Può bloccare date sul Suo calendario Guesty con un motivo e una nota opzionale, e sbloccarle quando è pronto. Può farlo attraverso l'agente AI chiedendogli di bloccare o sbloccare date specifiche su una proprietà. Le modifiche vengono inviate a Guesty dopo l'elaborazione da parte di Trellis.
  </Accordion>

  <Accordion title="Posso ri-sincronizzare i miei dati manualmente?">
    Sì. Vada in **Impostazioni > Integrazioni > Guesty** e clicchi su **Sincronizza**. Può scegliere un intervallo predefinito (7, 30 o 90 giorni) o inserire un numero personalizzato di giorni fino a 90.
  </Accordion>

  <Accordion title="Posso disconnettere e ricollegare in seguito?">
    Sì. Può disconnettere l'integrazione in qualsiasi momento da **Impostazioni > Integrazioni**. I dati esistenti in Trellis rimarranno, e potrà ricollegarsi quando sarà pronto.
  </Accordion>

  <Accordion title="Le recensioni Guesty supportate saranno visualizzate?">
    Sì - le recensioni Guesty supportate vengono sincronizzate con Trellis quando Guesty le espone tramite l'integrazione.
  </Accordion>
</AccordionGroup>