WhatsApp — Hoteis & Pousadas¶

Visao Geral¶

A integracao WhatsApp permite enviar notificacoes automaticas para hospedes: confirmacao de reserva, lembrete de check-in e mensagens customizadas.

Arquitetura¶

sequenceDiagram
    participant BE as Hotel Backend
    participant H as Herald
    participant EVO as Evolution API
    participant WA as WhatsApp

    BE->>H: POST /whatsapp/send
    H->>EVO: POST /message/sendText
    EVO->>WA: Mensagem enviada
    WA-->>EVO: Resposta do hospede
    EVO->>H: Webhook (messages.upsert)
    H->>BE: POST {webhookUrl}

Configuracao¶

1. Conectar numero WhatsApp¶

Na pagina Configuracoes > Comunicacao > WhatsApp:

Clique em "Conectar WhatsApp"
Escaneie o QR Code com o WhatsApp do hotel
Aguarde a conexao ser confirmada

2. Configurar Templates¶

Templates disponiveis:

Template	Trigger	Descricao
Confirmacao	Reserva confirmada	Envia dados da reserva
Lembrete Check-in	24h antes do check-in	Lembra o hospede
Boas-vindas	Check-in realizado	Mensagem de boas-vindas
Check-out	Check-out realizado	Agradecimento

Cada template pode usar variaveis:

{nome} — Nome do hospede
{hotel} — Nome do hotel
{quarto} — Numero do quarto
{checkin} — Data de check-in
{checkout} — Data de check-out
{codigo} — Codigo da reserva

3. Interface de Templates¶

A interface usa layout de lista lateral + editor:

Lista lateral: Mostra todos os templates com nome e tipo
Editor: Ao selecionar um template, abre o editor na direita
Variaveis: Banner informativo com variaveis disponiveis

Envio Automatico¶

O WhatsAppSchedulerService envia mensagens automaticamente:

Confirmacao: Ao confirmar reserva
Lembrete: 24h antes do check-in
Boas-vindas: Ao fazer check-in

Verificacao de Status¶

O sistema verifica se o WhatsApp esta conectado antes de enviar:

GET /whatsapp/configs/{ownerRef}/connection

Se desconectado, a mensagem e logada como erro mas nao impede o fluxo.

ownerRef¶

Cada hotel tem um ownerRef unico no Herald:

hotel-{hotelId}

Todas as configuracoes WhatsApp (numero, templates, webhook) sao isoladas por ownerRef.