← story.propek
STORY 6.11
Bot WhatsApp: Filas por Prioridade e Notificação ao Atendente
Epic: Bot WhatsApp Propek — Handoff v2
PENDING
2026-04-04
ACCEPTANCE CRITERIA (10/10)
1. Pipeline no CRM tem duas visualizações alternáveis: "Por Prioridade" (score decrescente) e "Por Ordem de Chegada" (mais antigo primeiro)
2. HOT (score 70–100): exibido com badge vermelho + texto "HOT", SLA visível de 5 minutos desde a entrada na fila
3. WARM (score 40–69): exibido com badge laranja + texto "WARM", SLA visível de 15 minutos
4. COLD (score 0–39): exibido com badge cinza + texto "COLD", sem SLA obrigatório — bot continua nurturing
5. Quando handoff HOT é criado, o sistema envia notificação via Z-API para o número do atendente configurado com: nome do cliente, produto de interesse, score e link direto para a ficha no CRM
6. Notificação para leads WARM é criada como alerta visual no CRM (sem WhatsApp)
7. Leads COLD ficam na fila mas não geram notificação — o bot continua respondendo em modo nurturing até o score subir
8. Número(s) do(s) atendente(s) para notificação HOT configurado(s) via variável de ambiente `ATENDENTE_WHATSAPP_PHONES` (lista separada por vírgula), sem hardcode
9. Alerta visual no CRM quando timer de 30min do handoff (criado na 6.10) expira — lead sobe na visualização "Por Prioridade" com indicador de "aguardando X minutos"
10. Leads marcados como "Em Atendimento" (atendente assumiu) saem da fila de prioridade mas ficam visíveis em aba separada
ARQUIVOS (7)
propek-whatsapp-bot/src/services/notification.service.ts CREATE
propek-whatsapp-bot/src/migrations/044_handoff_pipeline_classification.sql CREATE
propek-whatsapp-bot/src/handlers/whatsapp.handler.ts MODIFY
propek-whatsapp-bot/src/api/crm/conversations.ts MODIFY
apps/crm/src/lib/api.ts MODIFY
apps/crm/src/app/fila/page.tsx CREATE
apps/crm/src/components/topbar.tsx MODIFY