Skip to Content

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:

TemplateVariaveis
reservation_confirmedguestName, propertyName, checkinDate, checkoutDate, confirmationCode
reservation_pending_confirmationguestName, confirmationCode, confirmLink
pre_arrivalguestName, propertyName, checkinDate, checkInLink
checkin_linkguestName, checkinDate, checkoutDate, checkInLink
welcomeguestName, propertyName, roomNumber, wifiPassword
checkout_reminderguestName, checkoutTime, outstandingAmount
cancellation_confirmedguestName, propertyName, refundTimeline
no_showguestName, checkinDate
payment_failedguestName, propertyName, reason
guest_verify_emailguestName, expiryMinutes, link
guest_verify_smscode, 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:

TemplateEventoCanais
reservation_confirmedReserva confirmada (inclusive pelo Portal de Reservas)WhatsApp → SMS → Email
reservation_pending_confirmationReserva criada pela equipe, aguardando confirmacao do hospedeWhatsApp → SMS → Email
pre_arrivalDia anterior ao check-inWhatsApp → SMS → Email
checkin_linkEnvio manual do link de check-inWhatsApp → SMS → Email
welcomeCheck-in realizadoWhatsApp → SMS → Email
checkout_reminderCheck-out realizadoWhatsApp → SMS → Email
cancellation_confirmedReserva canceladaWhatsApp → SMS → Email
no_showNo-show registradoWhatsApp → SMS → Email
payment_failedPagamento nao confirmadoWhatsApp → SMS → Email
guest_verify_emailConfirmacao de dados do hospedeEmail
guest_verify_smsConfirmacao de dados do hospedeSMS

Boas praticas

  1. Mantenha email e telefone do hospede atualizados — O canal usado depende deles
  2. Cadastre o telefone em formato internacional — Necessario para WhatsApp e SMS
Last updated on