Configurazione di OpenAI per gli agenti AI di 3CX

Introduzione

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

Questa funzionalità richiede un edizione 3CX IA.

Configurare un account OpenAI

Se non disponi già di un account OpenAI, accedi o creane uno dalla pagina di OpenAI.

Creare un progetto e configurare la fatturazione

  • Accedi alla pagina di accesso di OpenAI.
  • Crea un nuovo progetto e assegnagli un nome esplicativo.
  • Vai su Impostazioni → Fatturazione e completa la configurazione della fatturazione.
  • Assicurati di disporre di credito sufficiente per l’utilizzo previsto.

Nota: Per garantire il corretto funzionamento è necessario disporre di un account OpenAI a pagamento; gli account di prova sono limitati e possono presentare problemi o errori imprevedibili. Gli account OpenAI con un pagamento minimo di 100€ vengono in genere promossi direttamente al Livello 3.

Configurare l’accesso ai modelli e i limiti

  • Vai su Progetto → Limiti.
  • Imposta un budget per controllare la tua spesa.
  • In Consenti o blocca modelli, lascia l’elenco vuoto per consentire l’uso di tutti i modelli.
  • In Limiti di frequenza, aumenta i limiti per i modelli sopra indicati secondo necessità (le installazioni di grandi dimensioni potrebbero richiedere limiti più elevati per evitare comportamenti imprevedibili).

Nota sui limiti di frequenza: La possibilità di aumentare i limiti dipende dal tuo livello di utilizzo dell’API OpenAI e dalla cronologia del tuo account.

Creare una nuova chiave API

  • Vai su Dashboard → Chiavi API.
  • Clicca su Crea una nuova chiave segreta.
  • Inserisci un nome descrittivo e imposta i permessi su Tutti.
  • Copia la chiave e conservala in modo sicuro.

Configurare OpenAI in 3CX

Nella Admin console 3CX, vai su Admin > Integrazioni > IA. Clicca su API in tempo reale e seleziona OpenAI dal menu a tendina Fornitore IA.

  • Configura le seguenti impostazioni:
  • Chiave API: Incolla la chiave API creata nella dashboard di OpenAI.
  • Modello IA in tempo reale: Seleziona il modello OpenAI in tempo reale consigliato dalla tua versione di 3CX.
  • Modello di testo IA: Seleziona il modello di testo OpenAI consigliato dalla tua versione di 3CX.
  • Inserisci:
  • Nome azienda
  • Descrizione azienda; questa informazione viene utilizzata dagli agenti AI per comprendere il contesto della tua organizzazione.
  • Clicca su Salva.

Configurazione degli agenti IA e delle basi di conoscenza

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

Note tecniche

  • Codec audio: PCMU
  • Se il proprio account OpenAI limita l’accesso ai modelli, autorizzare gpt-realtime-whisper e i modelli selezionati per Realtime e Testo nelle impostazioni dell’API Realtime.
  • Assicurarsi che il 3CX Firewall Checker superi il controllo con esito positivo.
  • Consentire il traffico in uscita su:
  • TCP 443 – utilizzato per la segnalazione e la configurazione della sessione dell’API Realtime di OpenAI.
  • UDP 3478 – utilizzato per la connessione multimediale WebRTC.
  • 3CX stabilisce la connessione OpenAI Realtime in tre fasi:

Modelli IA

OpenAI aggiorna regolarmente i modelli e potrebbe rendere obsolete le versioni precedenti. 3CX aggiorna i modelli consigliati man mano che cambiano le versioni supportate. Assicurati che il progetto OpenAI possa accedere ai modelli richiesti dalla versione di 3CX installata.

Per saperne di più

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