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

> Conecte o Trellis ao Guesty para sincronização completa de propriedades, reservas e mensagens

Conecte sua conta Guesty ao Trellis e mantenha propriedades, reservas, dados de hóspedes e mensagens compatíveis coordenados por atualizações da Guesty e sincronizações manuais.

## O que sincroniza

| Entidade                | Direção          | O que inclui                                                                |
| ----------------------- | ---------------- | --------------------------------------------------------------------------- |
| Propriedades            | Guesty → Trellis | Listagens com comodidades, fotos e endereços                                |
| Reservas                | Guesty → Trellis | Reservas com info de hóspedes, datas e dados financeiros                    |
| Hóspedes                | Guesty → Trellis | Perfis de contato com e-mail e telefone                                     |
| Mensagens               | Guesty ↔ Trellis | Conversas de hóspedes, fornecedores e proprietários fluem em ambas direções |
| Campos personalizados   | Guesty → Trellis | Campos personalizados em nível de propriedade e reserva                     |
| Avaliações              | Guesty → Trellis | Avaliações de hóspedes com classificações                                   |
| Proprietários           | Guesty → Trellis | Dados de contato de proprietários                                           |
| Consultas               | Guesty → Trellis | Consultas pré-reserva de hóspedes                                           |
| Bloqueios de calendário | Trellis ↔ Guesty | Bloquear e desbloquear datas com notas opcionais                            |

<Tip>
  Mensagens sincronizam em ambas direções - responda a um hóspede no Trellis e aparece no Guesty, e vice-versa. Conversas com proprietários também sincronizam.
</Tip>

## Configuração

<Steps>
  <Step title="Abrir a página de Integrações">
    No Trellis, vá para **Configurações > Integrações** e selecione **Guesty**.
  </Step>

  <Step title="Obter suas credenciais de API do Guesty">
    No seu painel do Guesty, vá para **Marketplace > API Keys**. Copie sua chave e segredo de API.
  </Step>

  <Step title="Inserir suas credenciais no Trellis">
    Cole sua chave e segredo de API do Guesty nos campos fornecidos, depois clique em **Conectar**.
  </Step>

  <Step title="Aguardar a sincronização inicial">
    O Trellis importará propriedades e reservas recentes compatíveis com o provedor. O tempo depende do volume da API Guesty, do estado da integração e do tamanho do portfólio.
  </Step>

  <Step title="Verificar seus dados">
    Verifique suas páginas de **Propriedades** e **Reservas** no Trellis para confirmar que tudo foi importado corretamente.
  </Step>
</Steps>

## O que esperar após conectar

* **Propriedades compatíveis** aparecem no Trellis após a sincronização inicial, completas com fotos, comodidades e endereços
* **Novas reservas** sincronizam automaticamente conforme chegam do Guesty
* **Mensagens** de hóspedes, fornecedores e proprietários aparecem na sua caixa de entrada do Trellis
* **Campos personalizados** do Guesty estão disponíveis no Trellis para referência (com prefixo `gy_cf_` para clareza)
* **Notas de reserva** do Guesty sincronizam como notas internas na reserva no Trellis

<Note>
  Após a sincronização inicial, atualizações do provedor e sincronizações manuais mantêm registros compatíveis atualizados. O tempo depende do volume da API da Guesty, do estado da integração e do tamanho do portfólio.
</Note>

## Sincronização manual

Você pode acionar uma sincronização manual a qualquer momento em **Configurações > Integrações > Guesty**. Clique no botão **Sincronizar** para abrir o diálogo de sincronização, onde você escolhe até onde voltar para importar dados.

Opções disponíveis:

| Opção         | O que é importado                                              |
| ------------- | -------------------------------------------------------------- |
| 7 dias atrás  | Reservas da última semana                                      |
| 30 dias atrás | Reservas dos últimos 30 dias                                   |
| 90 dias atrás | Reservas dos últimos 90 dias                                   |
| Personalizado | Um número personalizado de dias especificado por você (até 90) |

<Tip>
  Use a opção **Personalizado** para inserir um número exato de dias. Por exemplo, insira `45` para importar todas as reservas dos últimos 45 dias.
</Tip>

<Note>
  As sincronizações do Guesty suportam um intervalo máximo de 90 dias. Para uma importação histórica mais ampla, execute várias sincronizações com diferentes intervalos de datas ou entre em contato com o suporte.
</Note>

## Bloqueio e desbloqueio de calendário

Você pode bloquear e desbloquear datas no seu calendário do Guesty diretamente do Trellis - inclusive através do [agente de IA](/pt/platform/ai-agent). Isso é útil para estadias de proprietários, janelas de manutenção ou qualquer período que precise tirar uma listagem do mercado.

Ao bloquear datas, você pode incluir uma **razão** e uma **nota**:

* **Razão** - escolha entre as categorias padrão do Guesty (por exemplo, "Bloqueio de proprietário" ou "Manutenção")
* **Nota** - adicione detalhes em texto livre explicando por que as datas estão bloqueadas

<Tip>
  Se sua razão de bloqueio não corresponder a uma das categorias predefinidas do Guesty, o Trellis salva automaticamente seu texto como nota para que seja sempre preservado no calendário do Guesty.
</Tip>

Para **desbloquear** datas, peça ao agente de IA ou use o calendário no Trellis para remover um bloqueio existente. A alteração sincroniza de volta ao Guesty imediatamente.

***

## Bom saber

* Campos personalizados atualmente sincronizam **do Guesty para o Trellis** (uma direção). Editar campos personalizados no Trellis não enviará as alterações de volta ao Guesty ainda.
* Todas as notas de reserva do Guesty são importadas como notas internas - são visíveis para sua equipe mas não para os hóspedes.
* Se você adicionar uma nova propriedade no Guesty, ela aparecerá automaticamente no Trellis durante o próximo ciclo de sincronização.

<Warning>
  Certifique-se de que sua chave de API do Guesty tenha as permissões corretas. Se propriedades ou reservas não estão sincronizando, verifique as configurações da sua chave de API no Marketplace do Guesty.
</Warning>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Quanto tempo leva a sincronização inicial?">
    O tempo da sincronização inicial depende do volume da API Guesty, do estado da integração e do tamanho do portfólio. Portfólios grandes podem levar mais tempo.
  </Accordion>

  <Accordion title="Posso responder a hóspedes e proprietários pelo Trellis?">
    Sim! Mensagens sincronizam em ambas direções para conversas de hóspedes, fornecedores e proprietários. Quando você responde no Trellis, a mensagem aparece no Guesty também.
  </Accordion>

  <Accordion title="O que acontece se eu atualizar uma reserva no Guesty?">
    Alterações feitas no Guesty - como mudanças de data, atualizações de hóspedes ou mudanças de status - sincronizam para o Trellis automaticamente.
  </Accordion>

  <Accordion title="Os campos personalizados são editáveis no Trellis?">
    Campos personalizados do Guesty são atualmente somente leitura no Trellis. Você pode visualizá-los, mas edições precisam ser feitas no Guesty.
  </Accordion>

  <Accordion title="Posso bloquear e desbloquear datas pelo Trellis?">
    Sim. Você pode bloquear datas no seu calendário do Guesty com uma razão e nota opcional, e desbloqueá-las quando estiver pronto. Você pode fazer isso através do agente de IA pedindo para bloquear ou desbloquear datas específicas em uma propriedade. As alterações sincronizam de volta ao Guesty imediatamente.
  </Accordion>

  <Accordion title="Posso re-sincronizar meus dados manualmente?">
    Sim. Vá em **Configurações > Integrações > Guesty** e clique em **Sincronizar**. Você pode escolher um intervalo predefinido (7, 30 ou 90 dias) ou inserir um número personalizado de dias até 90.
  </Accordion>

  <Accordion title="Posso desconectar e reconectar depois?">
    Sim. Você pode desconectar a integração a qualquer momento em **Configurações > Integrações**. Seus dados existentes no Trellis permanecerão, e você pode reconectar quando estiver pronto.
  </Accordion>

  <Accordion title="As avaliações compatíveis do Guesty aparecem?">
    Sim - avaliações compatíveis da Guesty sincronizam para o Trellis quando a Guesty as expõe pela integração.
  </Accordion>
</AccordionGroup>