Como conectar o PriceLabs à Guesty

Objetivo

Orientar o usuário na conexão entre PriceLabs e Guesty, desde a geração do token de integração até a importação dos anúncios e a ativação da sincronização de preços.

1. Antes de começar

Antes de realizar a conexão, confirme se:

• Você tem acesso à conta Guesty.
• Você tem acesso à conta PriceLabs.
• Os anúncios que serão precificados já estão cadastrados na Guesty.
• Você definiu quais anúncios serão gerenciados pelo PriceLabs.
• Você alinhou com o cliente quando a sincronização de preços deverá ser ativada.

Importante: o token de integração gerado na Guesty tem validade de 4 horas. Por isso, gere o token somente quando estiver pronto para concluir a conexão com o PriceLabs.

Além disso, a documentação da Guesty orienta a utilizar apenas uma ferramenta de estratégia de preços por vez, evitando alterações conflitantes nas tarifas.

2. Gerar o token de integração na Guesty

Passo 1 — Acessar o Marketplace

1. Faça login na sua conta Guesty.
2. No menu lateral, acesse Integrações.
3. Selecione Marketplace.
4. Pesquise por PriceLabs.
5. Abra a página da integração.
6. Clique em Conectar, no canto superior direito.

Passo 2 — Copiar o token

1. Na janela exibida, clique no ícone para copiar a chave ou token de integração.
2. Guarde o token temporariamente para utilizá-lo no PriceLabs.
3. Clique em OK para fechar a janela.

Atenção: não compartilhe o token publicamente. Ele é utilizado para autorizar a integração entre as contas.

3. Conectar a Guesty ao PriceLabs

Passo 1 — Acessar o PriceLabs

1. Faça login na sua conta PriceLabs.
2. No canto superior esquerdo, clique em Adicionar seus anúncios ( Add your listings ).

Se você já possui anúncios cadastrados no PriceLabs, utilize a opção Adicionar/Reconectar anúncios ( Add/Reconnect Listings ), conforme a interface disponível.

Passo 2 — Selecionar a Guesty

1. Na janela de integração, selecione Guesty como sistema de gerenciamento de propriedades (PMS).
2. Cole o token gerado anteriormente na Guesty.
3. Se aparecer a opção Usar apelidos da Guesty ( Use Guesty nicknames ), escolha conforme sua preferência:

• Ativada: importa os apelidos dos anúncios da Guesty para a coluna de tags no PriceLabs.
• Desativada: utiliza as tags dos anúncios, conforme a configuração disponível.

4. Clique em Conectar ( Connect ).

Passo 3 — Confirmar a importação

Após concluir a conexão, os anúncios da Guesty deverão aparecer no painel do PriceLabs.

Confira se:

• Os anúncios esperados foram importados.
• Os nomes correspondem às propriedades corretas.
• Não existem anúncios ausentes ou duplicados.
• As propriedades de múltiplas unidades estão representadas corretamente.

Observação sobre múltiplas unidades: na integração padrão, somente a unidade principal ( parent unit ) aparece no PriceLabs. Os dados de ocupação das subunidades são consolidados na unidade principal.

4. Confirmar a integração

Depois de conectar as contas, confirme se a integração está registrada na Guesty.

1. Acesse a Guesty.
2. Entre em Conta.
3. Acesse Integrações.
4. Abra Minhas integrações.
5. Localize o PriceLabs e confirme se a integração está disponível.

Em seguida, acesse o painel do PriceLabs e verifique se os anúncios foram importados corretamente.

5. Revisar os anúncios antes de ativar a sincronização

Antes de enviar preços para a Guesty, revise as configurações no PriceLabs.

Para cada anúncio:

1. Confira o preço-base e os preços sugeridos.
2. Revise as regras de precificação e os ajustes por sazonalidade.
3. Confira os requisitos de estadia mínima.
4. Analise os valores apresentados para datas próximas e períodos de maior demanda.
5. Valide se a estratégia de preços está alinhada com o que foi combinado com o cliente.

A configuração detalhada da estratégia de receita deve considerar a operação de cada propriedade. A conexão técnica, por si só, não garante que os preços sugeridos sejam os mais adequados para o negócio.

6. Ativar ou manter desativada a sincronização de preços

No painel do PriceLabs, localize a opção Sincronizar preços ( Sync Prices ).

Para cada anúncio, você poderá:

• Manter desativada: permite revisar as configurações sem iniciar o envio automático de preços para a Guesty.
• Ativar: inicia o gerenciamento das tarifas pelo PriceLabs, conforme a programação de sincronização configurada.
• Sincronizar agora: envia uma atualização manual, quando disponível, sem precisar aguardar a próxima sincronização programada.

Orientação para o onboarding

Se o cliente ainda não validou a estratégia de preços, mantenha a sincronização desativada até concluir a revisão.

Antes de ativar, confirme com o cliente:

• Quais anúncios serão gerenciados pelo PriceLabs.
• Quais regras de precificação serão utilizadas.
• Se os preços sugeridos foram revisados.
• Se a sincronização já pode começar.

Importante: após ativar a sincronização, as tarifas enviadas pelo PriceLabs poderão atualizar os preços na Guesty e, por meio dela, nos canais conectados. Verifique os valores antes de iniciar esse processo.

7. Entender quais informações são sincronizadas

O PriceLabs pode enviar à Guesty, conforme os recursos disponíveis para a integração e a configuração da conta:

• Tarifas por diária.
• Requisitos de estadia mínima.
• Restrições de check-in e check-out, quando habilitadas.
• Descontos semanais e mensais, conforme a versão e os recursos disponíveis.
• Taxas adicionais por hóspede, conforme a versão e os recursos disponíveis.

A integração permite atualizações para períodos de até 540 dias, conforme a documentação da PriceLabs.

Entretanto, existem diferenças entre as funcionalidades disponíveis em cada versão da Guesty. Confira a documentação oficial antes de configurar recursos específicos.

Informações que exigem atenção

A integração não deve ser considerada responsável por todas as regras e taxas do anúncio. Dependendo da configuração:

• Bloqueios de calendário não são atualizados pelo PriceLabs.
• Taxas adicionais e cobranças por hóspedes extras podem precisar ser configuradas diretamente na Guesty.
• Ajustes específicos por canal podem ser feitos na Guesty.
• Alterações manuais de preço diretamente nos canais podem gerar divergências em relação à estratégia do PriceLabs.

Para evitar conflitos, centralize a gestão de preços no sistema definido com o cliente.

8. Importar anúncios adicionados posteriormente

Se novos anúncios forem cadastrados na Guesty depois da integração inicial, será necessário importá-los para o PriceLabs.

1. Acesse sua conta PriceLabs.
2. Clique em Adicionar/Reconectar anúncios ( Add/Reconnect Listings ).
3. Selecione Guesty como PMS.
4. Escolha a conta Guesty já conectada.
5. Selecione os anúncios que deseja adicionar ou reconectar.
6. Clique em Reconectar conta ( Reconnect Account ), conforme a interface disponível.
7. Confira se os novos anúncios aparecem no painel do PriceLabs.

Se for necessário gerar um novo token e já tiverem passado mais de 4 horas, gere uma nova chave na Guesty antes de realizar a reconexão.

Atenção: gerar um novo token pode invalidar o anterior. Faça esse procedimento somente quando necessário e siga as orientações oficiais de reconexão.

9. Solução de problemas

Os anúncios não aparecem no PriceLabs

1. Confira se o token foi copiado corretamente.
2. Verifique se ele ainda está dentro do prazo de validade de 4 horas.
3. Confirme se a conta Guesty foi selecionada como PMS.
4. Se necessário, gere um novo token e refaça a conexão.
5. Se o problema persistir, entre em contato com o suporte do PriceLabs.

Os preços não são atualizados na Guesty

1. Confirme se a opção Sincronizar preços está ativada para o anúncio.
2. Confira a frequência de sincronização configurada.
3. Utilize Sincronizar agora, se necessário.
4. Aguarde até 15 minutos para que uma atualização manual apareça na Guesty.
5. Compare os preços no PriceLabs e na Guesty, utilizando as mesmas datas.
6. Se o PriceLabs confirmar o envio correto e os valores não aparecerem na Guesty, entre em contato com o suporte da Guesty.

Ao abrir um chamado, informe o nome e o ID do anúncio, as datas afetadas, a descrição do problema e capturas de tela das duas plataformas.

10. Checklist de conclusão

• O token de integração foi gerado na Guesty.
• A Guesty foi selecionada como PMS no PriceLabs.
• A conexão foi concluída.
• Os anúncios esperados foram importados.
• Os nomes e as propriedades foram conferidos.
• A estratégia de preços foi revisada.
• A sincronização foi mantida desativada ou ativada conforme o alinhamento com o cliente.
• O cliente foi orientado sobre o funcionamento da integração.
• Os próximos passos de configuração de receita foram alinhados.