Quando a IA não responde: causas comuns

O que é

Se um recurso de IA não gera resultado, quase sempre é uma de poucas causas. Aqui está o checklist na ordem mais provável.

1. Chave Anthropic não configurada

O sintoma é um aviso pedindo pra configurar a chave (HTTP 402, "configure em Configurações → IA"). Vá em Configurações → IA e salve uma chave válida no formato sk-ant-.... Para os recursos automáticos (auto-qualificação, sentimento, mini-resumo), é preciso que algum gerente da org tenha chave salva — senão esses jobs são pulados em silêncio.

2. Módulo AI First desativado

Sintoma: "Módulo AI First não habilitado" (HTTP 402, needsModule: ai_first). O módulo não está ligado pra sua org. Fale com o gestor ou com o time do Teha pra ativar (ou assine um plano Pro/Business, que já incluem).

3. Limite de chamadas estourado

Sintoma: "Você está chamando IA rápido demais. Aguarde uns segundos" (HTTP 429). São no máximo 10 chamadas de IA por minuto por usuário. Espere os segundos indicados e tente de novo. No forecast sem AI First, o limite é 5/dia por org.

4. Sem contexto suficiente

Sugestão, resumo, forecast e próxima ação precisam de mensagens de texto na conversa. Conversa vazia, só com mídia, ou muito curta (menos de 2–3 mensagens) faz a IA retornar "sem dados". Áudios precisam ser transcritos antes pra virarem contexto.

5. Crédito esgotado na Anthropic

Se a conta Anthropic da org ficou sem crédito, as chamadas falham com erro vindo da Anthropic. Verifique o saldo no console deles e recarregue.

6. Transcrição falhando

A transcrição depende do Gemini, não da Anthropic. Se ela falha mas o resto da IA funciona, é problema da configuração de transcrição no ambiente do Teha — reporte pelo suporte.

Ainda travado?

Abra uma dúvida na Central de Ajuda (botão ?). Descreva o recurso, o que apareceu na tela e o horário — se for bug da sua org, a IA escala direto pro time.