Guida all'installazione del motore di trascrizione 3CX
- Introduzione
- Informazioni sugli esempi in questo documento
- Requisiti dell'host della macchina
- Specifiche hardware
- Impostazioni BIOS
- Sistema operativo
- Configurazione firewall
- Configurare il sistema
- Eseguire il comando di installazione
- Procedura guidata di installazione della trascrizione
- Utilizzo di certificati SSL personalizzati
- Creazione di certificati con Certbot
- Rinnovo automatico del certificato
- Politica FQDN fornita da 3CX
- Verifica della connettività con il server di trascrizione
- Aggiornamenti del server di trascrizione
- Pianificati
- Su richiesta
- Configurazione della trascrizione
- Per i dipartimenti
- Per gli utenti
- Per la gestione delle chiamate
- Accesso ai rapporti di trascrizione
- Visualizzazione delle trascrizioni nelle app 3CX
- Per saperne di più
Introduzione
Questa guida spiega come installare e configurare il server 3CX Transcription Engine per l'uso in locale o su cloud.
Il 3CX Transcription Engine aggiunge la trascrizione basata sull'intelligenza artificiale, il rilevamento dei parlanti e l'analisi delle trascrizioni al tuo sistema telefonico 3CX. Può essere implementato on-premise o su cloud e si integra direttamente con la console di amministrazione.
Nota: Disponibile per l'edizione 3CX IA o superiore, con 16SC o superiore.
Informazioni sugli esempi in questo documento
Questo documento utilizza example.com come FQDN 3CX e wmr.3cx-example.com come FQDN della macchina di trascrizione; sarà necessario sostituirli con i propri FQDN.
Requisiti dell'host della macchina
Specifiche hardware
- GPU: minimo consigliato (veloce): GPU Nvidia 24 GB RTX
- CPU: minimo: 4 vCPU, consigliato: 6 vCPU
- RAM: minimo: 24 GB
- Archiviazione: minimo: 20 GB di spazio libero su disco
- On-premise o cloud
Impostazioni BIOS
- Avvio sicuro: disabilitato
- CSM: disabilitato
- Supporto ridimensionamento BAR: disabilitato (potrebbe richiedere un doppio riavvio)
- IOMMU: abilitato
Sistema operativo
- Sistema operativo: Debian 12 (completamente aggiornato)
Configurazione firewall
Aprire le seguenti porte TCP per il traffico in entrata verso la macchina:
- TCP 61443 – consentire solo dall'IP PBX
- TCP 80 – per la creazione/il rinnovo del certificato SSL Let's Encrypt; in genere non è necessario se si utilizzano certificati SSL personalizzati
Configurare il sistema
- Accedere alla macchina di trascrizione tramite SSH ed elevare i privilegi a root.
- Aggiornare il sistema:
apt-get update
apt-get upgrade
- Installare i prerequisiti richiesti:
apt -y install curl apt-transport-https gnupg gpg wget iptables-persistent build-essential dkms
- Per garantire che tutti gli aggiornamenti di sistema abbiano effetto (in particolare gli aggiornamenti dell'immagine del kernel), riavviare ora il sistema:
reboot
- Verifica se i driver NVIDIA sono già attivi e funzionanti:
nvidia-smi
- Se ottieni una risposta di comando non trovato, devi installare i driver NVIDIA:
apt -y install linux-headers-$(uname -r)
wget https://developer.download.nvidia.com/compute/cuda/repos/debian12/x86_64/cuda-keyring_1.1-1_all.deb
dpkg -i cuda-keyring_1.1-1_all.deb
apt update
apt -y install nvidia-open
apt -y install nvidia-driver-cuda nvidia-kernel-open-dkms
reboot
- Dopo il riavvio, verificare che tutto funzioni correttamente:
nvidia-smi
- …che mostrerà lo stato attuale della macchina:
user@wmr-3cx-example-com:~$ nvidia-smi
Mon Jan 26 09:04:40 2026
+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 590.48.01 Driver Version: 590.48.01 CUDA Version: 13.1 |
+-----------------------------------------+------------------------+----------------------+
| GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC |
| Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. |
| | | MIG M. |
|=========================================+========================+======================|
| 0 NVIDIA L4 On | 00000000:00:03.0 Off | 0 |
| N/A 40C P8 12W / 72W | 0MiB / 23034MiB | 0% Default |
| | | N/A |
+-----------------------------------------+------------------------+----------------------+
+-----------------------------------------------------------------------------------------+
| Processes: |
| GPU GI CI PID Type Process name GPU Memory |
| ID ID Usage |
|=========================================================================================|
| No running processes found |
+-----------------------------------------------------------------------------------------+
user@wmr-3cx-example-com:~$
Eseguire il comando di installazione
- Dalla console di amministrazione 3CX, accedere a “Amministrazione → Integrazioni → Trascrizione”.
- Impostare il provider di trascrizione su 3CX Transcription Engine (installato localmente).
- Cliccare sul pulsante Procedi.
- La pagina Trascrizione visualizzerà ora il comando di installazione da eseguire sul computer del trascrittore; clicca sul pulsante Copia per copiare il comando negli appunti.
- Accedere al computer di trascrizione tramite SSH ed elevare i privilegi a root.
- Eseguire il comando di installazione, simile al seguente esempio:
source <(curl -s https://example.com/webmeeting/onboardai/99887766-aabb-1122-ccdd-abcdef123456)
Procedura guidata di installazione della trascrizione
Ti verrà chiesto di scegliere se utilizzare certificati SSL personalizzati o certificati generati con Let's Encrypt.
Utilizzo di certificati SSL personalizzati
- Inserisci i tuoi file di certificato in formato PEM in /opt/3cxwm/cert:
- server.crt deve contenere la tua chiave pubblica (e possibilmente la tua catena di certificati)
- server.key deve contenere la tua chiave privata
- Assicurati che siano impostati i permessi corretti sui tuoi file di certificato:
sudo chown www-data:www-data /opt/3cxwm/cert/server.*
sudo chmod 600 /opt/3cxwm/cert/server.*
Creazione di certificati con Certbot
Per creare i propri certificati con Let's Encrypt Certbot:
- Accedere alla macchina di trascrizione tramite SSH ed elevare i privilegi a root.
- Eseguire i seguenti comandi:
sudo apt-get install certbot
sudo certbot certonly --standalone --preferred-challenges http -d wmr.3cx-example.com
cp /etc/letsencrypt/live/wmr.3cx-example.com/fullchain.pem /opt/3cxwm/cert/server.crt
cp /etc/letsencrypt/live/wmr.3cx-example.com/privkey.pem /opt/3cxwm/cert/server.key
Rinnovo automatico del certificato
Per automatizzare il rinnovo del certificato con Let's Encrypt Certbot:
- Accedere alla tua macchina di trascrizione tramite SSH ed elevati a root.
- Eseguire nano /root/certupdate.sh per creare lo script e imposta il contenuto come segue:
#!/bin/bash
cp /etc/letsencrypt/live/wmr.3cx-example.com/fullchain.pem /opt/3cxwm/cert/server.crt
cp /etc/letsencrypt/live/wmr.3cx-example.com/privkey.pem /opt/3cxwm/cert/server.key
chown www-data:www-data /opt/3cxwm/cert/server.*
chmod 600 /opt/3cxwm/cert/server.*
- Rendere lo script eseguibile:
chmod +x /root/certupdate.sh
- Modificare il crontab:
crontab -e
- Aggiungere quanto segue al crontab:
0 3 * * * /root/certupdate.sh
Politica FQDN fornita da 3CX
Se si utilizza un FQDN fornito da 3CX (ad esempio durante l'installazione tramite l'opzione 1), tenere presente che:
- L'FQDN verrà eliminato se il motore di trascrizione viene rimosso dall'interfaccia utente del centralino.
- Se il centralino non contatta wmr.3cx.net entro 30 giorni, l'FQDN verrà eliminato automaticamente.
Verifica della connettività con il server di trascrizione
Per verificare la connettività dal PBX al server di trascrizione, è possibile eseguire il seguente comando sul centralino:
[email protected]:~$ curl -w "\n" https://wmr.3cx-example.com:61443/webmeeting
OK
… che dovrebbe mostrare OK per una risposta positiva.
È anche possibile navigare su “Admin → Integrations → Transcription” nella console di amministrazione 3CX per controllare lo stato del motore di trascrizione.
Aggiornamenti del server di trascrizione
Pianificati
Il server di trascrizione verifica e si aggiorna automaticamente all'ultima versione. L'attività di aggiornamento automatico viene eseguita ogni domenica alle 1:00 (ora del server).
Su richiesta
Se si desidera eseguire l'aggiornamento all'ultima versione prima della finestra di aggiornamento pianificata:
- accedere alla macchina di trascrizione tramite SSH ed elevare a root
- eseguire i seguenti comandi:
sudo apt update
sudo apt -y upgrade
Configurazione della trascrizione
Per i dipartimenti
- Accedere alla Console di amministrazione > dipartimenti.
- Selezionare il dipartimento desiderato.
- Aprire il menu Opzioni.
- Nella sezione Opzioni di trascrizione, scegliere cosa trascrivere.
Per gli utenti
- Accedere alla Console di amministrazione > Utenti.
- Selezionare l'utente desiderato.
- Aprire il menu Opzioni.
- Nella sezione Opzioni di trascrizione, scegliere cosa trascrivere per questo utente.
Per la gestione delle chiamate
- Accedere alla Console di amministrazione > Gestione delle chiamate.
- Selezionare la Coda o il Gruppo di squillo pertinente.
- Aprire il menu Opzioni.
- In Opzioni di trascrizione, scegliere cosa trascrivere per questa Coda o questo Gruppo di squillo.
Accesso ai rapporti di trascrizione
Tutte le informazioni trascritte possono essere visualizzate dalla Console di amministrazione > Registrazioni o dalla Console di amministrazione > Rapporti. Se le notifiche via e-mail sono abilitate nelle impostazioni di un utente, l'utente riceverà anche una trascrizione via e-mail per ogni chiamata registrata.
Visualizzazione delle trascrizioni nelle app 3CX
Gli estratti di trascrizione per i messaggi vocali e le registrazioni sono disponibili anche direttamente all'interno delle app 3CX:
- Softphone Windows: I messaggi vocali e le registrazioni mostrano estratti di trascrizione nell'elenco delle chiamate. Cliccare sull'icona di trascrizione per visualizzare il testo completo.
- App iOS: Con la trascrizione abilitata, gli estratti per i messaggi vocali e le registrazioni appaiono direttamente nell'elenco delle chiamate. Toccare l'icona di trascrizione per visualizzare il testo completo.
- App Android: I messaggi vocali e le registrazioni includono brevi anteprime della trascrizione nell'elenco delle chiamate. Tocca l'icona della trascrizione per aprire la trascrizione completa.
Per saperne di più
- Configurazione di OpenAI / Whisper per la trascrizione
- Google Cloud Storage e API Speech V2 per la trascrizione di registrazioni/messaggi vocali
Ultimo aggiornamento
Questo documento è stato aggiornato il 30 aprile 2026.
Copyright © 2025