Configurando o OpenAI para Agentes de IA 3CX

Introdução

Este guia explica como integrar o OpenAI com os Agentes de IA da 3CX para permitir cenários inteligentes de recepcionista e atendimento de chamadas com tecnologia de IA.

Este recurso requer uma licença 3CX IA.

Passo 1: Configurando Uma Conta OpenAI

Se você ainda não tem uma conta OpenAI, crie uma, configure o faturamento e gere uma Chave API.

Crie um Projeto e Configure o Faturamento

• Faça login na página de Login da OpenAI.
• Crie um novo Projeto e dê a ele um nome descritivo.
• Vá para Configurações → Faturamento e conclua a configuração do faturamento.
• Certifique-se de ter crédito suficiente para o uso esperado.

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 com um gasto mínimo de US$ 100 geralmente são promovidas diretamente para o Nível 3.

Configure Acesso e Limites do Modelo

• Vá para “Projeto → Limites”.
• Defina um orçamento para controlar seus gastos.
• Na seção “Permitir ou Bloquear Modelos”, mantenha a lista vazia para permitir todos os modelos
• Em 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 OpenAI / histórico da conta.

Crie Uma Nova Chave API

• Vá para “Painel → Chaves API”.
• Clique em “Criar uma Nova Chave Secreta”.
• Insira um nome descritivo e defina as permissões como “Todas”.
• Copie e armazene-a em local seguro.

Passo 2: Configurando o OpenAI no 3CX

• No Console de Admin, vá para "Admin → Integrações → IA" e clique no botão API OpenAI.
  

• Cole sua Chave Secreta OpenAI.
• Selecione os modelos:

• Modelo OpenAI para Chamadas em Tempo Real: gpt-realtime (recomendado)
• Modelo OpenAI para Texto: gpt-5o-mini (recomendado)

• Preencha:

• Nome da Empresa
• Descrição da Empresa – usada pelos Agentes de IA para compreender o contexto da sua organização.

• Clique no botão Salvar.

Passo 3: Adicione Fontes de Conhecimento/RAG (Traga Seu Próprio Conteúdo)

As Fontes de Conhecimento permitem que os agentes recuperem conteúdo específico da empresa durante chamadas/chats (políticas, FAQs, regras de encaminhamento, documentos de produtos). No ecossistema da OpenAI, isso é comumente implementado por meio da ingestão de arquivos + incorporação/pesquisa vetorial para recuperação.

• No Console do Admin, vá para "Admin → Integrações → IA".
• Clique no botão Fontes de Conhecimento e em seguida no botão Adicionar.

• Defina um Nome e uma Descrição para sua base de conhecimento.
• Faça o upload de arquivos (PDFs/docs/texto) contendo qualquer informação relacionada ao seu negócio, como:

• Horário comercial e regras para feriados
• Instruções de encaminhamento do departamento
• Perguntas Frequentes sobre produtos/preços
• "O que fazemos / como falar sobre nós" – texto descritivo

• DICAS

• Certifique-se de que a Descrição descreve com precisão o conteúdo da base de conhecimento para melhorar a recuperação de informações.
• Se você tiver documentos que abordam contextos diferentes e não relacionados (por exemplo, documentos médicos e documentos internos de política de viagens), não os coloque no mesmo armazenamento; crie armazenamentos de conhecimento separados para cada contexto.
• A API OpenAI não atualiza o 3CX a cada alteração na base de conhecimento; a cada alteração que você fizer, pressione o botão Atualizar e aguarde a conclusão do processo.

Observação: As Fontes de Conhecimento são criadas e cobradas no projeto/chave OpenAI que você configurou.

Passo 4: Criação e Configuração de Agentes de IA

• Clique no botão "Admin → Integrações → IA → Adicionar Agente".

• Escolha o tipo de agente:

• Recepcionista: Agente de IA voltado para a empresa para atendimento básico de chamadas e encaminhamento.
• Assistente Pessoal: Ajustado para atender chamadas para um usuário específico (por exemplo, um executivo).

• Na guia Informações do Agente:

• Defina as Configurações Gerais do seu Agente de IA:

• Ramal – número de ramal exclusivo para o agente de IA
• Assistente Para (apenas AP) – qual usuário o PA representa
• Membro do Departamento – a que departamentos o Agente de IA pertence
• Primeiro e Último Nome – a identidade falada/visível do Agente de IA
• Número(s) DID atribuído(s) – números diretos de entrada que chegam ao Agente de IA

• Configure as Definições de Voz e Chamadas para o seu Agente de IA:

• Estilo de Voz – selecione sua opção de voz preferida
• Gravação de Chamadas – Desativada, Todas as chamadas ou Apenas chamadas externas
• Duração Máxima da Chamada
• Link de Conversação do Agente – ativa o recurso “clique para falar” ou o chat a partir de um site; deixar o campo em branco desativa o link para este agente

• Na guia Tipo de Agente:

• Defina as Fontes de Conhecimento – escolha quais Fontes de Conhecimento o agente pode acessar
• Defina o Idioma de Introdução – idioma padrão de saudação

• Você também pode Permitir a Troca de Idioma.

• Defina a Mensagem de Boas-vindas – a primeira mensagem falada ao interlocutor

• In the Agent Instructions tab, your AI Behaviour Instructions have been pre-configured; if necessary, however, the Customize Prompt button allows tuning of tone, policy boundaries, “do/don’t” rules
• Na guia Instruções do Agente, suas Instruções de Comportamento da IA foram pré-configuradas; no entanto, se necessário, o botão Personalizar Prompt permite ajustar o tom, os limites da política e as regras do tipo “fazer/não fazer”.
• Na guia Bloquear chamadas de Spam:

• A Proteção Contra Spam está ativada por padrão.
• Você pode personalizar o que É Considerado Spam para definir o que significa Spam ou Fraude e quais ações devem ser tomadas:

• Encerrar Chamada
• Transferir Para (um gerente/revisor)
• Enviar resumo da triagem + desligar

• Na guia Encaminhamento de Chamadas (somente Recepcionista):

• Adicione regras de Comportamento de Encaminhamento para que seu agente de IA possa encaminhar chamadas e chats de forma inteligente para diferentes destinos com base na sua descrição.

• Por exemplo, se o interlocutor disser “Recebo o erro 404”, o Agente de IA pode classificar isso como uma chamada de suporte e transferi-la para um destino com uma descrição como “Em caso de erros HTTP, transfira para aqui”.
• Você pode criar várias entradas de encaminhamento, mas evite sobreposições excessivas para garantir um encaminhamento preciso.

• Se você Permitir o Encaminhamento de Ramal por Nome, seu Agente de IA permitirá que os chamadores solicitem transferências por nome; por exemplo, “Por favor, transfira-me para o George”.
• Com o Modo de Confidencialidade ativado:

• isso impede que a IA revele informações confidenciais, como sobrenomes e informações sobre funcionários.
• Tenha em mente que, se você combinar isso com a opção Permitir Encaminhamento de Ramal por Nome, seu agente de IA não poderá, por exemplo, perguntar “Temos dois Georges, George Takei e George Washington. Com qual deles você gostaria de falar?”, mas pedirá ao chamador o nome completo do destinatário pretendido.

• Na guia Triagem de Chamadas:

• Você pode Desativar a Triagem de Chamadas para Contatos Conhecidos, o que flexibiliza o processo de triagem para contatos conhecidos e confiáveis armazenados na agenda telefônica.
• Você pode ativar a caixa de seleção Verificar Ocupado Antes de Transferir a chamada para garantir que o ramal de destino esteja disponível antes de transferir a chamada.

• Na guia Opções:

• As Ações de Resposta ao Chamador visam dois tipos específicos de chamadores problemáticos:

• Pessoas hostis ou abusivas ao telefone.
• Pessoas não colaborativas que impedem a conversa.

• Ações apropriadas podem ser configuradas para gerenciar essas situações automaticamente.

Observações Técnicas

• Codec de áudio: Apenas PCMU suportado.
• Configuração de Rede/Firewall

• Certifique-se de que o Verificador de Firewall lhe dê um atestado de boa saúde.
• Você também precisará permitir o tráfego de saída para:

• TCP 443 (HTTPS)
• UDP 3478 (STUN/TURN)

• Observação sobre Modelos de IA:

• A OpenAI atualiza constantemente seus modelos e, à medida que versões novas e melhoradas são disponibilizadas, as versões mais antigas tornam-se obsoletas. As informações contidas neste documento serão atualizadas periodicamente para se manterem em dia com as opções recomendadas atualmente. Você precisará garantir que sua conta OpenAI esteja configurada para permitir que os modelos mais recentes sejam usados pelo 3CX.
• As novas versões do 3CX atualizarão automaticamente os modelos configurados para os equivalentes mais modernos.

Última Atualização

Este documento foi atualizado pela última vez em 26 de maio de 2026.

https://www.3cx.com.br/docs/configuracao-agente-ia/