Configurazione di OpenAI per gli agenti IA 3CX

Introduzione

Questa guida spiega come integrare OpenAI con gli agenti AI 3CX per abilitare scenari intelligenti di receptionist e gestione delle chiamate basati sull'intelligenza artificiale.

Questa funzione richiede una licenza 3CX IA.

Passo 1: Configurazione di un account OpenAI

Se non disponi già di un account OpenAI, dovrai crearne uno, configurare la fatturazione e generare una chiave API.

Crea un progetto e configura la fatturazione

1. Accedi alla pagina di login di OpenAI.
2. Crea un nuovo progetto e assegnargli un nome descrittivo.
3. Vai su “Impostazioni → Fatturazione” e completa la configurazione della fatturazione.
4. Assicurati di avere credito sufficiente per l'utilizzo previsto.

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

Configura l'accesso al modello e i limiti

1. Vai su “Progetto → Limiti”.
2. Imposta un budget per controllare la tua spesa.
3. In Consenti o blocca modelli abilita:

1. Gpt-5 mini
2. Gpt-5 nano
3. gpt-5
4. Gpt-4o (compatibile legacy)
5. Gpt-4o-mini (compatibile legacy)
6. gpt-realtime
7. gpt-realtime-mini

4. In Limiti di velocità, aumenta i limiti per i modelli sopra indicati secondo necessità (installazioni più grandi potrebbero richiedere limiti più elevati per evitare comportamenti imprevedibili).

Nota sui limiti di velocità: La possibilità di aumentare i limiti dipende dal livello di utilizzo dell'API OpenAI e dalla cronologia dell'account.

Creare una nuova chiave API

1. Andare su “Dashboard → Chiavi API”.
2. Cliccare su Crea una nuova chiave segreta.
3. Inserire un nome descrittivo e impostare le autorizzazioni su Tutti.
4. Copiare la chiave e conservarla in modo sicuro.

Passo 2: Configurazione di OpenAI in 3CX

1. Nella Console di amministrazione, vai su “Amministrazione → Integrazioni → IA” e clicca sul pulsante API OpenAI.

2. Incolla la tua chiave segreta OpenAI.
3. Seleziona i modelli:

• Modello OpenAI per chiamate in tempo reale: gpt-realtime (consigliato)
• Modello OpenAI per testo: gpt-5o mini (consigliato)

4. Compila:

• Nome dell'azienda
• Descrizione dell'azienda; questa viene utilizzata dagli agenti AI per comprendere il contesto della tua organizzazione.

5. Clicca sul pulsante Salva.

Passo 3: Aggiungi Basi di conoscenza / RAG (porta i tuoi contenuti)

Le basi di conoscenza consentono agli agenti di recuperare contenuti specifici dell'azienda durante le chiamate/chat (politiche, domande frequenti, regole di instradamento, documentazione sui prodotti). Nell'ecosistema OpenAI questo viene comunemente implementato tramite l'acquisizione di file e la ricerca di incorporamento/vettoriale per il recupero.

• Nella Console di amministrazione, vai su “Amministrazione → Integrazioni → IA”
• Cliccare sul pulsante Basi di conoscenza, quindi sul pulsante Aggiungi

• Imposta un nome e una descrizione per la tua base di conoscenza
• Carica i file (PDF/documenti/testo) contenenti qualsiasi informazione relativa alla tua attività, ad esempio:

• Orari di apertura e regole relative alle festività
• Istruzioni di routing dei reparti
• Domande frequenti su prodotti/prezzi
• Formulazione “Cosa facciamo/come parlare di noi”

• SUGGERIMENTI:

• Assicurati che la descrizione riporti accuratamente i contenuti della base di conoscenza per migliorare il recupero delle informazioni.
• Se disponi di documenti che trattano contesti diversi e non correlati (ad esempio documenti medici e documenti interni sulla politica di viaggio), non inserirli nello stesso archivio; crea archivi di conoscenza separati per ogni contesto.
• L'API OpenAI non aggiorna 3CX ad ogni modifica della base di conoscenza; ad ogni modifica apportata, premi il pulsante Aggiorna e attendi il completamento del processo.

Nota: Le basi di conoscenza vengono create e fatturate nell'ambito del progetto/chiave OpenAI che hai configurato.

Passo 4: Creazione e configurazione degli agenti IA

1. Clicca sul pulsante Admin→Integrazioni→IA→ Aggiungi agente:

• Scegli il tipo di agente:

1. Receptionist: Agente IA orientato all'azienda per la gestione e l'instradamento delle chiamate di base
2. Assistente personale: Ottimizzato per la gestione delle chiamate di un utente specifico (ad esempio, il capo)

2. Nella scheda Informazioni agente:

• Definisci le impostazioni generali per il tuo agente AI:

1. Estensione: Numero di estensione univoco per l'agente AI.
2. Assistente per (solo PA): Utente rappresentato dal PA.
3. Appartenenza al reparto: Reparti di appartenenza dell'agente AI.
4. Nome e cognome: Identità vocale/visibile dell'agente AI.
5. Numeri DID assegnati: Numeri diretti in entrata che raggiungono l'agente AI.

• Configura le impostazioni vocali e di chiamata per il tuo agente AI:

1. Stile vocale: Seleziona l'opzione vocale preferita.
2. Registrazione delle chiamate: Disattivata, tutte le chiamate o solo chiamate esterne
3. Durata massima della chiamata
4. Agent Talk Link: Abilita la funzione clicca per parlare o chat da un sito web;  lasciare il campo vuoto, automaticamente disattiva il link per questo agente.

3. Nella scheda Tipo di agente:

• Imposta le basi di conoscenza: Scegli a quali fonti di conoscenza l'agente può accedere
• Imposta la lingua di presentazione: Lingua di saluto predefinita

1. Puoi anche consentire il cambio di lingua

• Imposta il messaggio di benvenuto: Il primo messaggio pronunciato al chiamante

4. Nella scheda Istruzioni agente, le istruzioni sul comportamento dell'IA sono state preconfigurate; se necessario, tuttavia, il pulsante Personalizza prompt consente di regolare il tono, i limiti delle politiche e le regole “fare/non fare”.
5. Nella scheda Blocca chiamate spam:

• La protezione antispam è abilitata per impostazione predefinita.
• È possibile personalizzare Cosa conta come spam per definire cosa si intende per spam o frode e quali azioni intraprendere:

1. Termina chiamata
2. Trasferisci a (un manager/revisore)
3. Invia

6. Nella scheda Routing chiamate (solo Receptionist):

• Aggiungi regole di comportamento di routing in modo che il tuo agente IA possa instradare in modo intelligente le chiamate e le chat verso destinazioni diverse in base alla tua descrizione:

1. Ad esempio, se il chiamante dice “Ricevo l'errore 404”, l'agente IA può classificare questa chiamata come una richiesta di assistenza e trasferirla a una destinazione con una descrizione del tipo “In caso di errori HTTP, trasferire qui”.
2. È possibile creare più voci di instradamento, ma evitare sovrapposizioni eccessive per garantire un routing accurato.

• Se si consente il routing dell'estensione in base al nome, l'agente AI consente ai chiamanti di richiedere trasferimenti in base al nome; ad esempio “Mi trasferisca a Paolo”.
• Con la modalità riservatezza abilitata:

1. Questo impedisce all'IA di rivelare informazioni riservate come cognomi e informazioni sui dipendenti.
2. Tieni presente che se combini questa opzione con Consenti il routing interno per nome, l'agente IA non sarà in grado, ad esempio, di chiedere “Abbiamo due Paolo, Paolo Paoletti e Paolo Birri, con quale desideri essere messo in contatto?”, ma chiederà al chiamante il nome completo della destinazione desiderata.

7. Nella scheda Screening delle chiamate:

• È possibile disattivare lo screening delle chiamate per i contatti conosciuti, in modo da rendere meno rigoroso il processo di screening per i contatti conosciuti e affidabili memorizzati nella rubrica.
• È possibile selezionare la casella di controllo Verifica occupato prima del trasferimento della chiamata per assicurarsi che l'interno di destinazione sia disponibile prima di trasferire la chiamata.

8. Nella scheda Opzioni:

• Le azioni di risposta al chiamante si rivolgono a due tipi specifici di chiamanti problematici:

1. Le azioni di risposta al chiamante sono rivolte a due tipi specifici di chiamanti problematici:
2. Chiamanti ostili o offensivi.

• È possibile configurare azioni appropriate per gestire automaticamente queste situazioni.

Note tecniche

• Codec audio: è supportato solo PCMU.
• Configurazione di rete/firewall:

• Assicurati che il Firewall Checker ti dia un certificato di buona salute.
• Dovrai anche consentire il traffico in uscita verso:

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

• Nota sui modelli IA:

• OpenAI aggiorna costantemente i propri modelli e, man mano che vengono rese disponibili versioni nuove e migliorate, quelle precedenti diventano obsolete. Le informazioni contenute in questo documento saranno aggiornate di volta in volta per rimanere al passo con le opzioni attualmente consigliate. È necessario assicurarsi che il proprio account OpenAI sia configurato in modo da consentire l'utilizzo dei modelli più recenti da parte di 3CX.
• Le nuove versioni di 3CX aggiorneranno automaticamente i modelli configurati con quelli equivalenti più moderni.

Ultimo aggiornamento

Questo documento è stato aggiornato il 4 giugno 2026

https://www.3cx.it/doc/configurazione-agenti-ai/