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
| Canal | Provedor | Uso principal |
|---|---|---|
| AWS SES | Confirmacoes, emails do sistema, ultima opcao do fallback | |
| SMS | AWS SNS | Fallback quando o WhatsApp falha, codigos de verificacao |
| WhatsApp Cloud API (Meta) para notificacoes; Twilio para a caixa de entrada | Confirmacoes, atendimento | |
| Facebook Messenger | Twilio | Conversas 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:
| Evento | Canal | Template |
|---|---|---|
| Reserva confirmada | WhatsApp → SMS → Email | reservation_confirmed |
| Check-in amanha (verificado a cada hora) | WhatsApp → SMS → Email | pre_arrival |
| Check-in realizado | WhatsApp → SMS → Email | welcome |
| Check-out realizado | WhatsApp → SMS → Email | checkout_reminder |
| Reserva cancelada | WhatsApp → SMS → Email | cancellation_confirmed |
| Pagamento nao confirmado | WhatsApp → SMS → Email | payment_failed |
| Tarefa de governanca atribuida | Email (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:
| Status | Descricao |
|---|---|
| Enviado | Mensagem aceita pelo provedor |
| Entregue | WhatsApp confirmou a entrega ao destinatario |
| Lido | Destinatario leu (WhatsApp) |
| Falhou | Envio 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:
| Provedor | Credenciais necessarias |
|---|---|
| Twilio | Account 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.
Navegacao — Paginas da OCP
| Pagina | Descricao |
|---|---|
| Email (AWS SES) | Envio de email, remetente, emails do sistema |
| SMS | SMS via AWS SNS, limites |
| WhatsApp Business | WhatsApp Business API, templates, janela de 24h |
| Campanhas | Situacao das campanhas |
| Templates | Templates 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.