← story.propek
STORY 6.10
Bot WhatsApp: Mensagem de Transição e Modo Espera Ativo
Epic: Bot WhatsApp Propek — Handoff v2
PENDING
2026-04-04
ACCEPTANCE CRITERIA (10/10)
1. No momento do handoff, o bot envia exatamente a seguinte mensagem: "Perfeito! Coletei todas as informações que precisamos para seguir com o seu atendimento. Vou transferir sua conversa para nosso time comercial — eles já têm acesso a tudo que conversamos aqui. Em até 30 minutos você receberá retorno. Obrigado pela paciência!"
2. Antes do handoff, o bot captura urgência com a pergunta: "Precisa para quando?" — a resposta é salva como campo `urgency` no handoff_leads e incluída no card
3. Durante a coleta de dados (pré-handoff), o bot planta expectativa com mensagem: "Vou reunir as informações para nosso time comercial te atender bem"
4. Em modo `waiting_human`, o bot responde perguntas informativas (horários, endereço, catálogo, como funciona), mas NÃO toma ações comerciais (não inicia novo fluxo de venda, não coleta novos dados, não faz upsell)
5. Timer de exatamente 30 minutos é criado no momento do handoff e persistido no PostgreSQL (tabela `handoff_timers`) — não in-memory, sobrevive a restart do PM2
6. Ao expirar o timer de 30 minutos, o bot envia UMA ÚNICA mensagem ao cliente comunicando alta demanda, informando que o atendimento dele terá prioridade, e disparando alerta visual no CRM
7. O alerta no CRM ao expirar o timer é persistido (coluna `timer_alerted_at` em `handoff_leads`) — não dispara novamente se o PM2 reiniciar
8. Fora do horário de atendimento (seg–sex 7h15–11h45 e 13h15–17h): handoff cria registro na fila mas bot envia mensagem padrão informando horário de atendimento
9. Almoço (11h45–13h15): bot envia mensagem padrão "vamos responder em breve" sem mencionar horário exato
10. Texto exato das mensagens de fora de horário e almoço confirmado com Vinicius antes do deploy (placeholder aceitável na implementação)
ARQUIVOS (8)
propek-whatsapp-bot/src/prompts/system-prompt.ts MODIFY
propek-whatsapp-bot/src/services/timer.service.ts CREATE
propek-whatsapp-bot/src/services/business-hours.service.ts MODIFY
propek-whatsapp-bot/src/services/handoff.service.ts MODIFY
propek-whatsapp-bot/src/handlers/whatsapp.handler.ts MODIFY
propek-whatsapp-bot/src/index.ts MODIFY
propek-whatsapp-bot/src/api/crm/conversations.ts MODIFY
propek-whatsapp-bot/src/migrations/043_handoff_timers_and_urgency.sql CREATE