Templates
O modulo de Templates da OCP permite criar, editar e gerenciar modelos de mensagem reutilizaveis para todos os canais de comunicacao — email, SMS e WhatsApp. Templates garantem consistencia na comunicacao e permitem personalizacao com variaveis dinamicas.
O que e um template?
Um template e um modelo de mensagem com texto fixo e variaveis dinamicas que sao preenchidas automaticamente com dados do hospede, reserva ou propriedade no momento do envio.
Exemplo
Template: Confirmacao de reserva (email)
Ola {{guest.firstName}},
Sua reserva no {{property.name}} esta confirmada!
Detalhes:
- Check-in: {{reservation.checkInDate}}
- Check-out: {{reservation.checkOutDate}}
- Unidade: {{reservation.unitName}}
- Valor total: {{reservation.totalFormatted}}
Estamos ansiosos para recebe-lo!
Atenciosamente,
{{property.name}}Resultado para o hospede:
Ola Maria,
Sua reserva no Hotel Praia Azul esta confirmada!
Detalhes:
- Check-in: 15/07/2027
- Check-out: 18/07/2027
- Unidade: Suite Master 401
- Valor total: R$ 2.850,00
Estamos ansiosos para recebe-la!
Atenciosamente,
Hotel Praia AzulVariaveis disponiveis
Hospede
| Variavel | Descricao | Exemplo |
|---|---|---|
{{guest.firstName}} | Primeiro nome | Maria |
{{guest.fullName}} | Nome completo | Maria Silva |
{{guest.email}} | maria@email.com | |
{{guest.phone}} | Telefone | +55 11 99999-0000 |
{{guest.locale}} | Idioma preferido | pt-BR |
Reserva
| Variavel | Descricao | Exemplo |
|---|---|---|
{{reservation.code}} | Codigo da reserva | RES-4521 |
{{reservation.checkInDate}} | Data de check-in formatada | 15/07/2027 |
{{reservation.checkOutDate}} | Data de check-out formatada | 18/07/2027 |
{{reservation.nights}} | Numero de noites | 3 |
{{reservation.unitName}} | Nome da unidade | Suite Master 401 |
{{reservation.totalFormatted}} | Valor total formatado | R$ 2.850,00 |
{{reservation.status}} | Status traduzido | Confirmada |
Propriedade
| Variavel | Descricao | Exemplo |
|---|---|---|
{{property.name}} | Nome da propriedade | Hotel Praia Azul |
{{property.address}} | Endereco completo | Av. Beira Mar, 1500 |
{{property.phone}} | Telefone da recepcao | +55 21 3333-4444 |
{{property.email}} | Email de contato | contato@praiaazul.com |
{{property.checkInTime}} | Horario de check-in | 14:00 |
{{property.checkOutTime}} | Horario de check-out | 12:00 |
Pagamento
| Variavel | Descricao | Exemplo |
|---|---|---|
{{payment.amountFormatted}} | Valor pago formatado | R$ 850,00 |
{{payment.method}} | Metodo de pagamento | PIX |
{{payment.date}} | Data do pagamento | 10/07/2027 |
{{payment.transactionId}} | ID da transacao | txn_1234567890 |
Links
| Variavel | Descricao |
|---|---|
{{links.portal}} | Link para o portal do hospede |
{{links.review}} | Link para avaliacao |
{{links.unsubscribe}} | Link de cancelamento de inscricao |
{{links.pixQrCode}} | URL da imagem do QR code PIX |
Criar um template
Passo a passo
- Acesse Comunicacao > Templates
- Clique em “Novo Template”
- Preencha:
| Campo | Obrigatorio | Descricao |
|---|---|---|
| Nome | Sim | Identificador interno (ex.: reservation_confirmed) |
| Evento | Sim | Qual evento dispara este template |
| Canais | Sim | Para quais canais criar versoes (email, SMS, WhatsApp) |
- Para cada canal, edite o conteudo:
O editor de email suporta:
- Editor visual (drag-and-drop) — Blocos de texto, imagem, botao, divisor
- Editor HTML — Para personalizacao avancada
- Variaveis — Insira clicando no botao de variaveis
SMS
O editor de SMS e somente texto:
- Contador de caracteres em tempo real
- Indicador de segmentos (1, 2, 3…)
- Alerta quando caracteres especiais forcam UCS-2
O editor de WhatsApp segue o formato exigido pelo Meta:
- Cabecalho: Texto, imagem ou documento
- Corpo: Texto com variaveis {{1}}, {{2}}…
- Rodape: Texto curto
- Botoes: URL, telefone ou resposta rapida
Atenção: Templates de WhatsApp precisam ser submetidos ao Meta para aprovacao. Consulte WhatsApp Business para detalhes.
Templates multi-idioma
Cada template pode ter versoes em todos os idiomas suportados:
| Idioma | Status |
|---|---|
| Portugues (pt-BR) | Obrigatorio (padrao) |
| Ingles (en) | Recomendado |
| Espanhol (es-ES) | Opcional |
| Frances (fr-FR) | Opcional |
O sistema seleciona automaticamente o idioma com base na preferencia do hospede (guest.locale). Se o idioma do hospede nao tem traducao, o pt-BR e usado como fallback.
Gerenciar traducoes
- Abra o template
- Clique na aba do idioma desejado
- Edite o conteudo naquele idioma
- Salve
Preview e teste
Antes de ativar um template, teste-o:
Preview com dados reais
- Abra o template
- Clique em “Preview”
- Selecione um hospede e uma reserva para preencher as variaveis
- Visualize como ficara a mensagem final em cada canal
Enviar teste
- Clique em “Enviar Teste”
- Informe o destinatario (seu email, telefone ou WhatsApp)
- O sistema envia a mensagem com dados de exemplo
- Verifique a formatacao, links e variaveis
Templates padrao do Opero
O sistema inclui templates pre-configurados para os eventos mais comuns:
| Template | Evento | Canais |
|---|---|---|
reservation_confirmed | Reserva confirmada | Email, WhatsApp |
checkin_reminder | 24h antes do check-in | Email, SMS, WhatsApp |
checkout_receipt | Check-out realizado | |
payment_received | Pagamento confirmado | Email, SMS |
review_request | 24h apos check-out | Email, WhatsApp |
password_reset | Redefinicao de senha | |
wifi_credentials | Check-in realizado | SMS |
Esses templates podem ser editados mas nao deletados. Voce pode criar templates customizados adicionais.
Boas praticas
- Teste antes de ativar — Envie para si mesmo e verifique variaveis, formatacao e links
- Mantenha versoes em todos os idiomas — Hospedes internacionais esperam comunicacao no seu idioma
- Seja conciso no SMS — Mantenha abaixo de 160 caracteres; use email para conteudo longo
- Inclua sempre o unsubscribe — Obrigatorio por LGPD para emails de marketing
- Use nomes consistentes — Siga o padrao
evento_descricaopara facilitar organizacao - Revise periodicamente — Informacoes desatualizadas (horarios, politicas) geram confusao
Last updated on