Configurando o xAI Grok para os Agentes de IA do 3CX

Introdução

Este guia explica como integrar o xAI Grok com os Agentes de IA do 3CX para cenários de recepcionista inteligente e atendimento de chamadas.

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

Crie uma Conta no xAI

Se você ainda não tiver uma conta no xAI, crie uma pelo xAI Console e configure o faturamento e os limites de uso adequados.

Criar uma Chave de API

  • No xAI Console, abra “Chaves de API”.
  • Clique em “Criar chave de API”.
  • Copie a chave gerada e guarde-a em um local seguro.

Criar uma Chave de Gerenciamento

  • Abra Configurações > Chaves de Gerenciamento.
  • Crie uma chave de gerenciamento com um nome descritivo, como “3CX-KB”.
  • Conceda acesso de Leitura e Gravação para Coleções e Arquivos e, em seguida, salve.
  • Copie a chave de gerenciamento gerada e guarde-a em um local seguro.

Configurar o xAI Grok no 3CX

No Console de Admin 3CX, acesse Admin > Integrações > IA. Clique em API em tempo real e selecione xAI Grok.

Configurando API Realtime com modelo Grok

  • Configure as seguintes opções:
  • Chave da API: cole a chave da API criada no Console xAI.
  • Chave da API de Gerenciamento: cole a chave de gerenciamento usada para as Fontes de Conhecimento.
  • Modelo de IA em Tempo Real: selecione o modelo Grok em tempo real recomendado pela sua versão do 3CX.
  • Modelo de Texto de IA: selecione o modelo de texto Grok 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 configuração dos Agentes de IA do 3CX.

Observações Técnicas

  • Codec de áudio: PCMU (G.711 μ-law). O xAI oferece suporte direto ao G.711 por meio de WebSockets, permitindo que o 3CX transmita o áudio de telefonia sem a necessidade de conversão adicional de codificação/decodificação.
  • Se sua conta restringir o acesso aos modelos, autorize 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 – conexão WebSocket segura com a API xAI Realtime.
  • O 3CX se conecta ao xAI Realtime por meio de:
  • wss://api.x.ai/v1/realtime

Modelos de IA

A xAI atualiza regularmente os modelos do Grok e pode descontinuar versões mais antigas. A 3CX atualiza suas recomendações à medida que as versões compatíveis mudam. Certifique-se de que a conta da xAI 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-grok/