"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

  1. Vá em Configurações → Integrações → Chave de IA própria (OpenAI).
  2. 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.

Veja também