Opero Communication Platform (OCP) — Visao Geral
A Opero Communication Platform (OCP) e o modulo de comunicacao do Opero, responsavel por toda interacao com hospedes e equipe via email, SMS e WhatsApp. A OCP utiliza uma arquitetura provider-agnostic, permitindo trocar ou combinar provedores sem alterar a logica de negocio.
O que e a OCP?
A OCP centraliza todas as comunicacoes do hotel em uma unica plataforma:
- Notificacoes transacionais — Confirmacao de reserva, lembrete de check-in, fatura
- Comunicacao operacional — Alertas para equipe de governanca, manutencao, recepcao
- Campanhas de marketing — Promocoes, programas de fidelidade, reativacao de hospedes
- Atendimento ao hospede — Conversas via WhatsApp, respostas a solicitacoes
Matriz de canais
| Canal | Provedor | Uso principal |
|---|---|---|
| AWS SES | Confirmacoes, faturas, campanhas, relatorios | |
| SMS | Twilio | Lembretes, codigos de verificacao, alertas urgentes |
| Twilio (WhatsApp Business API) | Atendimento, confirmacoes, mensagens interativas |
Arquitetura provider-agnostic
A OCP foi projetada para nao depender de um provedor especifico. A logica de negocio (decidir o que enviar, quando e para quem) e separada da infraestrutura de envio (Twilio, AWS SES, etc.).
┌────────────────────────────────────────────────────────────┐
│ LOGICA DE NEGOCIO │
│ │
│ Reserva confirmada → Enviar confirmacao por email │
│ Check-in amanha → Enviar lembrete por SMS + WhatsApp │
│ Hospede VIP chegou → Notificar gerente por WhatsApp │
│ │
├────────────────────────────────────────────────────────────┤
│ CAMADA DE ORQUESTRACAO │
│ │
│ Escolhe canal → Aplica template → Substitui variaveis │
│ Agenda envio → Registra tentativa → Trata falhas │
│ │
├──────────────┬───────────────┬─────────────────────────────┤
│ AWS SES │ Twilio │ (Futuro: outro provedor) │
│ (Email) │ (SMS + WA) │ │
└──────────────┴───────────────┴─────────────────────────────┘Vantagens
- Troca de provedor sem impacto: Se o AWS SES for substituido, apenas o adaptador muda
- Multi-provedor: Usar AWS SES para emails transacionais e outro para campanhas
- Fallback: Se um provedor falha, redirecionar para outro automaticamente
Fluxo de uma comunicacao
1. Evento gatilho
Um evento acontece no sistema que requer comunicacao:
| Evento | Canal padrao | Template |
|---|---|---|
| Reserva confirmada | reservation_confirmed | |
| Check-in amanha | SMS + WhatsApp | checkin_reminder |
| Check-out realizado | checkout_receipt | |
| Solicitacao de avaliacao | Email + WhatsApp | review_request |
| Senha de Wi-Fi | SMS | wifi_credentials |
| Alerta de governanca | WhatsApp (equipe) | housekeeping_alert |
2. Template processado
O sistema seleciona o template correspondente, substitui as variaveis (nome do hospede, datas, valores) e formata para o canal escolhido.
3. Envio
A mensagem e enviada pelo provedor configurado. O status e rastreado:
| Status | Descricao |
|---|---|
| Enviado | Mensagem entregue ao provedor |
| Entregue | Provedor confirmou entrega ao destinatario |
| Lido | Destinatario abriu/leu (quando rastreavel) |
| Falhou | Envio falhou (bounce, numero invalido, etc.) |
| Bloqueado | Destinatario fez opt-out |
Configuracao inicial
1. Configurar provedores
Acesse Configuracoes > Comunicacao > Provedores e configure as credenciais:
| Provedor | Credenciais necessarias |
|---|---|
| AWS SES | Gerenciado centralmente pelo Opero (sem configuracao por tenant) |
| Twilio | Account SID + Auth Token + Phone Number |
| Twilio WhatsApp Business Number |
2. Configurar canais por evento
Defina quais canais sao usados para cada tipo de comunicacao:
- Acesse Configuracoes > Comunicacao > Eventos
- Para cada evento, selecione os canais ativos
- Defina a prioridade (se o canal principal falhar, qual e o fallback)
3. Configurar templates
Cada evento precisa de um template por canal. Consulte Templates para criar e gerenciar templates.
Consentimento e opt-out (LGPD)
A OCP respeita a legislacao de protecao de dados:
- Consentimento explicito: O hospede deve autorizar cada canal de comunicacao
- Opt-out facil: Toda mensagem inclui opcao de cancelar inscricao
- Registro de consentimento: O sistema registra quando e como o consentimento foi dado
- Canais separados: O hospede pode autorizar email mas recusar SMS, por exemplo
LGPD: O Opero armazena apenas os dados minimos necessarios para comunicacao. Dados de mensagens sao retidos por 12 meses e depois anonimizados.
Navegacao — Paginas da OCP
| Pagina | Descricao |
|---|---|
| Email (AWS SES) | Configuracao de email, deliverability, SPF/DKIM |
| SMS (Twilio) | Configuracao de SMS, limites, opt-out |
| WhatsApp Business | WhatsApp Business API, templates aprovados, sessoes |
| Campanhas | Campanhas de marketing, segmentacao, A/B testing |
| Templates | Editor de templates, variaveis, preview multi-canal |
Perguntas frequentes
Preciso de conta propria no Twilio?
O email e gerenciado centralmente pelo Opero via AWS SES, entao voce nao precisa de conta de provedor de email. Para SMS e WhatsApp, cada propriedade (ou rede) deve ter sua propria conta no Twilio para garantir controle sobre limites, custos e reputacao de envio.
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?
Sim. O WhatsApp Business API cobra por mensagem conforme a categoria (utilidade, marketing, servico). Os custos sao cobrados pelo Twilio na conta da propriedade.