Skip to Content

Opero Communication Platform (OCP) — Visao Geral

A Opero Communication Platform (OCP) e o modulo de comunicacao do Opero, responsavel pela interacao com hospedes e equipe via email, SMS e WhatsApp. A OCP separa a logica de negocio dos provedores de envio por meio de adaptadores (AWS SES, AWS SNS, Meta e Twilio).


O que e a OCP?

A OCP centraliza as comunicacoes do hotel:

  • Notificacoes transacionais — Confirmacao de reserva, pre-chegada, boas-vindas no check-in, check-out, cancelamento
  • Comunicacao operacional — Emails para a equipe quando uma tarefa de governanca ou um chamado e atribuido
  • Atendimento ao hospede — Caixa de entrada Mensagens, com conversas de email e WhatsApp

Matriz de canais

CanalProvedorUso principal
EmailAWS SESConfirmacoes, emails do sistema, ultima opcao do fallback
SMSAWS SNSFallback quando o WhatsApp falha, codigos de verificacao
WhatsAppWhatsApp Cloud API (Meta) para notificacoes; Twilio para a caixa de entradaConfirmacoes, atendimento
Facebook MessengerTwilioConversas na caixa de entrada

Arquitetura provider-agnostic

A logica de negocio (decidir o que enviar, quando e para quem) e separada da infraestrutura de envio (AWS SES, AWS SNS, Meta, Twilio).

┌────────────────────────────────────────────────────────────┐ │ LOGICA DE NEGOCIO │ │ │ │ Reserva confirmada → Enviar confirmacao ao hospede │ │ Check-in amanha → Enviar mensagem de pre-chegada │ │ Tarefa de governanca atribuida → Email para a equipe │ │ │ ├────────────────────────────────────────────────────────────┤ │ CAMADA DE ORQUESTRACAO │ │ │ │ Escolhe canal (WhatsApp → SMS → Email) → Aplica template │ │ Substitui variaveis → Envia → Registra tentativa │ │ │ ├──────────────┬───────────────┬─────────────────────────────┤ │ AWS SES │ AWS SNS │ Meta / Twilio │ │ (Email) │ (SMS) │ (WhatsApp) │ └──────────────┴───────────────┴─────────────────────────────┘

Vantagens

  • Troca de provedor sem impacto: Se o AWS SES for substituido, apenas o adaptador muda
  • Fallback entre canais: Se o WhatsApp falha, o Opero tenta SMS; se o SMS falha, envia email

Fluxo de uma comunicacao

1. Evento gatilho

Um evento acontece no sistema que requer comunicacao:

EventoCanalTemplate
Reserva confirmadaWhatsApp → SMS → Emailreservation_confirmed
Check-in amanha (verificado a cada hora)WhatsApp → SMS → Emailpre_arrival
Check-in realizadoWhatsApp → SMS → Emailwelcome
Check-out realizadoWhatsApp → SMS → Emailcheckout_reminder
Reserva canceladaWhatsApp → SMS → Emailcancellation_confirmed
Pagamento nao confirmadoWhatsApp → SMS → Emailpayment_failed
Tarefa de governanca atribuidaEmail (equipe)housekeeping_assigned

2. Template processado

O sistema seleciona o template correspondente, substitui as variaveis (nome do hospede, datas, codigo da reserva) e formata para o canal escolhido.

3. Envio

A mensagem e enviada pelo primeiro canal disponivel (WhatsApp se ha telefone e o WhatsApp esta ativo; depois SMS; por fim email). Cada tentativa e registrada:

StatusDescricao
EnviadoMensagem aceita pelo provedor
EntregueWhatsApp confirmou a entrega ao destinatario
LidoDestinatario leu (WhatsApp)
FalhouEnvio falhou — o proximo canal da cadeia e tentado

Configuracao inicial

1. Provedores

Email (AWS SES), SMS (AWS SNS) e as notificacoes de WhatsApp sao gerenciados centralmente pelo Opero — nao ha configuracao por tenant.

Em Configuracoes > Provedores de Comunicacao, o tenant pode cadastrar remetentes de WhatsApp, Instagram e Facebook Messenger:

ProvedorCredenciais necessarias
TwilioAccount SID + Auth Token + remetente (WhatsApp) ou ID da pagina (Instagram/Facebook)
Meta (WhatsApp Cloud API)Phone Number ID + Access Token + Verify Token + App Secret

Cada provedor pode ser testado (“Testar”) e marcado como padrao. Hoje, as credenciais cadastradas sao usadas apenas no teste de conexao; os envios usam as contas da plataforma.

2. Templates

As mensagens automaticas usam templates do sistema. Consulte Templates para ver os templates e variaveis disponiveis.


Consentimento e opt-out (LGPD)

Nas conversas via Twilio (caixa de entrada):

  • Opt-out por palavra-chave: Se o hospede responder STOP, SAIR, CANCELAR ou UNSUBSCRIBE, o opt-out e registrado; START, RESUMIR ou SUBSCRIBE reativam
  • Registro de consentimento: Opt-ins e opt-outs ficam registrados por canal
  • Marketing exige opt-in: Envios de marketing exigem consentimento explicito; envios transacionais so sao bloqueados por opt-out explicito

As notificacoes automaticas (WhatsApp, SMS e email) nao verificam consentimento antes do envio.


PaginaDescricao
Email (AWS SES)Envio de email, remetente, emails do sistema
SMSSMS via AWS SNS, limites
WhatsApp BusinessWhatsApp Business API, templates, janela de 24h
CampanhasSituacao das campanhas
TemplatesTemplates do sistema e variaveis

Perguntas frequentes

Preciso de conta propria no Twilio?

Nao. Email, SMS e as notificacoes de WhatsApp usam contas gerenciadas pelo Opero. O cadastro de Twilio ou Meta em Provedores de Comunicacao e opcional.

Posso usar outro provedor de email?

A arquitetura da OCP e extensivel. Atualmente, AWS SES e o provedor suportado para email. Novos provedores serao adicionados conforme demanda.

As mensagens de WhatsApp tem custo?

O Opero nao tem creditos, cotas ou cobranca por mensagem. Os envios usam as contas da plataforma.

Last updated on