Create interni programmabili 3CX per connettere gli agenti IA alle chiamate live.
Gli interni programmabili 3CX consentono agli sviluppatori di creare agenti IA in grado di gestire le chiamate live attraverso il sistema telefonico 3CX.
Il repository GitHub 3CX Agentic Call Control fornisce esempi di codice pronti all’uso per connettere gli interni programmabili a OpenAI, xAI, Google Gemini e Alibaba Cloud Qwen. Ogni esempio collega il provider IA al controllo chiamate di 3CX, offrendo agli sviluppatori un punto di partenza per creare le proprie applicazioni vocali in tempo reale.
Scegliete il provider che meglio si adatta al vostro caso d’uso, configurate l’agente e testatelo direttamente tramite 3CX. Continuate a leggere per saperne di più.
Scegliere un provider IA per gli interni programmabili 3CX
Scegliete il servizio IA più adatto al compito senza dover ricostruire la gestione della chiamata lato 3CX. Ogni provider dispone di un proprio esempio pronto all’uso, in modo da poter iniziare con le API, i modelli, le voci e le impostazioni regionali corrette.
- OpenAI: Utilizza OpenAI Realtime per un punto di partenza familiare e facile da usare.
- xAI: Connettetevi al servizio vocale in tempo reale di xAI.
- Google Gemini: Sviluppa con il servizio in tempo reale Gemini di Google.
- Alibaba Cloud Qwen: Utilizza Qwen con endpoint regionali, inclusi quelli internazionali o di Pechino per installazioni nella Cina continentale.
Per la configurazione specifica del provider, consultate la guida Provider IA per gli Interni Programmabili 3CX. La guida copre la connessione 3CX, le impostazioni del provider e la configurazione della chiamata di prova.
Utilizzare più di un provider IA
Potete configurare qualsiasi numero di agenti da qualsiasi provider con impostazioni personalizzate.
In altre parole, potete avere diversi agenti di vendita da più provider: ad esempio uno in lingua inglese da Grok o OpenAI per i Paesi occidentali e uno in lingua cinese da Alibaba Qwen per servire nello specifico i chiamanti di lingua cinese.
Connettersi in modo sicuro a 3CX
Prima che l’agente possa gestire le chiamate, necessita di credenziali di accesso approvate sul centralino. Nel 3CX, queste prendono il nome di Service Principal. Questo fornisce all’agente un Client ID e una chiave API per il centralino.
Un amministratore decide quali interni l’agente può utilizzare. La chiave API del centralino connette l’agente a 3CX. La chiave API separata del provider lo connette a OpenAI, xAI, Gemini o Qwen.
All’avvio dell’esempio, il terminale confermerà se l’agente è connesso sia a 3CX che al provider IA selezionato. Dovrete verificare che venga visualizzato lo stato ‘ready’ prima di chiamare l’agente.
Personalizzare l’esperienza del chiamante
Ogni esempio include un profilo receptionist che definisce ciò che i chiamanti ascoltano. Modificate il nome dell’agente, il nome dell’azienda, il messaggio di benvenuto e la voce per adattarli alla tua attività.
Il profilo controlla anche il modo in cui l’agente parla e gestisce le chiamate. Ad esempio:
- Ruolo dell’agente: Impostate le istruzioni, la lingua e lo stile di risposta.
- Azioni di chiamata: Decidete se l’agente può trasferire le chiamate o terminarle.
- Strumenti del centralnio: Scegliete le informazioni del centralno che l’agente può utilizzare, come la ricerca in rubrica.
- Filtro chiamate: Abilitate il filtro e la verifica della disponibilità prima dei trasferimenti.
- Chiamanti difficili: Impostate regole per chiamate spam, ostili o non collaborative.
Create profili separati per team, tipi di chiamata o lingue differenti senza dover modificare la connessione a 3CX.
Testare gli Interni Programmabili 3CX con una chiamata reale
Una volta configurato l’interno programmabile, e dopo che il log di avvio conferma la corretta configurazione, avviate una chiamata verso il Client ID del tuo servizo principale dal Web Client 3CX. Il vostro interno programmabile risponderà secondo le istruzioni definite nel suo prompt.
Questo test verifica in modo efficace l’intero percorso: Chiamante > Centralino > Provider IA > Centralino > Chiamante.
Iniziate con l’esempio fornito, verificate il corretto svolgimento della conversazione con le impostazioni predefinite, quindi modificate una singola impostazione alla volta. In questo modo sarà più semplice confrontare provider, voci, impostazioni e profili mantenendo costante il lato 3CX del test.
Forum 3CX
Partecipate ai nostri forum dedicati ai Partner o ai Clienti. Seguiteci su X e LinkedIn per rimanere aggiornati sulle ultime novità e sui rilasci di funzionalità.



