Configurazione di xAI Grok per gli agenti 3CX IA

Introduzione

Questa guida spiega come integrare xAI Grok con gli agenti 3CX IA per scenari di reception intelligente e gestione delle chiamate.

Questa funzionalità richiede l'edizione 3CX IA.

Configurare un account xAI

Se non si dispone già di un account xAI, crearne uno tramite la Console xAI e configurare la fatturazione e i limiti di utilizzo appropriati.

Creare una chiave API

  • Nella console xAI, aprire la sezione Chiavi API.
  • Cliccare su Crea chiave API.
  • Copiare la chiave generata e conservarla in un luogo sicuro.

Creare una chiave di gestione

  • Aprire Impostazioni > Chiavi di gestione.
  • Creare una chiave di gestione con un nome descrittivo, ad esempio “3CX-KB”.
  • Concedere l’accesso in lettura e scrittura per raccolte e File, quindi salvare.
  • Copiare la chiave di gestione generata e conservala in un luogo sicuro.

Configura xAI Grok in 3CX

Nella Console di amministrazione 3CX, andare su Admin > Integrazioni > IA. Cliccare su API in tempo reale e scegliere xAI Grok.

  • Configurare le seguenti impostazioni:
  • Chiave API: Incollare la chiave API creata nella Console xAI.
  • Chiave API di gestione: Incollare la chiave di gestione utilizzata per le fonti di conoscenza.
  • Modello IA in tempo reale: Selezionare il modello Grok in tempo reale consigliato dalla propria versione di 3CX.
  • Modello di testo IA: Selezionare il modello di testo Grok consigliato dalla propria versione di 3CX.
  • Compilare i campi:
  • Nome azienda
  • Descrizione azienda; questa informazione viene utilizzata dagli agenti AI per comprendere il contesto della propria organizzazione.
  • Cliccare su Salva.

Configurazione degli agenti IA e delle basi di conoscenza

Per informazioni dettagliate sulla configurazione degli agenti IA, consultare la guida principale alla configurazione degli agenti IA di 3CX.

Note tecniche

  • Codec audio: PCMU (G.711 μ-law). xAI supporta direttamente il G.711 su WebSockets, consentendo a 3CX di trasmettere l’audio telefonico senza ulteriori operazioni di codifica/decodifica.
  • Se l'account limita l’accesso ai modelli, abilitare i modelli selezionati per Realtime e Text nelle impostazioni dell’API Realtime.
  • Assicurati che il 3CX Firewall Checker superi il controllo con esito positivo.
  • Consentire il traffico in uscita su:
  • TCP 443 – connessione WebSocket sicura all’API Realtime di xAI.
  • 3CX si connette a xAI Realtime utilizzando:
  • wss://api.x.ai/v1/realtime

Modelli IA

xAI aggiorna regolarmente i modelli Grok e potrebbe rendere obsolete le versioni precedenti. 3CX aggiorna le proprie raccomandazioni man mano che cambiano le versioni supportate. Assicurarsi che l’account xAI possa accedere ai modelli richiesti dalla versione di 3CX installata.

Per saperne di più

Ultimo aggiornamento
Il presente documento è stato aggiornato il 24 agosto 2026
https://www.3cx.it/doc/ai-agent-configuration-grok/