← story.propek
STORY 6.12
Bot WhatsApp: Script do Atendente e Métricas de Handoff
Epic: Bot WhatsApp Propek — Handoff v2
PENDING
2026-04-04
ACCEPTANCE CRITERIA (10/10)
1. Quando o atendente abre a ficha de um lead no CRM, o sistema exibe um script de abertura sugerido no formato: "Oi [Nome], sou [nome do atendente], da Propek. Vi que você perguntou sobre [produto/situação específica] — entendo bem esse ponto. Posso te ajudar a resolver isso agora."
2. O script é personalizado dinamicamente com: nome do cliente (do card 6.9), produto de interesse (do pedido do card 6.9), nome do atendente logado no CRM
3. O script NUNCA repete pergunta que o bot já fez — o sistema exibe abaixo do script quais dados já foram coletados pelo bot (nome, email, CPF/CNPJ, endereço, urgência)
4. Métrica "Tempo handoff → primeira resposta humana": calculado como tempo entre `handoff_leads.created_at` e o primeiro timestamp de mensagem do atendente na conversa — salvo em `handoff_leads.first_response_at`
5. Métrica "Taxa de abandono pós-handoff": percentual de leads com status `waiting` por mais de 2h sem transição para `in_progress` ou `done` — visível no dashboard de métricas do CRM
6. Métrica "Taxa handoff → venda fechada": percentual de leads com status `done` e campo `outcome = 'converted'` sobre total de handoffs — visível no dashboard
7. Métrica "Score médio por handoff": média do campo `score` de todos os handoffs no período selecionado — visível no dashboard com tendência (seta subindo/descendo vs. período anterior)
8. Campo "Dias desde última compra" exibido na ficha do lead no CRM quando disponível — somente leitura, apenas observação (sem automação, sem follow-up)
9. O campo `days_since_last_purchase` é calculado consultando histórico de compras do cliente no Supabase — se não houver histórico, exibir "Primeira compra"
10. Dashboard de métricas acessível em seção dedicada no CRM — período selecionável (última semana / último mês / últimos 3 meses)
TIMELINE
05/04/2026
feat(bot): Epic Handoff v2 — CRM fila page, stories 6.9-6.12, QA + security gates [Story 6.1-sales-intelligence-bot]
329589c
ARQUIVOS (4)
propek-whatsapp-bot/src/migrations/045_handoff_metrics.sql NOVO
propek-whatsapp-bot/src/api/crm/conversations.ts MODIFICADO
apps/crm/src/lib/api.ts MODIFICADO
apps/crm/src/app/fila/page.tsx MODIFICADO