Placeholders

Os placeholders são códigos curtos (ex.: {{guestName}}, {{startDate}}) que insere nos modelos de email. Quando o email é enviado, o sistema substitui cada placeholder pelo valor real (ex.: nome do hóspede, data de check-in) para personalizar cada email. Este artigo explica onde editar modelos e usar placeholders e o que cada um resolve.

Onde editar modelos e usar placeholders

1. Vá a Definições → Mensagens (ou Regras de mensagens).
2. Abra o separador Modelos.
3. Clique em Novo modelo para criar um, ou clique num modelo na lista para o editar.
4. No formulário do modelo, edite o assunto e o corpo para cada idioma (Português, Inglês, Espanhol).
5. No editor do corpo, clique em Inserir placeholder e escolha um placeholder da lista. O código (ex.: {{guestName}}) é inserido no texto. Também pode escrever o código manualmente se o souber.

A mesma página Definições → Mensagens tem separadores para Automações (regras de mensagens) e Limpeza (equipas); os placeholders são usados apenas ao editar modelos no separador Modelos.

Como inserir placeholders

No editor de modelos (assunto ou corpo), pode:

• Escrever o código do placeholder (ex.: {{guestName}}) se o souber, ou
• Usar o seletor de placeholders: clique em "Inserir placeholder" e escolha da lista. O código correto é inserido por si.

Os placeholders escrevem-se entre chavetas duplas, ex.: {{placeholderName}}. A lista completa está abaixo e no seletor da aplicação.

Placeholders disponíveis

O seletor Inserir placeholder do editor oferece estes placeholders. Quando o email é enviado, cada um é substituído por dados da reserva, da propriedade ou do seu perfil.

Hóspede

• {{guestName}} – Nome completo do hóspede
• {{numberOfGuests}} – Número de hóspedes

Propriedade

• {{propertyName}} – Nome da propriedade
• {{propertyAddress}} – Morada completa da propriedade

Datas

• {{startDate}} – Data de check-in (formatada)
• {{endDate}} – Data de check-out (formatada)

Pagamento

• {{depositAmount}} – Valor do depósito (€)
• {{balanceAmount}} – Saldo em dívida (€)
• {{depositPercent}} – Percentagem do depósito (%)
• {{iban}} – IBAN
• {{ibanHolder}} – Titular da conta

Anfitrião / contacto

• {{hostName}} – O seu nome
• {{hostEmail}} – O seu email
• {{hostPhone}} – O seu telefone

Outros

• {{checkinInstructions}} – Instruções de check-in (da reserva ou da sua predefinição em definições)

Todos são preenchidos automaticamente quando o email é enviado; nenhum fica em branco por defeito. Se um valor faltar (ex.: sem telefone), pode aparecer vazio.

O que resolvem

Quando o email é enviado (ex.: por uma regra de mensagens), o sistema consulta a reserva, a propriedade e o seu perfil e substitui cada placeholder pelo valor real. Por exemplo:

• {{guestName}} → "João Silva"
• {{startDate}} → "10 mai 2025"
• {{propertyName}} → "Apartamento do Porto"

Se um valor faltar (ex.: sem telefone do anfitrião), o placeholder pode ser substituído por vazio. Pré-visualize o modelo com dados de exemplo para verificar.

Boas práticas

• Use placeholders para dados variáveis (nome do hóspede, datas, morada) para não ter de escrever um novo modelo por reserva.
• Mantenha texto fixo (mensagem de boas-vindas, regras da casa) como texto normal; use placeholders apenas onde o conteúdo muda por hóspede ou reserva.
• Pré-visualize o modelo (se disponível) para garantir que os placeholders são resolvidos corretamente e que o email lê bem em cada idioma.

Ver Criar modelos e Resolução de idioma para como o idioma afeta qual versão do modelo é enviada.