Como conectar o Motor de Reservas Guesty a um site externo

Como conectar o Motor de Reservas Guesty a um site externo

Objetivo

Aprender a incorporar o widget de pesquisa do Motor de Reservas Guesty em um site externo, permitindo que os visitantes pesquisem propriedades e sejam direcionados ao processo de reserva direta.

1. O que significa conectar o Motor de Reservas a um site externo?

A Guesty permite incorporar um widget de pesquisa do Motor de Reservas em sites criados em outras plataformas, como WordPress, Wix e Squarespace.

O widget permite que o visitante selecione informações de pesquisa, como destino e datas da estadia. Depois de iniciar a pesquisa, ele é direcionado ao Motor de Reservas Guesty para consultar as propriedades e continuar o processo de reserva.

Essa opção é útil para empresas que já possuem um site próprio e desejam adicionar a funcionalidade de reservas diretas sem precisar criar um novo site pela Guesty.

Importante: o widget de pesquisa não transforma o site externo em um site Guesty. Ele conecta a experiência de pesquisa ao Motor de Reservas Guesty.

2. Pré-requisitos

Antes de iniciar a integração, confirme os seguintes pontos:

• O Motor de Reservas Guesty já foi criado e configurado.
• As propriedades que deverão aparecer nas pesquisas estão atribuídas ao motor.
• Você possui acesso administrativo ao site externo.
• A plataforma utilizada permite inserir JavaScript ou código personalizado.
• O plano contratado na plataforma externa permite esse tipo de integração.

Por exemplo, a documentação da Guesty informa que o Squarespace exige o plano Business ou superior para utilizar injeções de JavaScript.

3. Acessar o código de integração na Guesty

Siga o procedimento abaixo para obter o código do widget.

1. Faça login na sua conta Guesty.
2. No menu lateral, acesse Marketing e Vendas.
3. Em Gestão de Canal, selecione Distribuição.
4. Clique na miniatura do Motor de Reservas Guesty.
5. Localize o motor que deseja integrar ao site externo.
6. Clique no ícone de opções ao lado dele.
7. No menu suspenso, selecione Conectar ao seu próprio site.
8. Clique no ícone de copiar para copiar o trecho de código disponibilizado pela Guesty.

Guarde o código copiado para utilizá-lo na plataforma em que o site foi criado.

Atenção: utilize o código gerado para o seu próprio Motor de Reservas. Não substitua manualmente os endereços ou parâmetros do código sem saber como essas alterações afetam a integração.

4. Inserir o widget no site externo

Depois de copiar o código, acesse o editor da plataforma utilizada para criar o site.

O procedimento varia de acordo com o sistema, mas normalmente envolve inserir um bloco de código personalizado ou adicionar o script em uma área que permita JavaScript.

Exemplo: site criado no WordPress

1. Acesse o painel administrativo do WordPress.
2. Abra a página em que deseja exibir o widget.
3. Edite a página com o construtor utilizado pelo site.
4. Adicione um bloco ou elemento compatível com HTML personalizado.
5. Cole o código fornecido pela Guesty.
6. Salve ou atualize a página.
7. Visualize o site para verificar se o widget aparece corretamente.

A disponibilidade desse recurso depende do editor, da configuração de hospedagem e das permissões do site.

Exemplo: site criado no Wix

1. Acesse o painel do Wix.
2. Abra o editor do site.
3. Entre na página em que deseja inserir o widget.
4. Utilize o recurso de incorporação de código ou elemento HTML disponibilizado pela plataforma.
5. Insira o código fornecido pela Guesty, respeitando as instruções do Wix.
6. Salve e publique as alterações.
7. Acesse a página publicada para conferir o resultado.

Os nomes dos menus podem variar conforme a versão do editor e o tipo de site.

Exemplo: site criado no Squarespace

1. Acesse o editor do site.
2. Confirme se o plano contratado permite injeções de JavaScript.
3. Abra a página em que deseja disponibilizar a pesquisa.
4. Adicione o código no bloco ou recurso de incorporação compatível com scripts.
5. Cole o código fornecido pela Guesty.
6. Salve as alterações e publique a página.
7. Teste o widget no site publicado.

Se a plataforma não permitir a execução do script, será necessário ajustar o plano ou utilizar uma solução de integração compatível.

Importante: a Guesty não oferece suporte técnico para problemas relacionados à inserção de código em sites externos. Em caso de dificuldade com o editor, hospedagem ou permissões, consulte o suporte da plataforma utilizada.

5. Verificar o funcionamento do widget

Depois de inserir o código, faça testes no site publicado.

1. Abra a página em que o widget foi inserido.
2. Confirme se a barra ou o formulário de pesquisa aparece corretamente.
3. Verifique se os destinos disponíveis correspondem às propriedades configuradas.
4. Selecione um destino, quando disponível.
5. Informe datas de check-in e check-out.
6. Inicie a pesquisa.
7. Confirme se o visitante é direcionado ao Motor de Reservas Guesty.
8. Confira se as propriedades e a disponibilidade são apresentadas corretamente.

Realize também um teste em dispositivo móvel para verificar se o widget está adequado à largura da tela.

6. Entender como funciona o filtro de destino

O filtro de destino do widget utiliza automaticamente os dados do campo Endereço da cidade dos anúncios cadastrados na Guesty.

Isso significa que os destinos exibidos na pesquisa dependem das informações de endereço registradas nas propriedades.

Embora seja possível personalizar esses valores para apresentar bairros ou regiões em vez de cidades, essa alteração exige cuidado.

Atenção: a Guesty alerta que personalizar os valores de endereço pode afetar a conexão com canais como Airbnb, Booking.com e Vrbo, que possuem requisitos próprios para os dados de endereço.

Antes de modificar essas informações, avalie o impacto nas integrações dos anúncios.

7. Manter o widget atualizado

Se você alterar a cor de destaque do design do Motor de Reservas Guesty, será necessário copiar novamente o código de incorporação e atualizar o código no site externo.

Para isso:

1. Acesse as configurações do Motor de Reservas Guesty.
2. Atualize a cor de design conforme necessário.
3. Salve as alterações.
4. Retorne à opção Conectar ao seu próprio site.
5. Copie novamente o código atualizado.
6. Substitua o código antigo no site externo.
7. Salve e publique as alterações.
8. Verifique se as cores do widget correspondem às configurações atualizadas.

Utilizar um código antigo pode fazer com que as cores exibidas no site não correspondam ao design atual do Motor de Reservas.

8. Problemas comuns e como solucioná-los

O widget não aparece no site

• Confirme se o código foi inserido corretamente.
• Verifique se o editor permite JavaScript ou código personalizado.
• Confirme se as alterações foram publicadas.
• Verifique se o plano da plataforma externa permite a funcionalidade utilizada.

O widget aparece, mas não permite pesquisar

• Confira se o código está completo.
• Verifique se a plataforma permite a execução do script.
• Teste a página publicada em outro navegador.
• Se necessário, solicite ajuda ao suporte da plataforma do site.

Os destinos exibidos estão incorretos

• Revise os campos Endereço da cidade das propriedades na Guesty.
• Confira se as propriedades desejadas estão atribuídas ao Motor de Reservas.
• Avalie cuidadosamente qualquer personalização de endereço que possa afetar a integração com os canais de reserva.

As cores do widget estão diferentes das configurações do motor

• Confira a cor configurada no Motor de Reservas.
• Copie novamente o código pela opção Conectar ao seu próprio site.
• Atualize o código no site externo e publique as alterações.

O visitante não chega à página de reservas

• Teste a pesquisa no site publicado.
• Confirme se o widget está vinculado ao Motor de Reservas correto.
• Verifique se o motor está configurado e se as propriedades estão disponíveis para pesquisa.

9. Checklist de validação

• O Motor de Reservas Guesty foi criado.
• As propriedades desejadas estão atribuídas ao motor.
• A plataforma externa permite inserir o código necessário.
• O código foi copiado diretamente da Guesty.
• O widget foi inserido na página correta.
• O site foi publicado após a alteração.
• O formulário de pesquisa aparece corretamente.
• Os destinos e as datas foram testados.
• O redirecionamento para o Motor de Reservas funciona.
• As cores e a apresentação do widget foram verificadas.
• A experiência em dispositivos móveis foi revisada.