"Chave própria da OpenAI (e o fim do modo avançado)"
Recurso para quem já tem conta na OpenAI e prefere pagar os tokens direto. Explica também o que usar no lugar do antigo modo avançado de prompt próprio.
Este é um recurso avançado. Se você só quer que o agente atenda, ignore esta página: os créditos do plano e a recarga automática cobrem tudo, sem conta na OpenAI.
Por padrão, os agentes do ScalaCRM rodam na inteligência da plataforma e consomem os créditos de IA do seu plano (1 crédito = 1 resposta). Se você prefere pagar os tokens direto para a OpenAI, basta cadastrar a sua chave.
A regra é simples: quem paga o token não paga crédito.
O que muda ao cadastrar a chave
- Os agentes passam a rodar na sua conta da OpenAI: o custo dos tokens é cobrado lá, direto pelo provedor.
- Eles deixam de consumir os créditos do plano. Os créditos ficam intactos.
- O construtor de agentes continua liberado do mesmo jeito: fluxo guiado, biblioteca de agentes e o editor (Conhecimento, Procedimentos, Ações, Políticas e Testes). Tudo funciona igual.
Removendo a chave, os agentes voltam a rodar na inteligência da plataforma e a consumir créditos normalmente. Nada é apagado.
Como cadastrar
- Vá em Configurações → Integrações → Chave de IA própria (OpenAI).
- Cole a sua chave (
sk-...) e salve. Ela é guardada criptografada e nunca é exibida de volta.
⚠️ Se a chave ficar inválida ou sem saldo, os agentes param de responder: a OpenAI recusa a chamada. Nesse caso avisamos você pelo sino e por notificação, com o link para corrigir. Se preferir voltar aos créditos do plano, é só remover a chave.
Vale a pena para mim?
- Use os créditos do plano se você quer simplicidade: uma conta só, uma fatura, sem gerenciar chave nem saldo na OpenAI.
- Use a chave própria se você já tem conta na OpenAI ou quer controlar o gasto direto na fonte.
Nos dois casos o agente é o mesmo, com todas as proteções: travas da aba Políticas, catálogo de produtos, memória do lead e follow-up. O editor mostra, no fim da aba Políticas, se o agente está usando chave própria ou os créditos do plano, com o botão Gerenciar chave.
E o modo avançado (prompt próprio)?
O antigo modo avançado, em que você escrevia o prompt inteiro do agente à mão, e os modelos da plataforma foram aposentados em outubro de 2026. Hoje todo agente usa o mesmo editor, com as abas Conhecimento, Procedimentos, Ações, Políticas e Testes. Ter chave própria não muda isso.
O que você escrevia no prompt tem lugar certo agora:
- Fatos do negócio (preços, endereço, perguntas frequentes): aba Conhecimento.
- Como agir em cada situação (roteiro, objeções, quando chamar uma pessoa): aba Procedimentos.
- O que o agente faz no CRM (mover card, avisar, agendar): aba Ações.
- Onde atende, ritmo e o que nunca pode sair numa resposta: aba Políticas.
Um agente que usava um modelo da plataforma mostra o aviso "Este agente usava um modelo da plataforma que foi descontinuado. Revise as instruções antes de ativar." Revise as abas e ative de novo.
