Templates
Os templates da OCP sao os modelos das mensagens automaticas enviadas por WhatsApp, SMS e email. Eles sao definidos pelo sistema: nao ha editor de templates no dashboard, e os textos sao em ingles.
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, da reserva ou da propriedade no momento do envio. O mesmo texto e usado no SMS e no email; no WhatsApp, e usado o template aprovado correspondente (opero_<template>).
Exemplo
Template: reservation_confirmed
Hello {{guestName}}! Your reservation at {{propertyName}} is confirmed.
Check-in: {{checkinDate}} | Check-out: {{checkoutDate}}
Confirmation code: {{confirmationCode}}
We look forward to welcoming you!Resultado para o hospede:
Hello Maria! Your reservation at Hotel Praia Azul is confirmed.
Check-in: 2027-07-15 | Check-out: 2027-07-18
Confirmation code: RES-4521
We look forward to welcoming you!O assunto do email tambem vem do template (ex.: “Reservation Confirmed”).
Variaveis disponiveis
As variaveis usam o formato {{nomeDaVariavel}}. Cada template tem suas proprias variaveis:
| Template | Variaveis |
|---|---|
reservation_confirmed | guestName, propertyName, checkinDate, checkoutDate, confirmationCode |
reservation_pending_confirmation | guestName, confirmationCode, confirmLink |
pre_arrival | guestName, propertyName, checkinDate, checkInLink |
checkin_link | guestName, checkinDate, checkoutDate, checkInLink |
welcome | guestName, propertyName, roomNumber, wifiPassword |
checkout_reminder | guestName, checkoutTime, outstandingAmount |
cancellation_confirmed | guestName, propertyName, refundTimeline |
no_show | guestName, checkinDate |
payment_failed | guestName, propertyName, reason |
guest_verify_email | guestName, expiryMinutes, link |
guest_verify_sms | code, url, expiryMinutes |
Criar um template
Nao e possivel criar ou editar os templates das mensagens automaticas pelo dashboard; textos e assuntos sao definidos no sistema.
Com a OCP ativada, a API GET/POST/DELETE /api/tenants/:tenantId/ocp/templates permite cadastrar templates no formato do WhatsApp (componentes HEADER, BODY, FOOTER e BUTTONS; categorias UTILITY, MARKETING e AUTHENTICATION). Os templates criados ficam com status PENDING — o Opero nao os envia para aprovacao da Meta.
Templates multi-idioma
Os templates do sistema existem apenas em ingles. Nao ha versao por idioma nem selecao pelo idioma do hospede.
Templates padrao do Opero
O sistema inclui estes templates:
| Template | Evento | Canais |
|---|---|---|
reservation_confirmed | Reserva confirmada (inclusive pelo Portal de Reservas) | WhatsApp → SMS → Email |
reservation_pending_confirmation | Reserva criada pela equipe, aguardando confirmacao do hospede | WhatsApp → SMS → Email |
pre_arrival | Dia anterior ao check-in | WhatsApp → SMS → Email |
checkin_link | Envio manual do link de check-in | WhatsApp → SMS → Email |
welcome | Check-in realizado | WhatsApp → SMS → Email |
checkout_reminder | Check-out realizado | WhatsApp → SMS → Email |
cancellation_confirmed | Reserva cancelada | WhatsApp → SMS → Email |
no_show | No-show registrado | WhatsApp → SMS → Email |
payment_failed | Pagamento nao confirmado | WhatsApp → SMS → Email |
guest_verify_email | Confirmacao de dados do hospede | |
guest_verify_sms | Confirmacao de dados do hospede | SMS |
Boas praticas
- Mantenha email e telefone do hospede atualizados — O canal usado depende deles
- Cadastre o telefone em formato internacional — Necessario para WhatsApp e SMS