Saltar para o conteúdo principal

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.

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

EntidadeDireçãoO que inclui
PropriedadesGuesty → TrellisListagens com comodidades, fotos e endereços
ReservasGuesty → TrellisReservas com info de hóspedes, datas e dados financeiros
HóspedesGuesty → TrellisPerfis de contato com e-mail e telefone
MensagensGuesty ↔ TrellisConversas de hóspedes, fornecedores e proprietários fluem em ambas direções
Campos personalizadosGuesty → TrellisCampos personalizados em nível de propriedade e reserva
AvaliaçõesGuesty → TrellisAvaliações de hóspedes com classificações
ProprietáriosGuesty → TrellisDados de contato de proprietários
ConsultasGuesty → TrellisConsultas pré-reserva de hóspedes
Bloqueios de calendárioTrellis ↔ GuestyBloquear e desbloquear datas com notas opcionais
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.

Configuração

1

Abrir a página de Integrações

No Trellis, vá para Configurações > Integrações e selecione Guesty.
2

Obter suas credenciais de API do Guesty

No seu painel do Guesty, vá para Marketplace > API Keys. Copie sua chave e segredo de API.
3

Inserir suas credenciais no Trellis

Cole sua chave e segredo de API do Guesty nos campos fornecidos, depois clique em Conectar.
4

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.
5

Verificar seus dados

Verifique suas páginas de Propriedades e Reservas no Trellis para confirmar que tudo foi importado corretamente.

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

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çãoO que é importado
7 dias atrásReservas da última semana
30 dias atrásReservas dos últimos 30 dias
90 dias atrásReservas dos últimos 90 dias
PersonalizadoUm número personalizado de dias especificado por você (até 90)
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.
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.

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

Perguntas frequentes

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.
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.
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.
Campos personalizados do Guesty são atualmente somente leitura no Trellis. Você pode visualizá-los, mas edições precisam ser feitas no Guesty.
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.
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.
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.
Sim - avaliações compatíveis da Guesty sincronizam para o Trellis quando a Guesty as expõe pela integração.