Guia de Tags de Unificação para Modelos de E-mail

Mariia Korostashevych

Atualizado 16 de dezembro de 2025 09:33

As tags de unificação permitem que você insira dinamicamente dados de uma reserva, perfil do hóspede ou configurações da propriedade diretamente em seus e-mails automáticos (como mensagens de confirmação, cancelamento ou antes da estadia).

⚠️ Importante diferenças:

Tags de Unificação do PMS (usadas em E-mail > Modelos) geralmente estão entre colchetes (p.ex., [guest_name]).
Tags do Guest Marketing/Whistle (usadas em Campanhas/Automatizações) estão entre chaves (p.ex., {{first_name}}).

1. Informações Essenciais do Hóspede e Reserva

Essas são as tags mais comumente usadas para personalizar mensagens.

Tag de Unificação	Dados Extraídos	Exemplo de Dados
`[guest_first_name]`	Nome do Hóspede Principal.	Jane
`[guest_last_name]`	Sobrenome do Hóspede Principal.	Doe
`[guest_full_name]`	Nome completo do Hóspede Principal.	Jane Doe
`[reservation_number]`	A ID de Reserva única do PMS da Cloudbeds.	2025-1014
`[booking_reference]`	A referência de reserva original de terceiros (p.ex., Expedia, Booking.com).	123456789
`[arrival_date]`	Data de Check-in do hóspede.	25 de dezembro de 2025
`[arrival_time]`	Hora de Check-in do hóspede (Baseado nas Configurações da Propriedade).	15:00
`[departure_date]`	Data de Check-out do hóspede.	27 de dezembro de 2025
`[phone_number]`	Número de telefone fornecido pelo hóspede.	(555) 555-1234
`[guest_email]`	Endereço de e-mail fornecido pelo hóspede.	jane.doe@email.com

2. Informações da Propriedade e Conta

Essas tags garantem que seus hóspedes saibam quem está enviando a mensagem e como entrar em contato com você.

Tag de Unificação	Dados Extraídos	Anotações
`[property_name]`	O nome da sua propriedade conforme configurado nas Configurações.
`[property_phone]`	O número de telefone principal da propriedade.
`[property_address]`	O endereço completo da sua propriedade.
`[property_email]`	O endereço de e-mail principal de contato da propriedade.
`[user_signature]`	O nome do usuário definido como remetente (se aplicável).	Usado principalmente para mensagens diretas.

3. Detalhes Financeiros e de Extratos

Essas tags são críticas para e-mails transacionais como confirmações.

Tag de Unificação	Dados Extraídos	Anotações
`[currency_symbol]`	O símbolo da moeda padrão da propriedade.	p.ex., $ ou €
`[total_price]`	O valor total da reserva (Taxas de Quarto + Itens Adicionais + Impostos/Taxas).
`[deposit_required]`	O valor necessário para o depósito.
`[deposit_paid]`	O valor do depósito já pago.
`[total_remaining]`	O valor restante a ser pago.

4. Tags Especiais e Condicionais (Tabelas)

Essas tags são únicas, pois geram automaticamente um bloco de HTML/texto com base nos dados da reserva.

Tag de Unificação	Descrição da Saída	Anotações
`[table]`	A Tabela de Extrato: gera uma tabela detalhada que mostra taxas de quarto, itens adicionais, impostos/taxas e pagamentos/depósitos da reserva.	Esta é a tag mais crítica para e-mails de confirmação. É uma inclusão obrigatória para transparência financeira.
`[guest_list]`	Gera uma lista de todos os hóspedes (incluindo os secundários) vinculados à reserva.	Útil para reservas em grupo.
`[room_list]`	Gera uma lista de todos os quartos/unidades reservados sob a reserva.	Útil para reservas de múltiplos quartos.
`[cancellation_link]`	Gera um link direto em que o hóspede pode clicar para cancelar a reserva por conta própria (se habilitado).	Aviso: Use isso apenas nos modelos de e-mail apropriados.

5. Como Encontrar Tags Específicas da Propriedade

Embora esta lista seja abrangente, algumas propriedades podem ter tags personalizadas únicas ou detalhes específicos que aparecem apenas no editor de modelos.

Navegue até Conta > Configurações > E-mail;
Abra ou crie um modelo de e-mail;
Coloque o cursor onde você deseja inserir os dados;
Clique no botão "Inserir Tag de Unificação" na barra de ferramentas do editor;
Uma janela exibirá todas as tags disponíveis que o sistema pode preencher para aquele tipo específico de e-mail.