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
## 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.