WhatsApp Bot
O canal mais engajado do Romeo. 92% de taxa de abertura, resposta em segundos, disponível 24/7. Sofia mora aqui — qualifica leads, agenda visitas e responde dúvidas enquanto o corretor dorme.
- Versão
- 3.2
- Atualizado
- junho/2026
- API
- Cloud API v18
- Status
- produção
Resumo
WhatsApp é o canal principal de comunicação do Romeo. Com mais de 98% de penetração no Brasil e taxa de abertura de 92%, é onde leads preferem ser contatados e onde corretores fecham mais negócios.
A integração usa WhatsApp Business API (Cloud API) via Meta, permitindo automações, templates aprovados, múltiplos atendentes e a presença constante da Sofia — a IA conversacional do Romeo.
DiferencialEnquanto concorrentes usam WhatsApp apenas para notificações, o Romeo oferece conversação bidirecional completa. O lead responde, Sofia entende, e a negociação avança — tudo sem sair do WhatsApp.
Arquitetura da integração
A integração WhatsApp Business API segue arquitetura event-driven com processamento em tempo real de mensagens recebidas e enviadas.
Meta envia eventos (mensagem recebida, status, etc.) para endpoint Romeo
Evento é validado, normalizado e enfileirado para processamento
Sistema decide: Sofia responde? Corretor assume? Automação dispara?
Sofia processa NLU, consulta contexto, gera resposta
Resposta é enviada via API (template ou session message)
Status (enviado, entregue, lido) atualizado em tempo real
Componentes técnicos
| Componente | Tecnologia | Função |
|---|---|---|
| Webhook receiver | Node.js + Fastify | Recebe eventos da Meta em < 100ms |
| Message queue | Redis Streams | Buffer para picos, garantia de ordem |
| NLU Engine | GPT-4o + embeddings | Entende intenção e extrai entidades |
| Context store | PostgreSQL + Redis | Histórico de conversas e estado |
| Template engine | Liquid | Renderiza templates com variáveis |
| Rate limiter | Redis | Controla limites da API Meta |
Latência: tempo médio de webhook recebido até resposta enviada é de 1.2 segundos. Para respostas Sofia (com LLM), média de 2.8 segundos.
Sofia no WhatsApp
Sofia é a assistente IA do Romeo. No WhatsApp, ela atua como primeira linha de atendimento — qualifica leads, responde dúvidas, agenda visitas e escala para humanos quando necessário.
Capacidades da Sofia
| Capacidade | Exemplo | Autonomia |
|---|---|---|
| Qualificação de lead | "Quantos quartos você precisa?" | Total |
| Match de imóveis | "Tenho 3 opções no seu perfil" | Total |
| Agendamento de visita | "Posso agendar quinta às 14h?" | Total |
| Resposta a dúvidas | "Aceita pet sim, até 10kg" | Total |
| Negociação de valores | "Vou consultar o proprietário" | Parcial |
| Documentação | "Preciso de RG e comprovante" | Total |
| Reclamações | "Vou passar para atendimento humano" | Escala |
Personalidade e tom
- Profissional mas acolhedora — como uma corretora experiente
- Usa linguagem natural, evita jargão técnico
- Responde em português brasileiro, adaptando ao tom do lead
- Usa emojis com moderação (1-2 por mensagem no máximo)
- Nunca mente ou inventa informação — prefere dizer que vai verificar
Handoff para humanoSofia detecta frustração, complexidade ou pedido explícito e escala para o corretor. O handoff inclui resumo da conversa e contexto completo. Corretor recebe notificação push imediata.
Métricas da Sofia
| Métrica | Valor | Benchmark |
|---|---|---|
| Taxa de resolução | 78% | > 70% |
| Tempo médio de resposta | 2.8s | < 5s |
| CSAT (pesquisa pós-conversa) | 4.6/5 | > 4.0 |
| Taxa de handoff | 22% | < 30% |
| Leads qualificados/dia | ~340 | — |
| Visitas agendadas/dia | ~85 | — |
Fluxos conversacionais
Fluxos são jornadas pré-definidas que guiam a conversa. Sofia navega entre fluxos baseado na intenção detectada e estado do lead.
Fluxo: Captação de lead
| Etapa | Sofia diz | Coleta |
|---|---|---|
| 1 | "Oi! Sou a Sofia, assistente da [Imobiliária]. Vi que você se interessou por um imóvel. Posso ajudar?" | Engajamento |
| 2 | "Perfeito! Para encontrar as melhores opções, me conta: você está buscando para alugar ou comprar?" | Intenção |
| 3 | "Qual região você prefere? Pode ser bairro ou zona da cidade." | Localização |
| 4 | "Quantos quartos você precisa? E tem preferência por casa ou apartamento?" | Perfil |
| 5 | "E qual seria seu orçamento máximo de aluguel?" | Budget |
| 6 | "Achei 3 imóveis que combinam com você! Quer ver as opções?" | Qualificação completa |
Fluxo: Agendamento de visita
| Etapa | Sofia diz | Ação |
|---|---|---|
| 1 | "Quer visitar o apartamento na Rua das Flores? Tenho horários disponíveis essa semana!" | Oferta |
| 2 | "Tenho: Terça 10h, Quarta 14h ou Quinta 16h. Qual prefere?" | Lista slots |
| 3 | "Confirmado! Visita na Quarta, 14h, Rua das Flores 123, Ap 401. Vou te lembrar 24h antes." | Confirmação |
| 4 | [Cria evento no calendário, notifica corretor, agenda lembrete] | Automação |
Fluxo: Follow-up pós-visita
| Etapa | Sofia diz | Objetivo |
|---|---|---|
| 1 | "Oi! Como foi a visita ontem no apartamento da Rua das Flores?" | Engajamento |
| 2A | [Se positivo] "Que bom! Quer fazer uma proposta? Posso ajudar com os próximos passos." | Avançar |
| 2B | [Se neutro] "Entendi. Quer ver outras opções parecidas que separei pra você?" | Reengajar |
| 2C | [Se negativo] "Sem problemas. Me conta o que não funcionou pra eu buscar algo melhor." | Feedback |
Fluxos adaptativos: Sofia não segue script rígido. Se o lead pula etapas ou muda de assunto, ela se adapta. O fluxo é um guia, não uma prisão.
Templates aprovados
WhatsApp Business API exige que mensagens iniciadas pela empresa usem templates pré-aprovados pela Meta. O Romeo mantém biblioteca de 28 templates ativos.
Regra de janela de 24h
A Meta permite mensagens livres (session messages) apenas dentro de 24h após a última mensagem do usuário. Fora dessa janela, só templates aprovados podem ser enviados.
| Situação | Tipo de mensagem | Custo |
|---|---|---|
| Usuário enviou msg nas últimas 24h | Session message (livre) | R$ 0,08 |
| Fora da janela de 24h | Template message | R$ 0,25–0,50 |
| Primeira mensagem (empresa inicia) | Template message | R$ 0,25–0,50 |
Categorias de templates
| Categoria | Templates | Exemplos |
|---|---|---|
| Utility | 12 | Confirmação de visita, lembrete de pagamento, status de proposta |
| Authentication | 3 | Código OTP, verificação de identidade |
| Marketing | 8 | Novos imóveis, promoções sazonais, convites para eventos |
| Service | 5 | Pesquisa de satisfação, follow-up de atendimento |
Processo de aprovação
Time de produto cria template seguindo guidelines Meta (sem URLs suspeitos, sem promessas exageradas, CTAs claros).
Template é submetido via Business Manager. Meta analisa em 24-48h.
Se rejeitado, ajustamos e resubmetemos. Taxa de aprovação atual: 94%.
Template aprovado vai para biblioteca do sistema. Disponível para automações e Sofia em até 1h.
Quality ratingMeta monitora qualidade dos templates. Se muitos usuários bloqueiam ou reportam spam, o rating cai e o template pode ser pausado. Monitoramos diariamente.
Automações e gatilhos
WhatsApp é o canal preferido para automações de alta urgência e comunicação conversacional. Integrações disparam mensagens baseadas em eventos do sistema.
| Gatilho | Template | Timing |
|---|---|---|
| Novo lead captado | lead_welcome | Imediato (< 30s) |
| Visita agendada | visit_confirmation | Imediato |
| Visita em 24h | visit_reminder_24h | 24h antes, 9h |
| Visita em 2h | visit_reminder_2h | 2h antes |
| Proposta enviada | proposal_sent | Imediato |
| Proposta aceita | proposal_accepted | Imediato |
| Contrato pronto | contract_ready | Imediato |
| Pagamento vencendo | payment_reminder | D-3, 10h |
| Pagamento confirmado | payment_confirmed | Imediato |
| Lead inativo 7 dias | reengagement_7d | 10h |
Automação: Primeiro contato
Quando um lead chega (portal, site, indicação), o sistema dispara automaticamente:
- Template de boas-vindas com nome do lead e imóvel de interesse
- Sofia assume e inicia qualificação se lead responde em até 24h
- Se não responde, follow-up em D+1 e D+3
- Se ainda não responde, lead é marcado como "frio" e vai para email
Automação: Cascata de cobrança
| Dia | Canal | Mensagem |
|---|---|---|
| D-3 | "Seu aluguel vence em 3 dias. Quer o código PIX?" | |
| D-1 | "Lembrete: aluguel vence amanhã. Tudo certo?" | |
| D+1 | WhatsApp + Email | "Pagamento venceu ontem. Precisa de ajuda?" |
| D+5 | WhatsApp + SMS | "Pagamento em atraso. Regularize para evitar encargos." |
| D+10 | Ligação (Sofia) | Tentativa de contato telefônico automatizado |
Supressão inteligente: se o usuário já pagou, todo o fluxo de cobrança é cancelado automaticamente. Sistema verifica status antes de cada disparo.
Métricas e limites
WhatsApp é monitorado em tempo real com atenção especial aos limites da API e quality score.
Limites da API (Cloud API)
| Limite | Valor | Romeo atual |
|---|---|---|
| Mensagens/segundo | 80 (tier 3) | ~12 pico |
| Templates/hora | Sem limite | ~200 |
| Conversas/dia | Baseado em tier | ~1.500 |
| Números por WABA | 25 | 3 ativos |
| Webhooks/segundo | Sem limite | ~50 pico |
KPIs de performance
| Métrica | Meta | Atual |
|---|---|---|
| Taxa de entrega | > 99% | 99.4% |
| Taxa de leitura | > 90% | 92% |
| Tempo médio de resposta (Sofia) | < 5s | 2.8s |
| Taxa de resposta do lead | > 60% | 67% |
| Quality score | Verde | Verde |
| Custo médio por conversa | < R$ 0.50 | R$ 0.42 |
Quality score
Meta avalia qualidade das mensagens baseado em:
- Taxa de bloqueio (usuários que bloqueiam o número)
- Taxa de report (usuários que reportam como spam)
- Taxa de resposta (engajamento dos usuários)
AlertaSe quality score cai para amarelo, reduzimos volume de templates de marketing em 50%. Se cai para vermelho, pausamos completamente até investigar a causa.
Dashboard: métricas de WhatsApp disponíveis em tempo real no painel de operações. Alertas automáticos via Slack se limites ou qualidade degradam.