Para utilizar os recursos de Inteligência Artificial disponíveis no CXM de Atendimento PipeRun, é necessário conectar a plataforma à API da OpenAI por meio de uma chave de autenticação, a chamada API Key. Esse processo envolve criar uma conta na OpenAI, acessar o painel de desenvolvedores, gerar a credencial e garantir que há saldo disponível para consumo.
Neste artigo, você aprenderá como criar uma conta na OpenAI, navegar até a área de gerenciamento de chaves, gerar e salvar corretamente a sua API Key e adicionar créditos para que a integração funcione sem interrupções.
Atenção! As imagens utilizadas neste artigo foram obtidas diretamente do site oficial da OpenAI. É possível que tenham sido capturadas em uma data anterior, o que pode resultar em informações desatualizadas.
REQUISITOS
Conta ativa no CXM de Atendimento PipeRun;
Acesso a um endereço de e-mail válido para criar e confirmar a conta na OpenAI;
Cartão de crédito válido para adição de créditos na plataforma da OpenAI.
TÓPICOS DO ARTIGO
CRIAR CONTA NA OPENAI
O primeiro passo para conectar a inteligência artificial ao CXM de Atendimento PipeRun é ter uma conta ativa na OpenAI. O cadastro é feito diretamente em openai.com e pode ser realizado com e-mail e senha ou por meio de autenticação social com Google, Microsoft ou Apple. Após preencher os dados básicos, a OpenAI enviará um e-mail de verificação que precisa ser confirmado antes de liberar o acesso completo à plataforma.
Se a sua empresa já possui uma conta organizacional na OpenAI, solicite ao administrador que envie um convite de acesso em vez de criar uma conta pessoal. Isso centraliza o gerenciamento de chaves e o controle de consumo em um único ambiente corporativo.
Acesse https://openai.com/pt-BR/ no seu navegador.
Clique no botão "Entrar", no canto superior direito da tela.
No menu suspenso exibido, escolha a opção "Plataforma de API".
Na página de autenticação, clique em "Cadastrar" (1), informe seu e-mail e defina uma senha, ou autentique (2) com Google, Microsoft ou Apple.
Informe um endereço de e-mail e senha e clique em "Continuar".
Acesse seu e-mail e informe o código (1) recebido e clique em "Continuar".
Pronto! Ao finalizar o cadastro você será direcionado para a tela de API Platform.
ACESSAR A PLATAFORMA DE API
Após criar a conta, é preciso acessar o ambiente correto dentro da OpenAI. A Plataforma de API, disponível em https://platform.openai.com/login é um painel separado do ChatGPT, com gerenciamento próprio de projetos, chaves e consumo. É aqui que ficam todas as ferramentas necessárias para configurar a integração com o CXM de Atendimento PipeRun.
A Plataforma de API é um ambiente distinto do ChatGPT. O saldo de créditos e as API Keys criadas aqui não se aplicam a uma assinatura ChatGPT Plus, as cobranças são independentes e não se comunicam entre si.
No site https://auth.openai.com/log-in clique em "Entrar" (1) e a no menu suspenso, selecione "Plataforma de API" (2).
Você será redirecionado para https://platform.openai.com/home. No painel inicial, é possível visualizar o resumo de consumo, incluindo tokens utilizados, requisições realizadas e créditos restantes.
O menu lateral do painel está organizado em três grupos principais, que concentram todas as funcionalidades disponíveis:
Create : Chat, Agent Builder, Audio, Images, Videos, Assistants, Codex.
Manage: Usage, API Keys, ChatGPT Apps, Logs, Storage, Batches.
Optimize: Evaluation.
CRIAR A API KEY
A API Key é a credencial que autentica as chamadas feitas à OpenAI a partir de integrações externas, como o CXM de Atendimento PipeRun. Sem ela, a plataforma não consegue se comunicar com os modelos de linguagem. O processo de geração é simples, mas exige atenção em um ponto crítico: a chave é exibida uma única vez, logo após a criação, e não pode ser recuperada depois que o modal for fechado.
Copie a API Key imediatamente após a geração e guarde-a em um local seguro, como um gerenciador de senhas. Se o valor for perdido, será necessário revogar a chave atual e criar uma nova, o que pode interromper integrações já configuradas.
No menu lateral, clique em "API keys", dentro do grupo Manage.
Na tela de API Keys, clique em "+ Create new secret key".
No modal exibido, configure os campos conforme descrito abaixo e clique em "Create secret key" para gerar a chave.
Owned by: escolha You para vincular a chave ao seu usuário, ou Service account para contas de serviço de uso compartilhado;
Name (opcional): informe um nome descritivo para identificar a finalidade da chave, por exemplo, "IA-CXM PipeRun";
Project: defina o projeto ao qual a chave estará vinculada. Por padrão, utiliza o "Default project";
Permissions: selecione o nível de acesso "All" (acesso total).
Para integrações com o CXM de Atendimento PipeRun, utilize a permissão All e vincule a chave a um projeto dedicado. Isso facilita o monitoramento do consumo separado por integração e simplifica a gestão de acessos.
Clique em "Create secret key".
Clique em "Copy" para copiar a chave gerada.
Atenção! Guarde sua chave secreta em um local seguro, pois você não poderá visualizá-la novamente. Mantenha-a em segurança, pois qualquer pessoa com sua chave de API poderá fazer solicitações em seu nome. Caso a perca, você precisará gerar uma nova.
Pronto! Agora você já tem o API Key necessária para utilizar a Inteligência Artificial no CXM de Atendimento PipeRun.
ADICIONAR CRÉDITOS
A API da OpenAI funciona sob um modelo de consumo pré-pago, cada chamada realizada desconta tokens do saldo disponível. Novas contas entram com saldo de US$ 0,00 e precisam de um método de pagamento cadastrado antes de realizar qualquer requisição. Sem créditos, a integração com o CXM de Atendimento PipeRun retornará erros de autenticação ou de cota insuficiente.
Atenção! É de responsabilidade exclusiva do Cliente monitorar e manter atualizado o saldo de créditos na OpenAI. Em caso de saldo insuficiente, os Assistentes de IA de Atendimento do CXM não serão capazes de responder aos clientes. Por favor, revise diariamente sua conta para evitar interrupções no atendimento.
Os dados do cartão de crédito devem ser inseridos diretamente pelo titular. Nunca compartilhe informações de pagamento em integrações, fluxos automatizados ou com terceiros.
No menu lateral, clique em "Home" e, em seguida, em "Add Credits".
Na aba Overview, clique em "Add payment details".
Preencha os dados do cartão de crédito no modal exibido e clique em "Continue" para salvar o método de pagamento.
Card information: informe o número do cartão, a data de validade (MM/AA) e o código de segurança (CVC);
Name on card: preencha o nome do titular exatamente como aparece no cartão;
Country: escolha o país de cobrança — o padrão para contas brasileiras é Brazil;
Address: indique o endereço de cobrança vinculado ao cartão;
Purchasing as a business: marque esta opção caso a compra seja feita em nome de uma empresa — isso habilita os campos de CNPJ e razão social para emissão de nota fiscal.
Após salvar o cartão, acesse Billing > Add credits para definir o valor inicial de recarga.
Inserir Imagem/vídeo/demoPreencha os campos abaixo para configurar a compra inicial de créditos e o comportamento de recarga automática da sua conta.
Initial credit purchase (obrigatório): informe o valor em dólares da compra inicial de créditos que será cobrada imediatamente. O valor deve estar entre $5 e $100.
Auto recharge: defina se o sistema deve recarregar os créditos automaticamente quando o saldo estiver baixo. Ative o botão para habilitar a recarga automática.
When balance drops to: indique o valor mínimo de saldo, em dólares, que deve acionar a recarga automática. Ao atingir esse limite, o sistema adiciona créditos de forma automática.
Restore balance to: aponte o valor, em dólares, para o qual o saldo deve ser restaurado após cada recarga automática.
Recharge amount: exibe o valor calculado automaticamente que será cobrado a cada recarga. Corresponde à diferença entre Restore balance to e When balance drops to.
Importante Este campo é apenas informativo e não pode ser editado diretamente.
Monthly recharge limit: estabeleça um teto mensal de recargas automáticas para evitar cobranças inesperadas. Quando desativado, o limite máximo é definido pelo seu plano (padrão: $100).
Atenção! O valor inserido será cobrado no cartão cadastrado assim que você clicar em Continue".
PERGUNTAS FREQUENTES
1. "Preciso de uma conta paga na OpenAI para usar a integração com o CXM de Atendimento PipeRun?"
R: Sim. A API da OpenAI funciona por consumo de tokens com modelo pré-pago. Mesmo que a conta seja gratuita, é necessário adicionar créditos para que as chamadas sejam processadas. Contas novas entram com saldo US$ 0,00 e precisam cadastrar um método de pagamento antes de realizar qualquer requisição.
2. "Minha API Key parou de funcionar. O que devo fazer?"
R: Verifique primeiro se há saldo disponível na sua conta acessando platform.openai.com > Billing. Se o saldo estiver zerado, adicione créditos. Caso o problema persista, acesse API keys, revogue a chave atual e gere uma nova, atualizando também o valor no painel do CXM de Atendimento PipeRun.
3. "Posso usar a mesma API Key para múltiplas integrações?"
R: Tecnicamente sim, mas não é recomendado. Criar uma chave por integração — e vinculá-la a projetos separados — facilita o controle de consumo, a identificação de problemas e a revogação pontual de acessos sem afetar outros serviços.
4. "A API Key da OpenAI é a mesma da conta do ChatGPT?"
R: Não. A Plataforma de API e o ChatGPT são ambientes distintos com cobranças independentes. Uma assinatura ChatGPT Plus não fornece créditos de API, e as chaves geradas na plataforma de API não se aplicam ao uso do ChatGPT.
Pronto! Com a API Key gerada e os créditos configurados, você já tem tudo o que precisa para concluir a integração da OpenAI com o CXM de Atendimento PipeRun e começar a usar os recursos de inteligência artificial na sua operação de atendimento.
Em caso de dúvidas, chame nossa equipe no chat. 😉