Este artigo explica como sincronizar avaliações de hóspedes do Guesty com um objeto personalizado do HubSpot. Uma vez ativado, esse fluxo de trabalho é executado uma vez por dia para criar registros no HubSpot para as avaliações enviadas nas últimas 24 horas. Isso permite que sua equipe gere relatórios sobre classificações, acione campanhas e mantenha um histórico de avaliações diretamente no HubSpot.
Antes de começar
Antes de ativar a sincronização de avaliações, conclua os seguintes pré-requisitos:
- Certifique-se de ter conectado sua conta do HubSpot seguindo os passos descritos em Conectando o Guesty ao HubSpot via Guesty Connect.
- Na sua conta do HubSpot, crie um objeto personalizado para avaliações, por exemplo, chamado "Avaliações", caso ainda não tenha um.
- Adicione propriedades ao seu objeto personalizado no HubSpot para cada campo de avaliação do Guesty que você planeja vincular. É recomendável criar essas propriedades no HubSpot antes de começar a vincular os campos no Guesty.
Tipos de propriedade recomendados pela HubSpot
Ao criar propriedades no HubSpot, use tipos de campo que correspondam aos dados do Guesty que você planeja sincronizar.
| Valor do Guesty | Tipo recomendado do HubSpot |
|---|---|
| Canal, ID do Anúncio, ID da Reserva, ID da Avaliação, Nome do avaliador | Texto de linha única |
| Classificação geral (bruta ou normalizada) | Numérico ou Texto de linha única |
| Data de criação da Avaliação | Data (ou data e hora, para corresponder à forma como você armazena datas no HubSpot) |
Importante:
Não vincule valores de texto livre do Guesty a propriedades do HubSpot que usam seleções de menu suspenso, caixa de seleção ou botão de opção, a menos que todos os valores possíveis do Guesty já sejam uma opção permitida na propriedade do HubSpot.
Entendendo o fluxo de trabalho de sincronização de avaliação
Este fluxo de trabalho é executado automaticamente para manter seus dados de avaliação sincronizados.
| Fluxo de trabalho | Acionar | O que faz |
|---|---|---|
| [Piloto] Enviar avaliações para o HubSpot como objeto personalizado | Cronograma diário (uma vez por dia) | Carrega as avaliações do Guesty das últimas 24 horas, incluindo as de canais personalizados, e cria um registro no objeto personalizado do HubSpot selecionado para cada avaliação. |
Esta é uma sincronização unidirecional do Guesty para o HubSpot. O fluxo de trabalho apenas cria novos registros; ele não atualiza registros de avaliação existentes no HubSpot e não sincroniza nenhuma alteração do HubSpot de volta para o Guesty.
Observação:
Somente os campos que você vincular serão enviados para o HubSpot. Os campos do Guesty não vinculados serão ignorados.
O que sincroniza e o que não sincroniza
| Sincronizações | Não sincroniza |
|---|---|
| Avaliações do Guesty criadas nas últimas 24 horas | Avaliações antigas fora do período diário (este fluxo de trabalho não preenche dados históricos retroativamente) |
| Avaliações de canais padrão e personalizados | Atualizações de avaliações que já foram sincronizadas com o HubSpot. |
| Novos registros de objetos personalizados do HubSpot para cada avaliação na janela. | Associações com outros objetos do HubSpot, como contatos ou negócios. |
| Apenas as propriedades que você vinculou em “Avaliações” | Alterações feitas no HubSpot de volta para Guesty |
Para ativar a sincronização de avaliação
- Faça login na sua conta Guesty .
- No menu de navegação lateral, clique em
Integrações para abrir o menu suspenso . - Selecione o Marketplace .
- Abra a integração com o HubSpot e acesse a aba "Configuração".
- Ative a opção [Piloto] Enviar avaliações para o HubSpot como objeto personalizado .
- Na seção "Avaliações", selecione seu objeto personalizado de avaliações do HubSpot no menu suspenso .
- Vincule os campos do Guesty que você precisa às propriedades correspondentes do HubSpot nesse objeto.
- Clique em Salvar .
Após a próxima execução diária, você pode verificar sua conta do HubSpot para confirmar se novos registros de avaliações recentes do Guesty foram criados em seu objeto personalizado.
Ligação de campos
Nas configurações do fluxo de trabalho, você pode vincular os pontos de dados do Guesty às suas propriedades do HubSpot. Os seguintes campos estão disponíveis para sincronização.
| Rótulo de vinculação do portal | Fonte Guesty | Notas |
|---|---|---|
| Canal | ID do canal de Avaliação (`channelId`) | Identificador do canal de Reserva |
| ID do Anúncio Guesty | ID do Anúncio (`listingId`) | ID do Anúncio / propriedade para Guesty |
| ID de Reserva Guesty | ID da Reserva (`reservationId`) | reserva relacionada |
| ID da Avaliação | ID da Avaliação (`_id`) | Identificador de avaliação Guesty — útil para conciliação no HubSpot. |
| data_de_criação_da_avaliação | Avaliação criada em (`createdAt`) | Quando a avaliação foi criada no Guesty |
| avaliação_geral_bruta | avaliação bruta (`rawReview.rating`) | Escala de classificação original do canal |
| classificação_geral_normalizada | Classificação normalizada (`contents.rating`) | Guesty classificação geral normalizada |
| nome_do_avaliador | Nome do avaliador (`rawReview.reviewerName`) | Nome exibido na avaliação original |
Observação:
Cada execução diária cria novos registros no HubSpot. Não há uma etapa integrada para encontrar e atualizar uma avaliação existente. Recomendamos vincular o ID da Avaliação para que você possa identificar duplicatas ou conciliar registros no HubSpot, se necessário.