Pular para o conteúdo
Oráculo

Gerando API Keys

Neste guia, voce vai aprender como criar uma chave de acesso (API Key) para conectar assistentes de IA ao Oraculo.

O que e uma API Key?

Uma API Key e como uma “senha especial” que permite que ferramentas externas (como Claude ou ChatGPT) acessem seus dados no Oraculo de forma segura. E a ponte entre a IA e os seus dados de campanhas, leads e vendas.

Sem a API Key, a IA nao consegue se conectar. Com ela, a IA pode consultar e operar seus dados conforme voce pedir.

Cada API Key:

  • E unica e pertence a sua conta
  • Pode ter um nome para voce saber onde esta sendo usada
  • Pode ser excluida a qualquer momento (revogando o acesso)

Onde fica?

As API Keys ficam em Configuracao > Configuracoes > aba API Keys.

Screenshot: [Pagina de Configuracoes com a aba API Keys selecionada, mostrando a tabela de chaves criadas com botao “Criar nova key”]

Passo a passo para criar uma chave

1. Acesse as configuracoes

  1. No menu lateral, clique em Configuracao (icone de engrenagem)
  2. Clique em Configuracoes
  3. Clique na aba API Keys

2. Clique em “Criar nova key”

No card API Keys, clique no botao Criar nova key no canto superior direito.

3. De um nome para a chave

Escolha um nome que identifique onde voce vai usar essa chave. Exemplos:

  • “Claude Desktop”
  • “ChatGPT”
  • “Cursor”
  • “Computador do escritorio”

Clique em Criar.

4. Copie a chave

Uma janela aparece mostrando sua chave completa.

MUITO IMPORTANTE: Copie a chave agora e guarde em local seguro. Ela nao sera exibida novamente. Se voce fechar essa janela sem copiar, precisara criar uma nova chave.

Screenshot: [Janela mostrando a API Key criada com botao de copiar e aviso de que a chave nao sera exibida novamente]

5. Conecte na ferramenta de IA

Na mesma janela, voce ja ve as instrucoes de como conectar. Siga o passo a passo indicado para a ferramenta que voce usa (Claude, ChatGPT, Cursor etc.).

Conectando ao Claude (web — claude.ai)

  1. No Claude, va em Configuracoes > Conectores > Adicionar conector personalizado
  2. Nome: Oraculo
  3. Cole a URL e a chave conforme indicado no painel
  4. Salve

Conectando ao Claude Desktop

  1. Abra o arquivo de configuracao do Claude Desktop:

    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json

  2. Adicione a configuracao com sua API Key e o endereco do servidor, conforme indicado no painel

  3. Reinicie o Claude Desktop

Conectando ao ChatGPT

  1. No ChatGPT, va em Configuracoes > Conectores > Adicionar conector
  2. Cole a URL e a chave conforme indicado no painel
  3. Salve

Gerenciando chaves existentes

Na tabela de API Keys, voce ve todas as chaves criadas com:

  • Nome — Como voce nomeou
  • Prefixo — Inicio da chave (para identificacao, ja que a chave completa nao e exibida)
  • Ultimo uso — Quando a chave foi usada pela ultima vez
  • Criada em — Data de criacao

Como revogar uma chave

Se voce acha que uma chave foi comprometida (alguem nao autorizado teve acesso) ou simplesmente nao precisa mais dela, revogue imediatamente.

Passo a passo

  1. No menu lateral, clique em Configuracao
  2. Clique em Configuracoes
  3. Clique na aba API Keys
  4. Na lista de chaves, encontre a que deseja revogar
  5. Clique no botao Excluir (icone de lixeira) ao lado da chave
  6. Confirme a exclusao

Screenshot: [Lista de API Keys com o botao de excluir destacado]

Apos revogar, a chave para de funcionar imediatamente. Qualquer ferramenta que estivesse usando essa chave perdera o acesso ate que voce configure uma nova.

Cuidados de seguranca

  • Nao compartilhe sua API Key — Ela da acesso aos dados da sua conta
  • Crie chaves separadas — Use uma chave para cada ferramenta. Se precisar revogar uma, as outras continuam funcionando
  • Exclua chaves que nao usa — Se voce parou de usar o Claude Desktop, exclua a chave dele
  • A chave so aparece uma vez — No momento da criacao. Copie e guarde em local seguro
  • Se a chave vazou, revogue na hora — Crie uma nova depois

Quem pode criar API Keys?

Somente usuarios com papel de Dono ou Gerente podem criar e revogar API Keys. Se voce e Viewer, peca ao administrador da conta.

Perguntas frequentes

Quantas API Keys posso criar?

Nao ha limite. Crie quantas precisar.

A chave expira?

Nao. A chave funciona ate voce excluir manualmente.

Posso usar a mesma chave em duas ferramentas?

Pode, mas nao e recomendado. Se voce precisar revogar o acesso de uma ferramenta, vai afetar a outra tambem. O ideal e criar uma chave para cada ferramenta.

Perdi minha chave. Como recupero?

Nao e possivel recuperar. Crie uma nova chave e configure na ferramenta novamente.

Se eu excluir uma chave, perco meus dados?

Nao. Excluir uma chave so revoga o acesso daquela chave especifica. Seus dados continuam intactos no Oraculo.

Posso ver a chave completa depois de criada?

Nao. Por seguranca, a chave completa so e exibida uma vez, no momento da criacao. Se voce perdeu, crie uma nova.

Resumo

  • API Keys sao chaves de acesso para conectar a IA ao Oraculo
  • Crie em: Configuracao > Configuracoes > aba API Keys > botao “Criar nova key”
  • Copie a chave na hora — ela so aparece uma vez
  • Trate como senha: nao compartilhe, nao publique
  • Revogue imediatamente se a chave for comprometida
  • Crie chaves separadas para cada ferramenta ou pessoa