Configurando o OpenAI para os Agentes de IA do 3CX

Introdução

Este guia explica como integrar o OpenAI aos Agentes de IA da 3CX para cenários de recepcionista inteligente e atendimento de chamadas.

Este recurso requer a versão Edição IA 3CX.

Crie uma Conta na OpenAI

Se você ainda não tem uma conta na OpenAI, faça login ou crie uma na página de login da OpenAI.

Criar um Projeto e Configurar o Faturamento

  • Faça login na página de login da OpenAI.
  • Crie um novo projeto e dê a ele um nome descritivo.
  • Acesse “Configurações → Faturamento” e conclua a configuração de cobrança.
  • Certifique-se de ter crédito suficiente para o uso previsto.

Observação: É necessário ter uma conta paga na OpenAI para que o serviço funcione corretamente; as contas de teste têm funcionalidades limitadas e podem apresentar problemas ou erros imprevisíveis. As contas da OpenAI que pagam no mínimo US$ 100 geralmente são promovidas diretamente para o Nível 3.

Configurar o Acesso e os Limites do Modelo

  • Vá para “Projeto → Limites”.
  • Estabeleça um orçamento para controlar seus gastos.
  • Na seção “Permitir ou bloquear modelos”, mantenha a lista vazia para permitir todos os modelos
  • Na seção “Limites de taxa”, aumente os limites para os modelos acima conforme necessário (instalações maiores podem exigir limites mais altos para evitar comportamentos imprevisíveis).

Observação sobre Limites de Taxa: sua capacidade de aumentar os limites depende do seu nível de uso da API da OpenAI e do histórico da sua conta.

Criar uma Nova Chave de API

  • Acesse “Painel → Chaves API”.
  • Clique em “Criar uma Nova Chave Secreta”.
  • Digite um nome descritivo e defina as permissões como “Todos”.
  • Copie a chave e guarde-a em um local seguro.

Configurar o OpenAI no 3CX

No Console de Admin 3CX, acesse Admin > Integrações > IA. Clique em API em Tempo Real e selecione OpenAI no menu suspenso “Provedor de IA”.

Configurando o OpenAI no 3CX

  • Configure as seguintes opções:
  • Chave da API: cole a chave da API criada no painel da OpenAI.
  • Modelo de IA em Tempo Real: selecione o modelo em Tempo Real da OpenAI recomendado pela sua versão do 3CX.
  • Modelo de Texto de IA: selecione o modelo de texto da OpenAI recomendado pela sua versão do 3CX.
  • Preencha:
  • Nome da Empresa
  • Descrição da Empresa; essa informação é utilizada pelos Agentes de IA para compreender o contexto da sua organização.
  • Clique no botão “Salvar”.

Configurar Agentes de IA e Fontes de Conhecimento

Para obter informações detalhadas sobre a configuração do Agente de IA, consulte o guia principal de Connfiguração dos Agentes de IA do 3CX.

Observações Técnicas

  • Codec de áudio: PCMU
  • Se sua conta da OpenAI restringir o acesso aos modelos, autorize o gpt-realtime-whisper e os modelos selecionados para “Realtime” e “Text” nas configurações da API Realtime.
  • Certifique-se de que o 3CX Firewall Checker seja aprovado.
  • Permitir tráfego de saída em:
  • TCP 443 – utilizado para sinalização e estabelecimento de sessão da API em tempo real da OpenAI.
  • UDP 3478 – utilizado para a conexão de mídia do WebRTC.
  • A 3CX estabelece a conexão com o OpenAI Realtime em três etapas:

Modelos de IA

A OpenAI atualiza regularmente seus modelos e pode descontinuar versões mais antigas. A 3CX atualiza seus modelos recomendados à medida que as versões compatíveis mudam. Certifique-se de que o projeto da OpenAI tenha acesso aos modelos exigidos pela versão do 3CX instalada.

Veja Também


Última atualização:
Este documento foi atualizado pela última vez em 20 de agosto de 2026,
https://www.3cx.com.br/docs/ai-agent-configuration-openai/