← story.propek
STORY 6.9
Bot WhatsApp: Card de Handoff Cognitivo
Epic: Bot WhatsApp Propek — Handoff v2
PENDING
2026-04-04
ACCEPTANCE CRITERIA (11/11)
1. No momento do handoff (tag `[HANDOFF:COMERCIAL]` detectada), o sistema chama Claude Sonnet com a conversa completa para gerar um resumo analítico estruturado
2. O card inclui DADOS DO CLIENTE: nome completo, telefone, email, CNPJ/CPF, tipo (B2B/B2C) com perfil (lava-rápido / auto peças / estética / consumidor), cidade/estado
3. O card inclui PEDIDO DE INTERESSE: tabela com Produto | Quantidade | Subtotal, mais campo de observações sobre o pedido
4. O card inclui RESUMO DA CONVERSA gerado pelo Claude Sonnet: síntese dos pontos mais importantes, objeções levantadas e como foram tratadas, tom e sentimento do cliente
5. O card inclui OPORTUNIDADES IDENTIFICADAS geradas pelo Claude Sonnet: sugestões de upsell/cross-sell baseadas APENAS em produtos reais do Supabase — NUNCA inventar produto ou nome
6. O card inclui as ÚLTIMAS 5 MENSAGENS da conversa para contexto imediato
7. O card inclui mídia processada quando houver: transcrições de áudios (se disponível) e descrições de imagens enviadas pelo cliente
8. Score do lead (HOT/WARM/COLD com valor numérico 0–100) exibido com destaque no topo do card
9. O card é salvo em campo dedicado na tabela `handoff_leads` (coluna `handoff_card` JSONB)
10. Geração do card não bloqueia o handoff: se Claude Sonnet falhar ou timeout (>10s), o handoff ocorre normalmente com card parcial/vazio — graceful degradation obrigatória
11. Card exibido no CRM (apps/crm/) na ficha do lead ao abrir o handoff
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 (7)
propek-whatsapp-bot/src/services/handoff-card.service.ts CREATE
propek-whatsapp-bot/src/services/handoff.service.ts MODIFY
propek-whatsapp-bot/src/handlers/whatsapp.handler.ts MODIFY
propek-whatsapp-bot/src/migrations/042_add_handoff_card.sql CREATE
propek-whatsapp-bot/src/api/crm/conversations.ts MODIFY
apps/crm/src/lib/api.ts MODIFY
apps/crm/src/app/conversas/page.tsx MODIFY