Skip to Content
Comunicação (OCP)WhatsApp Business

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:

AspectoWhatsApp Business (App)WhatsApp Business API
OperacaoManual (uma pessoa responde)Automatizada (sistema envia/recebe)
VolumeBaixo (centenas/dia)Alto (milhares/dia)
IntegracaoNenhumaAPI programavel
TemplatesNao necessariosObrigatorios para iniciar conversa
CustoGratuitoPago por conversa
Multiplos atendentesNaoSim
Historico centralizadoNo celularNo 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:

CaracteristicaDetalhe
AprovacaoTemplate deve ser aprovado pelo Meta antes do uso
VariaveisSuporta campos dinamicos (nome, data, valor)
CategoriasUtilidade, marketing, autenticacao
IdiomasCada template pode ter versoes em multiplos idiomas
Quando usarPara 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:

CaracteristicaDetalhe
AprovacaoNao necessaria — conteudo livre
Janela24 horas apos ultima mensagem do hospede
FormatoTexto, com midia opcional (URL de imagem ou documento)
Quando usarPara 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)

  1. Acesse Configuracoes > Provedores de Comunicacao
  2. Na secao WhatsApp, adicione um provedor: Twilio ou Meta (WhatsApp Cloud API)
  3. Preencha:
CampoDescricao
Account SIDIdentificador da conta Twilio
Auth TokenToken de autenticacao
Remetente WhatsAppNumero no formato whatsapp:+55XXXXXXXXXXX
Phone Number ID / Access TokenCredenciais da Cloud API (apenas para o provedor Meta)
  1. Use as URLs de webhook exibidas na pagina para configurar o Twilio
  2. 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

  1. Responda rapido — Aproveite a janela de 24h para resolver solicitacoes
  2. Nao faca spam — Envios excessivos resultam em bloqueio do numero pelo Meta
  3. Respeite o opt-out — Nas conversas via Twilio, respostas STOP, SAIR, CANCELAR ou UNSUBSCRIBE registram o opt-out automaticamente
  4. Mantenha o telefone do hospede correto — O WhatsApp e o primeiro canal tentado nas notificacoes
Last updated on