Token Ledger — quota mensal de IA

Toda chamada IA do Zivlo (CRM Qualifier, Smart Campaigns, AI Agents, RAG, Templates) consome tokens da sua quota mensal.

## Endpoint

• GET /api/tokens/balance — saldo + status (healthy/warning/critical/limit_reached/emergency_stopped)
• GET /api/tokens/health — métricas operacionais (top features, failed calls 24h)
• POST /api/tokens/quota — atualizar limites (apenas owner)
• POST /api/tokens/emergency-stop — kill switch global

## Alertas progressivos

• 80%: aviso preventivo (in-app + email)
• 95%: alerta de risco
• 100%: IA pausada automaticamente (se hard_block_at_limit=true)

## Fallback graceful

Quando quota estoura durante atendimento via aiAgentNode, o cliente recebe mensagem humanizada ("Estou transferindo você para um atendente") e a conversa é atribuída ao melhor agente humano disponível. Sessão de fluxo encerra graciosamente.

## Caps por feature

Owner pode setar caps específicos por feature (ex: "smart_campaign não pode usar mais que 500k tokens/mês") via campo feature_caps.