3CX: ricerca contatti dal vostro database
3CX mostra i nomi dai propri contatti. Per i dati di un CRM, un ERP o un database offre un’integrazione CRM: un modello descrive quale indirizzo 3CX richiama con il numero di telefono e come legge la risposta.
Come 3CX interroga un CRM
Per una chiamata in arrivo 3CX richiama l’indirizzo memorizzato nel modello con il numero di telefono e acquisisce il nome e, se disponibile, il link al record. Caricate il modello nella console di gestione di 3CX in Integrazioni → CRM; il percorso di menu esatto dipende dalla versione. Struttura e segnaposto del modello sono descritti nella documentazione 3CX.
Perché funzioni, 3CX deve raggiungere il servizio interrogato tramite la rete. Se il vostro 3CX gira presso un provider di hosting o nel cloud, il servizio ha bisogno di un indirizzo raggiungibile da Internet; usate allora HTTPS e limitate i mittenti consentiti.
Con CallerHub: creare il modello, caricarlo, fatto
- In CallerHub scegliete 3CX in Interfacce → Aggiungi interfaccia, inserite un’etichetta, fate clic su Crea.
- Nella scheda Centrale telefonica scegliete «3CX (modello CRM)», inserite l’indirizzo del 3CX in Indirizzi IP consentiti e fate clic su Salva e applica.
- Salvate il Modello 3CX …. Il file contiene indirizzo e chiave API di questa interfaccia.
- In 3CX caricate il modello in Integrazioni → CRM e selezionate CallerHub come CRM.
- Attivate la ricerca per numero di telefono e fate una chiamata di prova. L’accesso compare in CallerHub in Richieste recenti.
3CX interroga con format=json e riceve il nome, il numero di telefono e – se configurato per la fonte dati – l’indirizzo del record nel CRM.

Da dove arrivano i nomi
3CX chiede solo a CallerHub; CallerHub interroga tutte le fonti dati selezionate per questa interfaccia nell’ordine da voi stabilito. La prima fonte con un risultato fornisce il nome. Una configurazione tipica è un CRM come database SQL o tramite API REST, più Active Directory per i colleghi o un export DATEV. Se una fonte non funziona, le altre continuano a rispondere.
Il numero di telefono può arrivare in qualsiasi notazione (nazionale, +49, 0049, con spazi); CallerHub lo normalizza prima della ricerca, vedi numeri di telefono in formato E.164.
Analisi delle chiamate con 3CX
Per tasso di risposta, livello di servizio e l’elenco dei richiami, CallerHub ha bisogno dei dati delle chiamate del 3CX. Arrivano dopo la chiamata:
- Output CDR (v18/v20): in 3CX in Admin → Settings → CDR; attivo (CallerHub è in ascolto su una porta, ad es. 5100) o passivo, oppure come export CSV.
- 3CX V20 tramite API (cloud o on-premise): CallerHub recupera i dati tramite XAPI; in 3CX create un client con accesso XAPI in Integrazioni → API.
La guida 3CX si basa su interfacce pubblicate e non è ancora stata verificata con un 3CX reale. Verificate percorsi di menu e nomi delle impostazioni nella documentazione della vostra versione.
Domande frequenti
Devo scrivere io il modello CRM per 3CX?
No. CallerHub salva il modello con il pulsante «Modello 3CX …»; indirizzo e chiave API dell’interfaccia sono già inclusi. Voi caricate il file in 3CX.
3CX mostra anche un link al cliente nel CRM?
Sì, se per la fonte dati è configurato un link al record (ad es. un indirizzo con un segnaposto per il numero cliente). CallerHub lo passa a 3CX nella risposta.
Funziona con l’edizione base gratuita?
Sì. L’edizione base consente un’interfaccia e una fonte dati; il 3CX può essere quell’unica interfaccia. L’edizione completa consente fino a dieci interfacce e dieci fonti dati e aggiunge l’analisi delle chiamate estesa.
Provatelo con i vostri dati.
Provate l’edizione completa per 30 giorni: richiedete il periodo di prova in CallerHub, la chiave di prova arriva via e-mail. La procedura guidata vi accompagna tra fonte dati, centralino e ricerca di prova. Poi CallerHub continua come edizione base gratuita, senza perdere impostazioni o dati.