Utilizando variáveis em mensagens

Personalize a sua comunicação com hóspedes, proprietários e membros da equipe usando variáveis. As variáveis funcionam como marcadores que preenchem automaticamente detalhes específicos — como o nome do hóspede, o código da chave ou o horário de check-in — quando uma mensagem é enviada. Isso permite que você forneça informações precisas e relevantes sem precisar editar manualmente cada mensagem.

Você pode adicionar variáveis aos seguintes métodos de comunicação:

Observação:

Você também pode usar variáveis nos formulários de check-in do aplicativo para hóspedes. Saiba quais variáveis são compatíveis.

O Guesty substitui automaticamente cada variável pela informação relevante quando a mensagem é acionada. Veja o exemplo abaixo.

Modelo de mensagem automatizada	Como a mensagem é enviada
Olá {{guest}}, Temos o prazer de lhe dar as boas-vindas ao nosso Apartamento de Luxo {{listing_address}}. O seu código de acesso à propriedade é {{guest_access_code}}. {{listing_checkin_instructions_notes}} Caso tenha alguma dúvida, entre em contato conosco. Cumprimentos, {{host_first}}	Olá Jill Ross, Temos o prazer de lhe dar as boas-vindas ao nosso apartamento de luxo , localizado no número 123 da Riverside Lane, apartamento 4. O código de acesso ao imóvel é 1234. O horário de check-in é às 15h. Há estacionamento gratuito disponível na rua. Ao chegar, digite o código acima e pressione o botão de check-in. Para trancar a porta, pressione o botão X. Caso tenha alguma dúvida, entre em contato conosco. Cumprimentos, Tim

Modelo de mensagem automatizada

Como a mensagem é enviada

Olá {{guest}},

Temos o prazer de lhe dar as boas-vindas ao nosso Apartamento de Luxo {{listing_address}}. O seu código de acesso à propriedade é {{guest_access_code}}.

{{listing_checkin_instructions_notes}}

Caso tenha alguma dúvida, entre em contato conosco.

Cumprimentos,
{{host_first}}

Olá Jill Ross,

Temos o prazer de lhe dar as boas-vindas ao nosso apartamento de luxo , localizado no número 123 da Riverside Lane, apartamento 4. O código de acesso ao imóvel é 1234.

O horário de check-in é às 15h. Há estacionamento gratuito disponível na rua. Ao chegar, digite o código acima e pressione o botão de check-in. Para trancar a porta, pressione o botão X.

Caso tenha alguma dúvida, entre em contato conosco.

Cumprimentos,
Tim

Abaixo encontra-se uma lista das variáveis disponíveis e seus respectivos valores. Você pode usar as variáveis padrão listadas abaixo ou criar variáveis personalizadas adicionando um novo campo personalizado, que gera automaticamente uma variável personalizada.

Importante:

Se você adicionar uma variável incorretamente, a mensagem falhará. Certifique-se de que as variáveis estejam escritas corretamente e não contenham caracteres ou espaços adicionais.
Se você observar valores inesperados ao usar variáveis, verifique suas configurações primeiro. Por exemplo, verifique suas configurações financeiras ou de disponibilidade, ou veja se algum membro da equipe fez alterações recentemente.

Variáveis personalizadas

Use variáveis personalizadas para enviar informações específicas que não são abrangidas pelas variáveis padrão. Ao criar um campo personalizado, o Guesty gera automaticamente uma variável personalizada. Você pode encontrá-las na coluna "Variável" da página de campos personalizados.

Por exemplo, se você criar um campo personalizado como "Nome do Prédio", uma variável como {{buildingname}} será gerada.

Ao adicionar uma variável personalizada a uma mensagem, o valor do campo personalizado correspondente é atualizado automaticamente no momento do envio.

Você precisa configurar os campos personalizados na página "Propriedades" ou na página "Reservas" antes de usar a variável em uma mensagem. Se um campo personalizado não estiver funcionando, verifique o seguinte:

O campo personalizado não foi configurado para o anúncio ou reserva.
Você configurou o campo personalizado depois de enviar a mensagem.
O campo personalizado contém uma variável padrão ou outro campo personalizado.
A variável personalizada contém um hífen, que não é suportado.

Dica:

Você pode adicionar campos personalizados com o tipo "Sim/Não" como condição de envio. Selecione-os no menu suspenso em Adicionar condição.

Variáveis padrão

Essas variáveis são criadas pela Guesty com base nas necessidades e demandas do setor.

Detalhes da reserva e dos hóspedes

Variável	Espaço reservado para inserir na mensagem	Detalhes adicionais
Data de check-in	{{checkin}}	Exibe a data com base no fuso horário do anúncio. Aprenda como alterar as datas da reserva.
Data de check-out	{{checkout}}	Exibe a data com base no fuso horário do anúncio. Aprenda como alterar as datas da reserva.
Nome do hóspede	{{guest_first}}	Aprenda como atualizar os dados do hóspede. A atualização dos dados de um hóspede alterará as informações dele em todas as reservas às quais ele está associado, bem como em sua página de contato.
Número do voo do hóspede	{{flight_number}}	Aprenda como atualizar os dados do hóspede. A atualização dos dados de um hóspede alterará essas informações em todas as reservas às quais ele está associado.
Nome completo do hóspede	{{guest}}	Aprenda como atualizar os dados do hóspede. A atualização dos dados de um hóspede alterará as informações dele em todas as reservas às quais ele está associado, bem como em sua página de contato.
Horário de chegada planejado pelo hóspede	{{planned_arrival_time}}	O horário de chegada previsto é o horário estimado de chegada do hóspede (se tiver sido definido) ou o horário de check-in padrão do anúncio.
Horário de partida planejado pelo hóspede	{{planned_departure_time}}	A partida planejada é o horário estimado de partida do hóspede (se tiver sido definido) ou o horário de check-out padrão do anúncio.
Método de transporte do hóspede	{{transportation}}	Aprenda como atualizar os dados do hóspede. A atualização dos dados de um hóspede alterará essas informações em todas as reservas às quais ele está associado.
Endereço de e-mail do hóspede	{{guest_email}}	Aprenda como atualizar os dados do hóspede. A atualização dos dados de um hóspede alterará as informações dele em todas as reservas às quais ele está associado, bem como em sua página de contato.
Cidade natal do hóspede	{{guest_hometown}}	Aprenda como atualizar os dados do hóspede. A atualização dos dados de um hóspede alterará as informações dele em todas as reservas às quais ele está associado, bem como em sua página de contato.
Número de telefone do hóspede	{{guest_phone}}	Aprenda como atualizar os dados do hóspede. A atualização dos dados de um hóspede alterará as informações dele em todas as reservas às quais ele está associado, bem como em sua página de contato.
Idioma preferido do hóspede	{{guest_preferred_language}}	Aprenda como atualizar os dados do hóspede. A atualização dos dados de um hóspede alterará as informações dele em todas as reservas às quais ele está associado, bem como em sua página de contato.
Número de identificação do hóspede	{{guest_identity_number}}	Aprenda como atualizar os dados do hóspede.
Número de hóspedes adultos	{{adults_count}}	Aprenda como atualizar a distribuição etária para reservas manuais e diretas.
Número de crianças convidadas	{{children_count}}	Aprenda como atualizar a distribuição etária para reservas manuais e diretas.
Número de hóspedes	{{guests_count}}	O número de hóspedes na reserva inclui adultos e crianças. Reservas manuais: Inclui apenas adultos — crianças não são contabilizadas. Aprenda como atualizar o número de hóspedes na reserva.
Número de hóspedes infantis	{{infants_count}}	Aprenda como atualizar a distribuição etária para reservas manuais e diretas.
Número de noites	{{nights_count}}	Aprenda como alterar as datas da reserva.
Código de confirmação da reserva	{{confirmation_code}}	O código de confirmação da reserva, conforme exibido no canto superior esquerdo da página de reservas.
Acordo em PDF assinado	{{guest_app::[app_name]::pdf}}	Cópia do contrato em PDF assinado para o hóspede.

Pagamento do hóspede

Variável	Espaço reservado para inserir na mensagem	Notas adicionais
Moeda	{{currency}}	A moeda em que a reserva deve ser paga. A moeda será baseada na moeda definida no anúncio.
Fatura do hóspede	{{guest_invoice}}	Envie a fatura do hóspede como anexo. Observação: Essa variável não é compatível com respostas salvas.
Tarifa de reserva de acomodação	{{fare_accommodation}}	O valor líquido da hospedagem, excluindo taxas ou impostos.
Tarifa de reserva de acomodação - ajustada	{{accommodation_fare_adjusted}}	O valor líquido da diária, já ajustado, excluindo taxas e impostos. Observação: Essa variável não é compatível com respostas salvas.
Saldo da reserva a pagar	{{balance_due}}	O saldo da reserva, caso ainda esteja pendente de pagamento.
Taxa de limpeza da reserva	{{fare_cleaning}}	A taxa de limpeza da reserva.
Pagamentos da reserva	{{payments}}	O valor total pago pelo hóspede e a data do pagamento.
Impostos da reserva	{{reservation_taxes}}	O valor do imposto da reserva.
Valor total da reserva pago	{{total_paid}}	O valor total pago pela reserva.

Configurações do anúncio, informações do anfitrião e instruções de check-in

Variável	Espaço reservado para inserir na mensagem	Notas adicionais
Código da porta do imóvel	{{listing_door_code}}	Aprenda como definir as instruções de check-in/check-out do anúncio.
Código de bloqueio do anúncio	{{listing_lock_code}}	Aprenda como definir as instruções de check-in/check-out do anúncio.
Política de cancelamento	{{direct_cancellation_policy_name}}	Aprenda como alterar a política de cancelamento de um anúncio.
Taxa de cancelamento	{{direct_cancellation_fee}}	Aprenda como alterar a política de cancelamento de um anúncio.
Link para o formulário de check-in	{{checkin_form}}	Saiba mais sobre os formulários de check-in.
Código de acesso para convidados	{{guest_access_code}}	O código de acesso do hóspede é gerado para cada reserva pelo Guesty Locks Manager.
Nome do anfitrião	{{host_first}}	Airbnb: O primeiro nome do anfitrião é obtido a partir do nome associado ao endereço de e-mail de integração. Rentals United: O primeiro nome do anfitrião (tal como aparece na conexão). Todos os outros canais de reserva: O primeiro nome do último/mais recente usuário que respondeu ao visitante por meio da Caixa de Entrada. Se uma mensagem estiver sendo enviada a um visitante pela primeira vez, o valor do marcador será o primeiro usuário da lista de usuários da sua conta Guesty. A lista é classificada em ordem alfabética.
Nome completo do anfitrião	{{host}}	Rentals United: O nome completo do anfitrião (como aparece na conexão). Todos os outros canais de reserva: O nome completo do último usuário que respondeu ao visitante por meio da caixa de entrada. Se uma mensagem estiver sendo enviada a um visitante pela primeira vez, o valor do marcador será o primeiro usuário da lista de usuários da sua conta Guesty. A lista é classificada em ordem alfabética.
Código da chave	{{key_code}}	O código de chave do hóspede é gerado por um parceiro terceirizado do Marketplace.
Horário de check-in do anúncio	{{checkin_time}}	Aprenda como alterar o horário de check-in de um anúncio. O horário de check-in é exibido no fuso horário do anúncio.
Horário de check-out do anúncio	{{checkout_time}}	Aprenda como alterar o horário de check-out de um anúncio. O horário de check-out é exibido no fuso horário do anúncio.
Apelido do anúncio	{{listing_nickname}}	Aprenda como alterar o apelido de um anúncio.
Título do anúncio	{{listing}}	Aprenda como alterar o título de um anúncio (conforme publicado em seus canais de reserva conectados).
Notas de check-in do anúncio	{{listing_checkin_instructions_notes}}	Aprenda como definir as instruções de check-in/check-out do anúncio. A variável será preenchida com informações do campo "Instruções adicionais de entrada" nas políticas de reserva.
Instruções de finalização da compra do anúncio	{{listing_checkout_instructions}}	Aprenda como definir as instruções de check-in/check-out do anúncio.
Cidade do anúncio	{{listing_address_city}}	A cidade onde o anúncio está localizado. Aprenda como atualizar o endereço de um anúncio.
Instruções de limpeza do anúncio	{{listing_cleaning_instructions}}	A variável será preenchida com informações da seção "Localização e detalhes".
Endereço completo do anúncio	{{listing_address}}	O endereço completo do seu anúncio. Isso inclui os seguintes campos opcionais: Condado Vizinhança Unidade Apartamento Andar Aprenda como atualizar o endereço de um anúncio.
Depósito de bagagem do anúncio	{{listing_luggage_storage}}	Aprenda como definir as instruções de check-in/check-out do anúncio.
Nome do anfitrião do anúncio	{{listing_host_name}}	A variável será preenchida a partir da seção "O hóspede deve saber", que aparece em Detalhes e layout > Localização e detalhes.
Nome da rede Wi-Fi do anúncio	{{listing_wifi_name}}	A variável será preenchida a partir da seção "O hóspede deve saber", que aparece em Detalhes e layout > Localização e detalhes.
Senha do Wi-Fi do anúncio	{{listing_wifi_password}}	A variável será preenchida a partir da seção "O hóspede deve saber", que aparece em Detalhes e layout > Localização e detalhes.
Manual da casa do anúncio	{{listing_house_manual}}	A variável será preenchida com informações da seção "O hóspede deve saber", que aparece em Detalhes e layout > Localização e detalhes.
Instruções para coleta de lixo do imóvel	{{listing_trash_collected_on}}	A variável será preenchida com informações da seção "O hóspede deve saber", que aparece em Detalhes e layout > Localização e detalhes.
Instruções de estacionamento do anúncio	{{listing_parking_instructions}}	A variável será preenchida com informações da seção "O hóspede deve saber", que aparece em Detalhes e layout > Localização e detalhes.
Nome do prédio do anúncio	{{listing_address_building_name}}	A variável será preenchida com informações da seção "Endereço completo" > "Detalhes adicionais do endereço". Aprenda como atualizar o endereço de um anúncio.
Tamanho da propriedade em pés quadrados	{{property_size_square_feet}}	A variável será preenchida com informações de Detalhes e layout > Localização e detalhes > Detalhes do imóvel.

Receitas e pagamentos

Variável	Espaço reservado para inserir na mensagem	Notas adicionais
Taxa Guesty	{{our_fee}}	Taxa da Guesty pela reserva (em USD).
Comissão Guesty	{{our_commission}}	A comissão da Guesty pela reserva, caso o plano de cobrança do usuário seja baseado em uma porcentagem da receita.
Taxa do canal do anfitrião	{{host_service_fee}}	As taxas do canal (apenas para o anúncio).
Impostos do anfitrião	{{host_taxes}}	A soma dos impostos + comissão do canal pré-deduzida. Aplicável somente a "airbnb", "airbnb2" e "tripAdvisor".
Receita líquida de aluguel	{{net_rental_income}}	Todas as taxas e encargos definidos no modelo de negócio como "receita líquida de aluguel" (cálculo da comissão).
Descrição do plano tarifário	{{direct_rate_plan_description}}	Descrição do plano tarifário. Saiba mais sobre como gerenciar planos tarifários.
Pagamento ao anfitrião da reserva	{{host_payout}}	Os ganhos finais do anfitrião com a reserva.
Receita do proprietário da reserva	{{owners_revenue}}	Receita do proprietário proveniente da reserva. Os dados de receita do proprietário estarão disponíveis 1 hora após a confirmação.
Comissão do gerenciador de imóveis da reserva	{{commission}}	O valor da sua comissão referente à reserva. Os dados da comissão do gerenciador da propriedade estarão disponíveis 15 minutos após a criação da reserva.

Equipe

Variável	Espaço reservado para inserir na mensagem	Notas adicionais
Apelido de integração	{{integration_nickname}}	O nome único de cada uma das conexões do usuário (como aparece no Guesty).
Canal de reservas	{{channel}}	A origem de uma reserva. Essa pode ser a opção de canal de reserva ou a fonte inserida ao criar uma reserva manual no Guesty.
Notas de limpeza da reserva	{{notes_cleaning}}	O texto no campo "notas de limpeza" da reserva.
Outras observações sobre a reserva	{{notes_other}}	O texto no campo "outras observações" da reserva.
Primeiro nome do membro da equipe	{{user_first}}	O primeiro nome do usuário (tal como aparece no Guesty). Observação: Use esta variável apenas para mensagens manuais. Ela permanecerá em branco se usada em uma mensagem automática.
Nome completo do membro da equipe	{{user}}	O nome completo do usuário (tal como aparece no Guesty). Observação: Use esta variável apenas para mensagens manuais. Ela permanecerá em branco se usada em uma mensagem automática.

Variáveis de próxima reserva

Utilize essas variáveis para compartilhar informações com sua equipe sobre a próxima reserva no calendário (a reserva imediatamente seguinte à atual).

Por exemplo:

Para informar seu(sua) profissional de limpeza quando o próximo check-in está agendado, crie esta mensagem automática:

Olá {{user}},
Aguardamos o próximo hóspede em {{next::checkin}}. Por favor, deixe o apartamento pronto até lá.
Atenciosamente,
{{host_first}}

Abaixo estão as variáveis de próxima reserva que você pode usar no Guesty.

Variáveis de próxima reserva

Variável	Espaço reservado para inserir na mensagem	Notas adicionais
Data de check-in	{{next::checkin}}	A data de check-in para a próxima reserva é baseada no fuso horário do anúncio.
Data de check-out	{{next::checkout}}	A data de check-out para a próxima reserva é baseada no fuso horário do anúncio.
Nome do hóspede	{{next::guest_first}}	O primeiro nome do próximo hóspede.
Nome completo do hóspede	{{next::guest}}	O nome completo do próximo hóspede.
Horário de chegada planejado pelo hóspede	{{next::planned_arrival_time}}	Se o horário estimado de chegada do hóspede foi adicionado à reserva, esse horário será utilizado. Caso contrário, será utilizado o horário de check-in padrão do anúncio.
Horário de partida planejado pelo hóspede	{{next::planned_departure_time}}	Se o horário estimado de partida do hóspede foi adicionado à reserva, esse horário será utilizado. Caso contrário, será utilizado o horário de check-out padrão do anúncio.
Endereço de e-mail do hóspede	{{next::guest_email}}	O endereço de e-mail do próximo hóspede.
Número de telefone do hóspede	{{next::guest_phone}}	O número de telefone do próximo hóspede.
Taxa Guesty	{{next::our_fee}}	A taxa da Guesty para a próxima reserva é exibida como uma porcentagem (%).
Taxa do canal do anfitrião	{{next::host_service_fee}}	As taxas do canal para a próxima reserva são específicas apenas para o anúncio.
Horário de check-in do anúncio	{{next::checkin_time}}	O horário de check-in da próxima reserva é baseado no fuso horário do anúncio.
Horário de check-out do anúncio	{{next::checkout_time}}	O horário de check-out da próxima reserva é baseado no fuso horário do anúncio.
Número de hóspedes	{{next::guests_count}}	O número de hóspedes na próxima reserva.
Número de noites	{{next::nights_count}}	O número de noites reservadas para a próxima reserva.
Tarifa de reserva de acomodação	{{next::fare_accommodation}}	O valor a ser pago pela próxima reserva, excluindo taxas ou impostos.
Taxa de limpeza da reserva	{{next::fare_cleaning}}	A taxa de limpeza da próxima reserva.
Notas de limpeza da reserva	{{next::notes_cleaning}}	O texto no campo "notas de limpeza" da próxima reserva.
Código de confirmação da reserva	{{next::confirmation_code}}	O código de confirmação da próxima reserva.
Notas do hóspede sobre a reserva	{{next::notes_guest}}	O texto no campo "notas do hóspede" da próxima reserva. O campo "Notas do Hóspede" em uma reserva destina-se a anotações a serem compartilhadas com o hóspede usando esta variável. O campo "Notas" abaixo de um hóspede destina-se a anotações internas relacionadas a esse hóspede (em todas as suas reservas) e não possui uma variável.
Pagamento ao anfitrião da reserva	{{next::host_payout}}	Os ganhos finais do anfitrião para a próxima reserva.
Outras observações sobre a reserva	{{next::notes_other}}	O texto no campo "outras observações" da próxima reserva.

Relativo a:

GFP: Communication

Utilizando variáveis em mensagens

Observação:

Importante:

Variáveis personalizadas

Dica:

Variáveis padrão

Observação:

Observação:

Observação:

Observação:

Variáveis de próxima reserva

Relativo a:

Faça um tour pelo Guesty