> ## 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

> Connectez Trellis a Guesty pour une synchronisation complete des proprietes, reservations et messages

Connectez votre compte Guesty a Trellis et gardez les proprietes, reservations, donnees voyageurs et messages pris en charge coordonnes via les mises a jour Guesty et les synchronisations manuelles.

## Ce qui se synchronise

| Entite               | Direction        | Ce qui est inclus                                                         |
| -------------------- | ---------------- | ------------------------------------------------------------------------- |
| Proprietes           | Guesty → Trellis | Annonces avec equipements, photos et adresses                             |
| Reservations         | Guesty → Trellis | Reservations avec infos voyageur, dates et donnees financieres            |
| Voyageurs            | Guesty → Trellis | Profils de contact avec e-mail et telephone                               |
| Messages             | Guesty ↔ Trellis | Conversations voyageurs, prestataires et proprietaires dans les deux sens |
| Champs personnalises | Guesty → Trellis | Champs personnalises au niveau propriete et reservation                   |
| Avis                 | Guesty → Trellis | Avis voyageurs avec notes                                                 |
| Proprietaires        | Guesty → Trellis | Coordonnees des proprietaires                                             |
| Demandes             | Guesty → Trellis | Demandes de pre-reservation des voyageurs                                 |
| Blocages calendrier  | Trellis ↔ Guesty | Bloquer et debloquer des dates avec notes optionnelles                    |

<Tip>
  Les messages se synchronisent dans les deux sens -- repondez a un voyageur dans Trellis et cela apparait dans Guesty, et inversement. Les conversations proprietaires se synchronisent aussi.
</Tip>

## Configuration

<Steps>
  <Step title="Ouvrir la page Integrations">
    Dans Trellis, accedez a **Parametres > Integrations** et selectionnez **Guesty**.
  </Step>

  <Step title="Obtenir vos identifiants API Guesty">
    Dans votre tableau de bord Guesty, accedez a **Marketplace > Cles API**. Copiez votre cle API et votre secret.
  </Step>

  <Step title="Saisir vos identifiants dans Trellis">
    Collez votre cle API et votre secret Guesty dans les champs fournis, puis cliquez sur **Connecter**.
  </Step>

  <Step title="Attendre la synchronisation initiale">
    Trellis importera les proprietes et reservations recentes prises en charge par le fournisseur. Le delai depend du volume de l'API Guesty, de l'etat de l'integration et de la taille du portefeuille.
  </Step>

  <Step title="Verifier vos donnees">
    Consultez vos pages **Proprietes** et **Reservations** dans Trellis pour confirmer que tout est correct.
  </Step>
</Steps>

## A quoi s'attendre apres la connexion

* Les **proprietes prises en charge** apparaissent dans Trellis apres la synchronisation initiale, avec photos, equipements et adresses
* Les **nouvelles reservations** se synchronisent automatiquement
* Les **messages** voyageurs, prestataires et proprietaires apparaissent dans votre boite de reception Trellis
* Les **champs personnalises** de Guesty sont disponibles dans Trellis (prefixes `gy_cf_`)
* Les **notes de reservation** de Guesty se synchronisent comme notes internes

<Note>
  Apres la synchronisation initiale, les mises a jour du fournisseur et les synchronisations manuelles gardent les donnees prises en charge a jour. Le delai depend du volume API Guesty, de l'etat de l'integration et de la taille du portefeuille.
</Note>

## Synchronisation manuelle

Vous pouvez declencher une synchronisation manuelle a tout moment depuis **Parametres > Integrations > Guesty**. Cliquez sur le bouton **Synchroniser** pour ouvrir la fenetre de synchronisation, ou vous choisissez jusqu'ou remonter pour importer les donnees.

Options disponibles :

| Option       | Ce qui est importe                                              |
| ------------ | --------------------------------------------------------------- |
| 7 jours      | Reservations de la derniere semaine                             |
| 30 jours     | Reservations des 30 derniers jours                              |
| 90 jours     | Reservations des 90 derniers jours                              |
| Personnalise | Un nombre de jours personnalise que vous specifiez (jusqu'a 90) |

<Tip>
  Utilisez l'option **Personnalise** pour saisir un nombre exact de jours. Par exemple, saisissez `45` pour importer toutes les reservations des 45 derniers jours.
</Tip>

<Note>
  Les synchronisations Guesty prennent en charge une plage maximale de 90 jours. Pour un import historique plus large, effectuez plusieurs synchronisations avec differentes plages de dates ou contactez le support.
</Note>

## Blocage et deblocage de calendrier

Vous pouvez bloquer et debloquer des dates sur votre calendrier Guesty directement depuis Trellis -- y compris via l'[agent IA](/fr/platform/ai-agent). Utile pour les sejours proprietaires, les periodes de maintenance ou toute periode ou vous devez retirer une annonce.

Lors du blocage, vous pouvez inclure une **raison** et une **note** :

* **Raison** -- choisissez parmi les categories standard Guesty (par exemple, "Blocage proprietaire" ou "Maintenance")
* **Note** -- ajoutez des details en texte libre expliquant le blocage (par exemple, "Renovation cuisine jusqu'au 15")

<Tip>
  Si votre raison de blocage ne correspond pas a une categorie predefined Guesty, Trellis sauvegarde automatiquement votre texte comme note.
</Tip>

Pour **debloquer** des dates, demandez a l'agent IA ou utilisez le calendrier dans Trellis. La modification est envoyee a Guesty apres traitement par Trellis.

***

## Bon a savoir

* Les champs personnalises se synchronisent actuellement **de Guesty vers Trellis** (sens unique). Les modifications dans Trellis ne sont pas poussees vers Guesty.
* Toutes les notes de reservation Guesty sont importees comme notes internes -- visibles par votre equipe mais pas par les voyageurs.
* Si vous ajoutez une nouvelle propriete dans Guesty, elle apparaitra automatiquement dans Trellis lors du prochain cycle de synchronisation.

<Warning>
  Assurez-vous que votre cle API Guesty a les bonnes permissions. Si les proprietes ou reservations ne se synchronisent pas, verifiez vos parametres de cle API dans le Marketplace Guesty.
</Warning>

## Foire aux questions

<AccordionGroup>
  <Accordion title="Combien de temps dure la synchronisation initiale ?">
    Le delai de synchronisation initiale depend du volume de l'API Guesty, de l'etat de l'integration et de la taille du portefeuille. Les grands portefeuilles peuvent prendre plus longtemps.
  </Accordion>

  <Accordion title="Puis-je repondre aux voyageurs et proprietaires depuis Trellis ?">
    Oui ! Les messages se synchronisent dans les deux sens. Quand vous repondez dans Trellis, le message apparait dans Guesty.
  </Accordion>

  <Accordion title="Que se passe-t-il si je modifie une reservation dans Guesty ?">
    Les modifications dans Guesty -- changements de dates, mises a jour voyageur ou changements de statut -- se synchronisent automatiquement avec Trellis.
  </Accordion>

  <Accordion title="Les champs personnalises sont-ils modifiables dans Trellis ?">
    Les champs personnalises de Guesty sont actuellement en lecture seule dans Trellis. Les modifications doivent etre faites dans Guesty.
  </Accordion>

  <Accordion title="Puis-je bloquer et debloquer des dates depuis Trellis ?">
    Oui. Vous pouvez bloquer des dates sur votre calendrier Guesty avec une raison et une note optionnelle, et les debloquer quand vous etes pret. Vous pouvez le faire via l'agent IA. Les modifications sont envoyees a Guesty apres traitement par Trellis.
  </Accordion>

  <Accordion title="Puis-je re-synchroniser mes donnees manuellement ?">
    Oui. Allez dans **Parametres > Integrations > Guesty** et cliquez sur **Synchroniser**. Vous pouvez choisir une plage predefinie (7, 30 ou 90 jours) ou saisir un nombre personnalise de jours jusqu'a 90.
  </Accordion>

  <Accordion title="Puis-je me deconnecter et me reconnecter plus tard ?">
    Oui. Vous pouvez deconnecter l'integration a tout moment depuis **Parametres > Integrations**. Vos donnees existantes dans Trellis sont conservees.
  </Accordion>

  <Accordion title="Les avis Guesty pris en charge apparaissent-ils ?">
    Oui -- les avis Guesty pris en charge se synchronisent avec Trellis lorsque Guesty les expose via l'integration.
  </Accordion>
</AccordionGroup>