WhatsApp Business API
O canal de WhatsApp da OCP utiliza a WhatsApp Business API para comunicacao direta com hospedes: as notificacoes automaticas usam a WhatsApp Cloud API da Meta e as conversas da caixa de entrada Mensagens usam o Twilio. O WhatsApp combina a alta taxa de leitura do SMS com a riqueza de conteudo do email, sendo o canal preferido de hospedes brasileiros.
WhatsApp Business API vs WhatsApp comum
A WhatsApp Business API e diferente do app WhatsApp Business que voce usa no celular:
| Aspecto | WhatsApp Business (App) | WhatsApp Business API |
|---|---|---|
| Operacao | Manual (uma pessoa responde) | Automatizada (sistema envia/recebe) |
| Volume | Baixo (centenas/dia) | Alto (milhares/dia) |
| Integracao | Nenhuma | API programavel |
| Templates | Nao necessarios | Obrigatorios para iniciar conversa |
| Custo | Gratuito | Pago por conversa |
| Multiplos atendentes | Nao | Sim |
| Historico centralizado | No celular | No Opero |
Importante: O Opero utiliza exclusivamente a WhatsApp Business API (Cloud API da Meta e Twilio). O app WhatsApp Business nao e suportado.
Tipos de mensagem
O WhatsApp Business API define dois tipos de mensagem com regras diferentes:
1. Mensagens de template (HSM)
Mensagens pre-aprovadas pelo Meta (Facebook) que podem ser enviadas a qualquer momento, mesmo fora de uma conversa ativa:
| Caracteristica | Detalhe |
|---|---|
| Aprovacao | Template deve ser aprovado pelo Meta antes do uso |
| Variaveis | Suporta campos dinamicos (nome, data, valor) |
| Categorias | Utilidade, marketing, autenticacao |
| Idiomas | Cada template pode ter versoes em multiplos idiomas |
| Quando usar | Para iniciar uma conversa ou enviar notificacoes |
Exemplos de templates:
[Utilidade] Confirmacao de reserva:
"Ola {{1}}, sua reserva no {{2}} esta confirmada!
Check-in: {{3}} | Check-out: {{4}}
Valor: {{5}}"
[Marketing] Promocao:
"{{1}}, temos uma oferta especial para voce!
Diarias a partir de R$ {{2}} ate {{3}}.
Reserve agora: {{4}}"
[Autenticacao] Codigo de verificacao:
"Seu codigo de verificacao e {{1}}.
Valido por 10 minutos. Nao compartilhe."2. Mensagens de sessao
Mensagens livres (texto, imagem, documento) que podem ser enviadas apenas dentro de uma janela de 24 horas apos a ultima mensagem do hospede:
| Caracteristica | Detalhe |
|---|---|
| Aprovacao | Nao necessaria — conteudo livre |
| Janela | 24 horas apos ultima mensagem do hospede |
| Formato | Texto, com midia opcional (URL de imagem ou documento) |
| Quando usar | Para responder a mensagens do hospede |
Regra do WhatsApp: Voce so pode enviar mensagens livres (sessao) se o hospede mandou mensagem nas ultimas 24 horas. Fora dessa janela, apenas templates aprovados sao permitidos.
Configurar WhatsApp
As notificacoes automaticas de WhatsApp usam a conta da plataforma Opero — nao ha configuracao por tenant.
Cadastrar um provedor (opcional)
- Acesse Configuracoes > Provedores de Comunicacao
- Na secao WhatsApp, adicione um provedor: Twilio ou Meta (WhatsApp Cloud API)
- Preencha:
| Campo | Descricao |
|---|---|
| Account SID | Identificador da conta Twilio |
| Auth Token | Token de autenticacao |
| Remetente WhatsApp | Numero no formato whatsapp:+55XXXXXXXXXXX |
| Phone Number ID / Access Token | Credenciais da Cloud API (apenas para o provedor Meta) |
- Use as URLs de webhook exibidas na pagina para configurar o Twilio
- Clique em “Testar” para validar as credenciais
Nota: Hoje, as credenciais cadastradas sao usadas apenas no teste de conexao; os envios usam as contas da plataforma.
Templates aprovados
O Opero nao submete templates a Meta e nao ha tela de templates de WhatsApp no dashboard. As notificacoes automaticas usam templates ja aprovados na conta WhatsApp da plataforma, com o nome opero_<template> (ex.: opero_reservation_confirmed) e idioma ingles.
Nas conversas via Twilio, fora da janela de 24 horas so podem ser enviados templates mapeados e aprovados na plataforma.
Janela de 24 horas
A janela de sessao e um conceito fundamental do WhatsApp Business API:
Hospede envia mensagem
│
▼
┌─────────────────────────────────────────┐
│ JANELA DE 24 HORAS │
│ │
│ Hotel pode enviar mensagens livres: │
│ - Texto, imagem, PDF, audio, video │
│ - Sem necessidade de template │
│ - Sem custo adicional de template │
│ │
└──────────────┬──────────────────────────┘
│
▼ (24h sem mensagem do hospede)
┌─────────────────────────────────────────┐
│ FORA DA JANELA │
│ │
│ Hotel so pode enviar: │
│ - Templates aprovados │
│ - Cobra taxa de template │
│ │
└─────────────────────────────────────────┘Renovar a janela
Cada nova mensagem do hospede renova a janela por mais 24 horas.
Custos
Os envios usam as contas da plataforma Opero; o Opero nao tem creditos, cotas ou cobranca por mensagem. Nas mensagens enviadas via Twilio, o custo informado pelo provedor e registrado em cada mensagem.
Boas praticas
- Responda rapido — Aproveite a janela de 24h para resolver solicitacoes
- Nao faca spam — Envios excessivos resultam em bloqueio do numero pelo Meta
- Respeite o opt-out — Nas conversas via Twilio, respostas STOP, SAIR, CANCELAR ou UNSUBSCRIBE registram o opt-out automaticamente
- Mantenha o telefone do hospede correto — O WhatsApp e o primeiro canal tentado nas notificacoes