Installazione di NethVoice
NethVoice è un'applicazione VoIP che richiede un'installazione specifica su NethServer. Questa guida ti accompagnerà nel processo di installazione.
Se desideri un'installazione di NethVoice pronta all'uso, prendi in considerazione:
- il nostro servizio NethVoice SaaS, che fornisce un'istanza NethVoice completamente gestita nel cloud
- un VoiceBox Appliance, l'appliance hardware con NethServer e NethVoice preinstallati
Installazione modulo
- Accedi al Software Center nel tuo sistema NethServer 8.
- Cerca "NethVoice" nella barra di ricerca del Software Center.
- Fai clic su "Installa" accanto a NethVoice.
- Attendi il completamento dell'installazione (potrebbe richiedere alcuni minuti).
Per i limiti dell'applicazione Nethvoice fare riferimento a Limiti di scalabilità NethVoice.
Procedura guidata di configurazione iniziale
Apri l'applicazione NethVoice dalla pagina Applicazioni oppure dal Menu Applicazioni (icona a 9 punti in alto a destra, oppure premi Ctrl + Shift + A) in NethServer 8. Apparirà una procedura guidata di configurazione iniziale che ti guiderà attraverso:
- Configurazione di un provider di account per NethVoice
- Installazione e configurazione del NethVoice Proxy
- Configurazione dell'applicazione NethVoice
Provider di account
Il primo passaggio della procedura guidata ti aiuta a configurare il dominio utenti utilizzato da NethVoice.
I domini utenti memorizzano utenti e gruppi in un database LDAP. NethVoice richiede un dominio utenti per gestire interni, utenti e autenticazione.
NethServer 8 supporta due tipi di provider di account LDAP:
| Provider | Tipo | Ideale per | Funzionalità |
|---|---|---|---|
| OpenLDAP (RFC2307) | Interno | Client Unix/Linux, configurazione semplice | Leggero, configurazione semplice, distribuzioni di piccole dimensioni, istanze multiple per nodo |
| Active Directory (Samba) | Interno | Client Windows, condivisione file SMB | Controller di dominio, compatibilità Windows, maggiore complessità, una sola istanza per nodo |
| LDAP Esterno | Esterno | Infrastruttura LDAP esistente | Connessione a server esistenti (Active Directory, OpenLDAP, ecc.) |
NethVoice richiede almeno un dominio utenti configurato. Scegli OpenLDAP (RFC2307) per distribuzioni più semplici o Active Directory se hai bisogno di supporto per client Windows.
Configurazione rapida: OpenLDAP (Consigliato per NethVoice)
La procedura guidata consente di installare facilmente un provider di account OpenLDAP. Per configurarlo, devi:
- Inserire il nome del dominio (es.
nethvoice.local) - questo è un nome logico, non correlato al DNS - Impostare nome utente e password dell'amministratore di OpenLDAP
Per scenari avanzati (LDAP esterno, Active Directory, configurazione DNS, politiche di password, gestione utenti), consulta la documentazione ufficiale sui domini utenti di NethServer 8.
Argomenti chiave nella documentazione ufficiale:
- Configurazione di Active Directory: Configurazione completa del controller di dominio
- Connessione LDAP esterno: Collegamento a server LDAP esistenti
- Politiche di password: Età, complessità e scadenza delle password
- Portale di gestione utenti: Modifica autonoma delle password da parte degli utenti
- Repliche del provider LDAP: Tolleranza ai guasti e ridondanza
- Impostazioni di binding LDAP: Collegamento di applicazioni esterne a un server LDAP locale
NethVoice Proxy
Il passaggio successivo della procedura guidata iniziale installa e configura il NethVoice Proxy.
Il NethVoice Proxy è un componente che deve essere installato e configurato prima di configurare le istanze applicative di NethVoice. Anche con una sola installazione di NethVoice, il proxy è essenziale per una corretta gestione del traffico di rete.
Il proxy gestisce tutto l'accesso esterno a Internet e il routing del traffico SIP/RTP. È necessario per:
- Accesso esterno da Internet
- Delegazione del traffico verso più installazioni NethVoice sullo stesso nodo
- Gestione delle connessioni SIP e RTP per tutte le istanze di NethVoice
- Terminazione SSL/TLS per il traffico VoIP esposto a Internet
Il NethVoice Proxy è un'applicazione standard di NethServer 8: le sue impostazioni possono essere riviste e modificate accedendo dalla pagina Applicazioni oppure dal Menu Applicazioni (icona a 9 punti in alto a destra, oppure premi Ctrl + Shift + A).
Prerequisiti
Prima di configurare il NethVoice Proxy:
- Record DNS creati: Crea un record DNS A/AAAA per il dominio del proxy (es.
proxy.nethserver.org) che punti al tuo indirizzo IP pubblico - Indirizzo IP pubblico: Identifica l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet
- Interfaccia di rete: Identifica quale interfaccia di rete gestirà il traffico VoIP
La procedura guidata rileva automaticamente se esiste già un proxy sul nodo di installazione di NethVoice e propone di installarlo se necessario. Successivamente, per configurare il NethVoice Proxy:
- Configura il dominio del Proxy: questo è il FQDN pubblico dove il proxy sarà raggiungibile.
Non inserire il FQDN di NethServer ma utilizza uno dedicato, comeproxy.nethserver.org.
Questo nome sarà utilizzato dai client esterni per raggiungere i tuoi servizi VoIP, ma non sarà utilizzato direttamente dagli utenti finali. - Abilita la richiesta del certificato Let's Encrypt se necessario: verrà richiesto un certificato Let's Encrypt per il dominio del proxy.
- Imposta l'interfaccia di rete che gestirà il traffico VoIP
- Configura l'indirizzo IP pubblico se diverso dall'IP dell'interfaccia
Interfaccia di rete e provenienza dei client
NethVoice gestisce il traffico SIP e RTP su una sola interfaccia di rete del nodo NethServer 8: quella selezionata nella configurazione del NethVoice Proxy. Non è supportata la ricezione del traffico VoIP su più interfacce contemporaneamente.
Una sola interfaccia non significa una sola rete di provenienza. I client possono raggiungere NethVoice da reti e indirizzi IP diversi, purché il loro traffico arrivi all'interfaccia selezionata:
- rete locale direttamente collegata all'interfaccia;
- altre subnet locali (VLAN, sedi collegate in VPN), instradate verso l'interfaccia dal router o firewall;
- reti remote e Internet (App mobile, NethLink, sedi remote), tramite port-forwarding o NAT 1:1 dell'IP pubblico.
In tutti i casi i client devono usare gli FQDN configurati (proxy, NethVoice, NethVoice CTI) e non gli indirizzi IP.
Quando il nodo si trova dietro NAT, il NethVoice Proxy usa automaticamente l'IP locale per i client della rete direttamente collegata all'interfaccia. Le altre subnet locali vanno dichiarate esplicitamente, come descritto in Reti locali aggiuntive. In alternativa, i client locali possono raggiungere l'IP pubblico tramite Hairpin NAT sul firewall.
Consulta la documentazione del NethVoice Proxy per maggiori informazioni.
Applicazione NethVoice
Per configurare NethVoice, è necessario disporre di due virtual host dedicati:
- Un Host base NethVoice per l'interfaccia di amministrazione di NethVoice, ad esempio
nethvoice.nethserver.org - Un Host base NethVoice CTI per l'applicazione web NethVoice CTI, ad esempio
cti.nethserver.org
Prima di procedere con la configurazione, assicurati di aver creato i corrispondenti record DNS per questi FQDN nel tuo server DNS.
Se prevedi di utilizzare un certificato Let's Encrypt come certificato predefinito, assicurati di avere i necessari record DNS pubblici.
Nell'ultimo passaggio della procedura guidata, ti verrà richiesto di fornire le seguenti informazioni:
- Host base NethVoice: Inserisci un FQDN valido per accedere alla pagina di amministrazione dell'applicazione; qui gestirai le impostazioni di NethVoice, ad esempio
nethvoice.nethserver.org. - Host base NethVoice CTI: Inserisci un FQDN valido per l'applicazione web NethVoice CTI, ad esempio
cti.nethserver.org. - Richiedi certificato Let's Encrypt: Se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'host base NethVoice che per l'Host base NethVoice CTI.
- Fuso orario: Seleziona il fuso orario appropriato per l'applicazione NethVoice; questo è importante per la registrazione accurata delle chiamate e la pianificazione.
- Password amministratore per accedere all'interfaccia utente: Imposta la password per la pagina di amministrazione di NethVoice.
Passaggi successivi
Al termine della procedura guidata di configurazione iniziale, NethVoice sarà accessibile sull'host base configurato, ad esempio:
https://nethvoice.nethserver.org
Per accedere all'interfaccia di amministrazione di NethVoice, utilizza le seguenti credenziali:
- Utente:
admin - Password: La password scelta nella procedura guidata di configurazione iniziale
Dopo aver completato la configurazione di NethVoice nell'interfaccia di amministrazione, gli utenti possono accedere al NethVoice CTI sull'host base configurato, ad esempio:
https://cti.nethserver.org
Configurazione del modulo
Le impostazioni del modulo NethVoice possono essere riviste e modificate accedendo al modulo NethVoice di NethServer 8. Per farlo:
- Accedi alla pagina di amministrazione del cluster NethServer.
- Apri l'applicazione NethVoice dalla pagina Applicazioni oppure dal Menu Applicazioni (icona a 9 punti in alto a destra, oppure premi Ctrl + Shift + A).
- Vai alla pagina di configurazione specifica che desideri modificare.
Nella pagina Impostazioni puoi rivedere e modificare la maggior parte dei parametri di configurazione:
- Host base NethVoice: virtual host per l'interfaccia di amministrazione di NethVoice.
- Host base NethVoice CTI: virtual host per l'applicazione web NethVoice CTI.
- Richiedi certificato Let's Encrypt: se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'Host base NethVoice che per l'Host base NethVoice CTI.
- Provider di account: dominio utenti utilizzato da NethVoice.
- Fuso orario: fuso orario per l'applicazione NethVoice, importante per la registrazione accurata delle chiamate e la pianificazione.
- Prefisso dei report: prefisso telefonico utilizzato nei report.
- Nuova password amministratore per NethVoice: definisci una nuova password per l'utente
admin.
Nella pagina Integrazioni puoi configurare i servizi speech-to-text e AI:
- API Key Deepgram: necessaria per abilitare la trascrizione delle chiamate e dei messaggi vocali.
- Trascrizione delle chiamate (Preview): abilita la trascrizione delle chiamate gestite da NethVoice. Gli utenti con il permesso di profilo richiesto possono aprire la trascrizione live durante una chiamata, e le chiamate completate supportate possono mostrare i dati di trascrizione post-chiamata nella Cronologia CTI. Questa funzionalità può consumare rapidamente crediti Deepgram sui sistemi con molte chiamate.
- Trascrizione dei messaggi vocali: converte l'audio dei messaggi vocali in testo con Deepgram e include la trascrizione nei messaggi vocali quando il flusso voicemail fornisce un allegato audio.
- API Key OpenAI: necessaria per abilitare i riassunti delle chiamate generati dall'AI. Quando una API Key OpenAI è configurata, gli utenti con il permesso di profilo richiesto possono consultare i riassunti generati dalla Cronologia CTI e configurare le notifiche di riassunto pronto.
- Riepilogo chiamata: abilita i riepiloghi generati dall'AI delle chiamate completate. Può essere attivato solo quando è configurata una OpenAI API Key e Trascrizione chiamata è abilitata, poiché i riepiloghi vengono generati dai dati di trascrizione post-chiamata.
I riassunti delle chiamate generati dall'AI usano i dati della trascrizione post-chiamata e richiedono sia una configurazione Deepgram funzionante che una API Key OpenAI configurata.
Nella sezione Chat della stessa pagina puoi abilitare la chat per gli utenti NethVoice:
- Abilita la chat: attiva la chat in NethVoice CTI, NethLink e nell'app mobile.
- Conserva messaggi e allegati della chat per (giorni): messaggi e allegati più vecchi vengono cancellati.
- Spazio allegati per utente (MB): se un utente lo supera, i suoi allegati più vecchi vengono cancellati.
- Dimensione massima di un allegato (MB): limite di dimensione di un singolo file.
Consulta Chat per tutti i dettagli, comprese le chat con persone esterne al centralino.
Con una API Key Deepgram configurata, è disponibile anche la sintesi vocale (text-to-speech) durante l'aggiunta di una registrazione per Annunci, IVR o Code di chiamata: inserisci il testo del messaggio, scegli lingua e voce, ascolta l'anteprima e salvala come registrazione di sistema.
Per informazioni utente su trascrizione live, trascrizione post-chiamata, riassunti, notifiche e integrazione con la Cronologia, consulta Trascrizione vocale e Riassunto chiamata nel Manuale Utente.
Nella pagina Rebranding puoi personalizzare l'interfaccia utente di NethVoice con l'identità del marchio della tua azienda. Per abilitare questa funzionalità, devi contattare il team commerciale di Nethesis e avere un abbonamento Enterprise attivo.
Il rebranding è organizzato in schede, una per ogni interfaccia:
- CTI: nome del brand, loghi, favicon e sfondo della pagina di login di NethVoice CTI.
- Admin: nome del brand, loghi, favicon e sfondo della pagina di login del wizard, più la sezione Interfaccia di amministrazione FreePBX, dove puoi impostare il logo in alto a sinistra e la favicon della GUI di amministrazione di FreePBX. Il nome del brand mostrato nell'interfaccia di amministrazione FreePBX segue il nome del brand del wizard.
- Report: nome del brand, logo e favicon della pagina di login di NethVoice Reports.
- NethLink: nome e URL dell'azienda mostrati nella finestra Informazioni del client desktop NethLink.
Tutte le immagini devono essere raggiungibili a un URL pubblico e il formato consigliato è SVG. I campi lasciati vuoti usano gli asset predefiniti. Il salvataggio applica in una sola volta le modifiche in sospeso di tutte le schede.
Nella pagina Hotel puoi configurare il modulo Hotel; è richiesto un abbonamento attivo per questa funzionalità.
- Stato: Attiva il modulo Hotel per gestire funzionalità telefoniche specifiche per hotel.
- Host server FIAS Hotel: Inserisci l'indirizzo IP o il nome host del server FIAS dell'hotel.
- Porta server FIAS Hotel: Specifica il numero di porta per la connessione al server FIAS dell'hotel.
Consulta la documentazione del modulo Hotel di NethVoice per maggiori dettagli.
Allarmi
NethVoice e NethVoice Proxy dispongono di allarmi integrati che segnalano quando qualcosa smette di funzionare: un servizio fermo, un trunk che non raggiunge il provider, un problema DNS o una chiave AI non più valida. I controlli vengono eseguiti ogni 5 minuti.
Gli allarmi sono disabilitati per impostazione predefinita. Per abilitarli:
- Apri l'applicazione NethVoice e vai alla pagina Impostazioni.
- Nella scheda Allarmi, attiva l'interruttore e fai clic su Salva.
- Ripeti gli stessi passaggi nella pagina Impostazioni dell'applicazione NethVoice Proxy.
Gli allarmi attivi sono visibili nella pagina Nodi dell'amministrazione del cluster e, se il cluster ha una sottoscrizione, su my.nethesis.it.
NethVoice genera questi allarmi:
| Allarme | Gravità | Quando scatta |
|---|---|---|
ServiceDown | critical | Un servizio di NethVoice (ad esempio Asterisk, MariaDB, NethVoice CTI o Janus) è fermo da 10 minuti, oppure è stato riavviato almeno 3 volte in 10 minuti. I servizi disabilitati e quelli mai avviati non vengono controllati. |
NethVoiceTrunkUnreachable | critical | Lo stesso allarme generato da NethVoice Proxy, per i trunk che non passano dal proxy. Di norma i trunk passano dal proxy, quindi questo allarme riguarda solo configurazioni personalizzate. Scatta quando uno di questi trunk resta in errore per 10 minuti: NethVoice non riesce a registrarsi presso il provider, il lato remoto che si registra su NethVoice non è registrato, oppure il provider di un trunk IP non risponde. |
NethVoiceTrunkNotMonitored | warning | Per 10 minuti, un trunk IP, o un trunk in cui il lato remoto si registra su NethVoice, ha un nome con uno spazio (o un altro carattere non ammesso in un indirizzo SIP) e nessun From User. Le chiamate funzionano, ma NethVoice non invia al trunk i controlli di keep-alive, quindi un guasto del provider passa inosservato. I trunk che si registrano presso il provider non sono interessati. |
NethVoiceDnsFailure | warning | Lo stesso problema DNS si presenta in 3 controlli consecutivi (15 minuti). Motivo not_resolved: il nome di NethVoice, di NethVoice CTI o del proxy non esiste sul server DNS del nodo. Motivo ip_mismatch: il nome del proxy non punta né all'indirizzo IPv4 pubblico né a quello privato del proxy, ad esempio dopo che il proxy è passato a un nuovo IP pubblico e nessuno ha aggiornato il record DNS. L'allarme mostra l'indirizzo restituito dal DNS e quelli attesi. Motivo no_answer: il server DNS del nodo non risponde entro 5 secondi. |
NethVoiceDnsSlow | warning | In 3 controlli consecutivi (15 minuti), il server DNS del nodo impiega più di 3 secondi a risolvere uno di questi nomi. Non viene mai generato insieme a NethVoiceDnsFailure per lo stesso nome. |
NethVoiceAIKeyInvalid | critical | Con la trascrizione abilitata, Deepgram o OpenAI rifiuta la chiave API da 10 minuti. |
NethVoiceAICreditExhausted | critical | Un provider AI ha rifiutato una richiesta perché l'account ha esaurito il credito. L'allarme si chiude dopo la successiva richiesta riuscita. |
NethVoice Proxy genera questi allarmi:
| Allarme | Gravità | Quando scatta |
|---|---|---|
ServiceDown | critical | Un servizio del proxy (Kamailio, rtpengine, PostgreSQL o Redis) è fermo da 10 minuti, oppure è stato riavviato almeno 3 volte in 10 minuti. |
NethVoiceTrunkUnreachable | critical | Per 10 minuti, su un trunk UDP che passa dal proxy, il provider rifiuta la registrazione, non risponde alla registrazione, oppure non risponde ai controlli di keep-alive di un trunk IP. I trunk su TCP o TLS non vengono ancora controllati. |
I controlli DNS usano il server DNS configurato sul nodo, non i server DNS pubblici: assicurati che risolva i nomi di NethVoice, NethVoice CTI e del proxy. Il nome del proxy può puntare all'indirizzo IP pubblico o a quello privato del proxy. Questo permette configurazioni split DNS, in cui gli utenti interni all'ufficio ottengono l'IP privato e quelli esterni l'IP pubblico. Se la risposta contiene più indirizzi, ne basta uno corrispondente. Vengono controllati solo gli indirizzi IPv4. Se NethVoice non riesce a determinare gli indirizzi del proxy, salta il controllo dell'IP senza alcun avviso.
L'allarme NethVoiceTrunkNotMonitored compare di solito sui trunk creati dalla pagina di FreePBX, migrati da NethServer 7 o importati, perché i trunk creati dal wizard di NethVoice hanno sempre un From User. Per risolvere, rinomina il trunk senza spazi nell'interfaccia di FreePBX (Connettività -> Trunk) e applica la configurazione. Poi aggiorna eventuali dialplan o trunk personalizzati che chiamano PJSIP/...@<vecchio nome>: da quel momento la cronologia chiamate e i report mostrano il trunk con il nuovo nome. Non compilare il campo From User per aggirare l'allarme, perché sostituisce l'ID chiamante nell'header From di tutte le chiamate in uscita. Il wizard di NethVoice mostra un avviso quando il nome di un nuovo trunk contiene uno spazio, ma NethVoice non rinomina mai un trunk da solo.