Guia de Etiquetas de Mesclagem (Merge Tags) para Modelos de E-mail (Merge Tags)

Mariia Korostashevych

Atualizado 23 de fevereiro de 2026 11:08

As etiquetas de mesclagem (merge tags) permitem inserir dados dinamicamente a partir de uma reserva, do perfil do hóspede ou das configurações da propriedade diretamente em seus e-mails automatizados (como mensagens de confirmação, de cancelamento ou de antes da estadia).

⚠️ Distinção Importante: Formatando Suas Tags

Merge tags do PMS (usadas em E-mail > Modelos) geralmente estão entre colchetes (p.ex., [guest_name]).
Sensibilidade a Maiúsculas e Minúsculas: Certifique-se de digitar as tags exatamente como mostrado abaixo (todas em minúsculas) para garantir que os dados sejam puxados corretamente.
Tags do Guest Marketing/Guest Experience (usadas em Campanhas/Automações) estão entre chaves (p.ex., {{first_name}}).

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

Estas são as tags mais usadas para personalizar mensagens.

Merge Tag	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]`	ID única da reserva na Cloudbeds.	2025-1014
`[booking_reference]`	Referência original da reserva de Terceiro (p.ex., Expedia, Booking.com).	123456789
`[arrival_date]`	Data do check-in do hóspede.	25 de dezembro de 2025
`[arrival_time]`	Hora do check-in do hóspede (conforme as configurações da Propriedade).	15:00
`[departure_date]`	Data do check-out do hóspede.	27 de dezembro de 2025
`[phone_number]`	Número de telefone fornecido pelo hóspede.	(55) 5555-1234
`[guest_email]`	Endereço de e-mail fornecido pelo hóspede.	jane.doe@email.com
`[address1]` / `[address2]`	Linhas do endereço do hóspede.
`[city]` / `[state]` / `[zip]`	Cidade, estado e CEP do hóspede.
`[nights]`	Total de noites da estadia.
`[room type]`	Nome da categoria (tipo de acomodação) reservada (p.ex., Deluxe King).
`[room number]`	Número específico da unidade designada (se aplicável).
`[source]` / `[origin]`	Origem da reserva (p.ex., Booking.com, reserva direta).

2. Informações da Propriedade e da Conta

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

Merge Tag	Dados Extraídos
`[property_name]`	O nome da sua propriedade conforme configurado nas Configurações.
`[property_phone]`	O telefone principal da propriedade.
`[property_address]`	O endereço completo da sua propriedade.
`[hotel city]` / `[hotel state]`	A cidade e o estado da propriedade.
`[property_email]`	O endereço de email principal da propriedade.
`[show property name]`	Exibe o nome da propriedade (frequentemente usado nos cabeçalhos).

3. Detalhes Financeiros e do Extrato

Essas tags são essenciais para e-mails transacionais, como confirmações.

Merge Tag	Dados Extraídos
`[invoice number]`	A ID única da fatura gerada.
`[invoice datedue]`	A data de vencimento do pagamento da fatura.
`[credit note number]`	A ID associada a uma nota de crédito/reembolso.
`[terms txt]`	Os termos e condições gerais da sua propriedade.
`[custom cancellation policy]`	O texto específico da política para essa reserva.
[canc number]	A ID do cancelamento (se a reserva for cancelada)
[cancelation fee]	A taxa aplicada no cancelamento.
[guest portal link]	Um link direto para o hóspede acessar o portal dele.

4. Tags para Reservas em Grupo

Se a reserva fizer parte de um Perfil de Grupo, use essas tags para extrair dados ao nível de grupo.

[group name] / [group code]
[group address1] / [group address2]
[group city] / [group state] / [group zip] / [group country]
[group source]
[group invoice number] / [group invoice date due]

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;
Posicione o cursor onde deseja inserir os dados;
Clique no botão "Inserir Merge Tag" na barra de ferramentas do editor;
Uma janela exibirá todas as tags disponíveis que o sistema pode preencher para esse tipo específico de e-mail.

Uma Observação sobre a tag [table]: A tag [table], que gera um detalhamento completo dos encargos do extrato, é uma tag automatizada pelo sistema. Atualmente, ela não está disponível para uso em modelos de e-mail personalizados. Para detalhamentos financeiros completos, recomendamos direcionar os hóspedes para o [guest portal link].