Guia de primeiros socorros no CRM — qual tela abrir para cada sintoma.
| Sintoma | Primeira tela | O que checar |
|---|---|---|
| "Lead não recebeu a Smart Campaign" | /crm/smart-campaigns/:id | status da campanha, opt-out do contato, janela 24h, emergency stop de tokens |
| "Cadência travou" | /crm/sequences/followups (filtro paused/failed) | stop_reason, último erro do worker, cadência está ativa? |
| "Automação não disparou" | /crm/automations → histórico | is_active? trigger_type correto? condições não matcharam? |
| "Score do lead parece errado" | /crm/qualifications | última rodada, BANT detalhado, modelo usado |
| "Sem mensagens sendo geradas pela IA" | Settings → IA → Token Ledger | emergency_stop ativo? quota estourou? |
| "Deal sumiu do Kanban" | Kanban → filtro por status | deal está won ou lost? cooling_status filtrado? |
| "Smart Campaign custou muito" | /crm/qualifications + Settings → Tokens | compare custo por qualificação, troque modelo para Haiku |
| "Cadência mandou texto errado" | /crm/sequences → editar step | modo IA com prompt ambíguo? trocar para template? |
| "Forecast no Dashboard está estranho" | /crm/settings → estágios | win_probability configurada? estágios marcados is_won/is_lost? |
| "Deal deveria entrar em campanha mas não entra" | /crm/smart-campaigns → target_filter | cooling_status='cold'? status='active'? tem contact_phone? |
## Problemas comuns e soluções
Era bug até recentemente. O primeiro step agora respeita delay_hours. Verifique em /crm/sequences.
Verifique se a cadência está ativa (badge verde). Só cadências ativas podem ser iniciadas em deals.
Na tela /crm/sequences cada card tem botão ▶ verde. Clica e escolhe pipeline + deal.
Verifique os operadores e tipos de campo. lead_score é number — use gte/gt, não contains.
O target_filter é muito restritivo ou o filtro implícito (status='active' + contact_phone obrigatório) eliminou todos. Use "Estimar" antes de criar.