Yealink e Snom: rubrica LDAP da Active Directory, SQL e CRM
I telefoni da tavolo mostrano un nome per una chiamata quando trovano il numero in una rubrica: in locale, in una rubrica XML o tramite una ricerca LDAP. Questa pagina spiega entrambe le vie per le rubriche di rete.
Cosa serve al telefono
- Rubrica LDAP: per una chiamata il telefono cerca il numero in una directory LDAP. Inserite server e porta, DN di base, utente e password (o accesso anonimo), un filtro per nome e uno per numero, l’attributo di visualizzazione e la ricerca per le chiamate in arrivo. Su Yealink le impostazioni sono in Directory → LDAP (documentazione Yealink), su Snom nella directory LDAP del telefono (documentazione Snom).
- Rubrica XML (rubrica remota): il telefono richiama un indirizzo e riceve un elenco nel formato del produttore. Per mostrare i nomi durante le chiamate, la ricerca nella rubrica remota per le chiamate in arrivo deve essere attivata.
Se il telefono interroga direttamente Active Directory, cerca con il numero così come arriva, ad es. 03023125017. Se la directory contiene «+49 30 23125017» e non normalizza le notazioni, un filtro semplice non trova nulla. Inoltre i clienti del CRM di solito non sono comunque in AD.
Con CallerHub: una rubrica LDAP per tutte le fonti
Il modulo Rubrica telefonica fornisce una directory LDAPv3 di sola lettura (porta 389, con LDAPS 636). Quando il telefono cerca un numero, CallerHub interroga tutte le fonti dati attive – CRM, SQL, Active Directory, CSV – comprese le regole, l’elenco di blocco e l’elenco VIP. Il numero può essere nazionale, con +49 o 0049.
- Configurazione: attivate il modulo Rubrica telefonica in Amministrazione → Moduli, poi create l’interfaccia Rubrica telefonica in Interfacce → Aggiungi interfaccia.
- Valori per dispositivo: la scheda mostra cosa inserire per ogni dispositivo.
- Ricerca per nome sul telefono: usa gli elenchi dei numeri in memoria.

Server: nome o indirizzo IP del computer CallerHub, porta 389 (636 con LDAPS)
Base DN: ou=callerhub
Name filter: (|(cn=%)(sn=%))
Number filter: (|(telephoneNumber=%)(mobile=%))
Display attribute: cn Number attribute: telephoneNumber
Lookup for incoming calls: attivo
Nomi dei campi e segnaposto (%, %s o *) variano a seconda del produttore e del firmware. In Indirizzi IP consentiti inserite la rete dei telefoni, ad es. 192.168.20.0/24. Utente e password sono facoltativi; senza, l’accesso è anonimo. LDAPS richiede un certificato con chiave privata; StartTLS non è supportato.
Alternativa: rubrica XML a ogni chiamata
Invece di LDAP, i telefoni Yealink, Fanvil e Snom possono interrogare CallerHub anche come rubrica XML. Create un’interfaccia «Rubrica XML (formato Yealink)» o «(formato Snom)» in Interfacce; «Copia istruzioni» fornisce l’indirizzo con la vera chiave API.
- Yealink / Fanvil: interfaccia web del telefono, Directory → Remote phone book, indirizzo
http://192.168.10.5:8080/lookup?format=yealink&apikey=API-KEY&number=#SEARCH, nome CallerHub; poi attivate nella rubrica remota la ricerca del nome per le chiamate in arrivo (la denominazione dipende dal firmware). - Snom: indirizzo della rubrica XML
http://192.168.10.5:8080/lookup?format=snom&apikey=API-KEY&number=#SEARCH, poi attivate la ricerca per le chiamate in arrivo.
Molti telefoni Yealink si possono configurare tramite provisioning:
remote_phonebook.data.1.url = http://192.168.10.5:8080/lookup?format=yealink&apikey=API-KEY&number=#SEARCH
remote_phonebook.data.1.name = CallerHub
features.remote_phonebook.enable = 1
Le guide per Yealink, Fanvil e Snom si basano su interfacce pubblicate e non sono ancora state verificate con questi telefoni. Verificate nomi delle impostazioni e segnaposto nella documentazione del vostro firmware.
Domande frequenti
Rubrica LDAP o XML: quale è meglio?
Entrambe forniscono il nome per le chiamate in arrivo. La rubrica LDAP è un’unica interfaccia per tutti i dispositivi che supportano LDAP, compresi i centralini che integrano una directory esterna. La rubrica XML è un’interfaccia separata per ogni modello di telefono e non richiede alcun modulo aggiuntivo.
Quale edizione mi serve?
Il modulo Rubrica telefonica (LDAP ed export) fa parte dell’edizione completa; il periodo di prova di 30 giorni (da richiedere nell’app) lo include. Una rubrica XML è una normale interfaccia; l’edizione base consente un’interfaccia.
CallerHub ha bisogno dell’accesso in scrittura ad Active Directory?
No. CallerHub legge Active Directory solo come fonte dati, e la sua rubrica LDAP rifiuta i tentativi di scrittura dei telefoni.
I telefoni possono cercare anche per nome?
Sì. La ricerca per nome nella rubrica del telefono usa gli elenchi dei numeri in memoria. Le fonti in modalità query diretta non si possono cercare per nome.
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.