Como obter a chave de API da OpenAI
Para usar os recursos de Inteligência Artificial do Pingo Chat, é necessário conectar uma chave de API da OpenAI. Siga o passo a passo abaixo para criar a sua.
⚠️ Para gerar a chave de API, é obrigatório ter um método de pagamento cadastrado na conta da OpenAI. Sem isso, a chave não funcionará corretamente.
Passo 1 — Criar uma conta na OpenAI
- Acesse platform.openai.com
- Clique em Sign Up para criar uma conta nova.
- Preencha com seu e-mail e senha, ou entre com sua conta Google ou Microsoft.
- Confirme o e-mail de verificação enviado pela OpenAI.
Se você já tem uma conta, clique em Log In e pule para o Passo 2.
Passo 2 — Adicionar método de pagamento
Antes de gerar a chave, é necessário cadastrar um cartão de crédito internacional na conta.
- No painel da OpenAI, clique em Settings no menu lateral.
- Acesse a opção Billing (Faturamento).
- Clique em Add payment method.
- Informe os dados do cartão de crédito internacional e confirme.
- Se desejar, adicione um saldo inicial — o valor mínimo é $5.
Para evitar cobranças inesperadas, configure um limite de gasto mensal em Billing → Limits. Você também pode acompanhar o consumo em tempo real na aba Usage.
Passo 3 — Gerar a chave de API
- No menu lateral do painel da OpenAI, clique em API Keys.
- Clique no botão Create new secret key.
- Dê um nome para a chave (opcional, mas recomendado para organização).
- Clique em Create secret key.
- Copie a chave gerada imediatamente.
⚠️ A chave é exibida uma única vez. Após fechar a janela, não será possível visualizá-la novamente. Se perder a chave, será necessário gerar uma nova.
Passo 4 — Configurar a chave no Pingo Chat
Com a chave copiada, acesse o Pingo Chat e siga o caminho abaixo:
- Acesse Automações → Agentes de IA.
- Clique no ícone de edição do agente desejado.
- Na aba Início, role a página até a seção Configuração de IA.
- Em Provedor de IA, selecione OpenAI.
- Em Modelo, escolha o modelo desejado (ex: GPT-4o).
- No campo API Key, cole a chave gerada na OpenAI.
- Clique em Salvar agente.
Cada agente pode ter sua própria chave de API e modelo de IA configurados de forma independente.
Boas práticas de segurança
- Nunca compartilhe sua chave de API publicamente.
- Não insira a chave em repositórios de código abertos.
- Se suspeitar que a chave foi comprometida, revogue-a imediatamente em API Keys → Revoke e gere uma nova.
- Crie chaves separadas para cada projeto ou integração para facilitar o controle.