Para prosseguir com a implementação, precisamos de aprovação nos seguintes pontos:
Após aprovação, a implementação técnica pode começar imediatamente. Detalhes de cada ponto abaixo.
Um assistente virtual no WhatsApp que cobra clientes automaticamente e responde dúvidas em tempo real, usando inteligência artificial para adaptar tom e conteúdo a cada situação.
| Situação | O que o bot faz | Tipo |
|---|---|---|
| Fatura vencida | Envia cobrança com tom progressivo (amigável, firme, urgente) | Cobrança |
| "Vou pagar sexta" | Registra promessa de pagamento e agenda follow-up automático | Registro |
| "Já paguei" (Pix) | Verifica no Conta Azul em tempo real; se confirmado, agradece e atualiza a fatura | Verificação |
| "Já paguei" (Boleto) | Verifica no Conta Azul; se ainda não compensou, avisa: "Boletos levam 1-2 dias úteis para compensar. Vou acompanhar e te aviso assim que confirmar!" Agenda follow-up automático para verificar novamente | Verificação |
| Boleto compensou | Bot recebe webhook do Conta Azul confirmando, atualiza fatura e manda: "Pagamento confirmado! Obrigado, [nome]." | Automação |
| Boleto não compensou (2+ dias) | Bot verifica novamente no Conta Azul; se não caiu, avisa o cliente: "Ainda não identifiquei seu pagamento. Pode enviar o comprovante?" | Follow-up |
| "Que fatura é essa?" | Puxa NF, valor, data de vencimento e envia os detalhes | Consulta |
| "Quanto devo?" | Lista total em aberto e todas as faturas pendentes | Consulta |
| "Quero pagar agora" | Envia link de pagamento (Pix/boleto via Conta Azul) | Pagamento |
| "Quero parcelar" | Escala para atendente humano | Escalação |
| Cliente irritado | Detecta sentimento, acalma a situação, escala para humano | Escalação |
| Cliente ignora cobranças | Escala tom automaticamente (amigável → neutro → firme → urgente) | Cobrança |
| Número desconhecido | "Não encontrei seu cadastro. Qual seu CNPJ?" | Identificação |
| "Oi" / saudação | Identifica pelo telefone, cumprimenta pelo nome, oferece ajuda | Atendimento |
| Pagamento confirmado | Recebe webhook do Conta Azul, atualiza fatura, agradece o cliente | Automação |
| Dias de atraso | Tom | Exemplo de abertura |
|---|---|---|
| 1-3 dias | Amigável | "Oi [nome]! Notei que a fatura X ficou em aberto. Pode ter passado despercebido..." |
| 4-10 dias | Neutro | "Olá [nome]. A fatura X está pendente há [N] dias. Precisa de ajuda?" |
| 11-30 dias | Firme | "[nome], a fatura X está com [N] dias de atraso. É importante regularizar..." |
| 30+ dias | Urgente | "[nome], existem pendências significativas na sua conta. Precisamos resolver..." |
Limites claros para evitar problemas:
| Ação | Motivo |
|---|---|
| Negociar descontos ou parcelamentos | Requer análise humana — política comercial |
| Cancelar contratos ou serviços | Ação irreversível — precisa de confirmação humana |
| Dar aconselhamento jurídico | Risco legal — escala para o departamento correto |
| Enviar mensagens fora do horário comercial | Respeita horário: 8h-20h (seg-sex), 9h-14h (sáb) |
| Insistir quando cliente pede para parar | Respeita opt-out imediatamente |
| Inventar informações financeiras | Só responde com dados confirmados via API |
| Cobrar clientes adimplentes | Régua só dispara para faturas realmente vencidas |
Escalada gradual de pressão psicológica baseada em ciência comportamental. Cada etapa usa uma técnica diferente. O link de pagamento vai em toda mensagem (fricção zero).
Objetivo: Evitar o atraso antes que aconteça. Muitos pagamentos atrasam por esquecimento simples.
Objetivo: Avisar sem pressão. Tom 100% profissional e cordial.
Objetivo: Transformar "vou pagar" em plano concreto com data e ação. Triplica a chance de execução.
Objetivo: Pressão do grupo. Ninguém quer ser o único fora do padrão. Quanto mais específica a comparação, mais eficaz.
Sempre que o cliente responder em qualquer etapa, travar acordo com confirmação escrita. O viés de consistência trabalha a favor.
Último recurso. Enquadra o não-pagamento como perda de algo que o cliente já possui. Usar com moderação — é a arma mais forte.
Estudo BIT/UK provou que agradecer após pagamento aumenta em +19% a adesão futura. Fecha o ciclo de forma positiva.
| Regra | Por quê |
|---|---|
| Link de pagamento em TODA mensagem | Fricção zero — o cliente paga no impulso |
| Nunca começar pela aversão à perda | Queima o relacionamento cedo demais |
| Sempre pedir confirmação escrita | Compromisso por escrito = 3x mais cumprimento |
| Tom empático antes de ser firme | Tom agressivo faz o cliente sumir (efeito avestruz) |
| Personalizar o segmento na prova social | "Empresas de tecnologia" > "empresas em geral" |
| Desconto máximo 10% | Acima disso, escala para funcionário humano |
| Máximo 1 mensagem por dia | Excesso gera bloqueio no WhatsApp |
| Horário: 8h-20h (seg-sex), 9h-14h (sáb) | Respeitar horário comercial, nunca domingo |
| Agradecer após pagamento | Reforço positivo = +19% adesão futura (BIT/UK) |
| Sem emojis em excesso | Contexto B2B — manter tom profissional |
Baseado em: Thaler & Sunstein (Nudge), Kahneman (Prospect Theory), Cialdini (Influence), Gollwitzer (Implementation Intentions), Behavioural Insights Team (UK).
Cada cliente da Uúba recebe um número WhatsApp dedicado, fornecido por nós. O cliente final sempre sabe qual empresa está falando com ele.
| Item | Detalhe |
|---|---|
| Quem fornece o número | A Uúba fornece — o cliente não precisa se preocupar com chip |
| Onboarding | Cliente assina → recebe número dedicado → já sai usando |
| Infraestrutura | Múltiplas instâncias na mesma Evolution API (sem custo extra de infra) |
| Se o número for banido | Nós trocamos sem impacto para o cliente |
| Evolução futura | Migrar para API oficial do WhatsApp Business (número verificado com selo verde) |
| Componente | Tecnologia | Função |
|---|---|---|
| WhatsApp Gateway | Evolution API v2 | Enviar e receber mensagens |
| Orquestração | n8n (self-hosted) | Workflows, webhooks, agendamento |
| Inteligência | Claude Sonnet (Anthropic) | Entender contexto, gerar respostas |
| Backend | FastAPI + PostgreSQL | Dados de clientes, faturas, cobranças |
| Cache | Redis | Sessões WhatsApp, performance |
| Infraestrutura | VPS + Docker + Nginx + SSL | Tudo self-hosted |
Base sólida construída no Sprint 1-2:
| Item | Status | Detalhe |
|---|---|---|
| API REST | Produção | 14 endpoints — clientes, faturas, cobranças, métricas |
| Dados mock | Pronto | 8 clientes, 16 faturas, 13 cobranças para teste |
| Testes automatizados | 174 testes | Unit + integration + security + data integrity |
| CI/CD | Verde | GitHub Actions: lint + test + build |
| n8n | Rodando | Bot WhatsApp ativo + workflow de envio + debounce Redis |
| Conectado | Evolution API v2.3.7 + instância uuba-bot conectada | |
| Chatwoot | Ativo | Plataforma de atendimento integrada ao WhatsApp (chat.uuba.tech) |
| Bot IA | Produção | Claude Sonnet 4 com memória, debounce e 4 tools |
| Infraestrutura | Pronta | VPS + Docker Compose + Nginx + SSL |
| Sprint | Objetivo | Entregas |
|---|---|---|
| Sprint 3 ✓ | WhatsApp Bidirecional |
Evolution API instalada, WhatsApp conectado, workflows de envio e recebimento funcionando |
| Sprint 4 ✓ | Agente Conversacional |
Bot com IA que entende contexto, responde dúvidas, registra promessas, escala para humano |
| Sprint 5 | Régua Automática |
Cobrança automática com tom progressivo, follow-up de promessas, integração com histórico de conversa |
| Sprint 6 | Pagamento + Polish |
Webhook Conta Azul (pagamento confirmado), link de pagamento via WhatsApp, feedback loop do agente |
| Item | Quando | Responsável |
|---|---|---|
| Número WhatsApp (chip dedicado para o bot)✓ | Sprint 3 | Equipe |
| DNS wa.uuba.tech apontando para a VPS✓ | Sprint 3 | Equipe (Wix DNS) |
| Aprovação do tom e mensagens de cobrança | Sprint 4 | Equipe |
| Conta Azul (sandbox para testes de pagamento) | Sprint 6 | Equipe |
| Risco | Impacto | Mitigação |
|---|---|---|
| WhatsApp bane o número por spam | Alto | Começar com poucos clientes, tom amigável, respeitar opt-in/opt-out, horário comercial |
| IA alucina dados financeiros | Alto | Prompt rigoroso: bot SEMPRE valida dados contra a API antes de responder; nunca inventa valores |
| Cliente confunde bot com humano | Médio | Primeira mensagem sempre inclui "Sou o assistente virtual da Uúba" |
| Evolution API instável | Médio | Monitoramento ativo, fallback para API oficial do WhatsApp se necessário |
| Custo de API da Anthropic | Baixo | Claude Haiku para triagem (barato), Sonnet só para respostas complexas |
Como vamos medir se o bot está funcionando:
% de mensagens enviadas com sucesso via WhatsApp
% de clientes que respondem após cobrança
% de conversas resolvidas sem escalar para humano
% de faturas pagas após interação com o bot
Tempo médio entre mensagem do cliente e resposta do bot
Redução no prazo médio de recebimento