Asterisk, FreePBX, VitalPBX e Issabel: ricerca del caller ID via HTTP
Asterisk imposta il nome del chiamante nel dial plan. Decidete voi da dove arriva il nome: una ricerca HTTP a ogni chiamata che lo restituisce dal vostro CRM, database o directory.
Come Asterisk cerca un nome
- Asterisk direttamente: nel contesto in ingresso la funzione
CURL(modulofunc_curl) richiama un indirizzo; il risultato viene scritto inCALLERID(name)prima che il telefono squilli. - FreePBX e Issabel: il modulo CallerID Lookup Sources accetta una sorgente HTTP con host, porta, percorso e query. I dettagli sono nella documentazione Sangoma.
- VitalPBX: una sorgente di ricerca CID (HTTP/HTTPS) nella rotta in ingresso.
Tenete breve il timeout: se il servizio non risponde, la chiamata deve comunque squillare subito. Con HTTPS, Asterisk deve fidarsi del certificato del servizio (memorizzate il certificato radice sul server Asterisk).
Con CallerHub: l’indirizzo per il vostro centralino
In CallerHub create un’interfaccia per il vostro centralino in Interfacce → Aggiungi interfaccia, inserite l’indirizzo del server Asterisk in Indirizzi IP consentiti e scegliete Salva e applica. «Copia istruzioni» fornisce l’indirizzo completo con la vera chiave API. Gli esempi usano 192.168.10.5 come computer CallerHub e il segnaposto API-KEY.
| Centralino | Query da inserire |
|---|---|
| Asterisk / FreePBX (dial plan) | …/lookup?apikey=…&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})} |
| FreePBX / Issabel (CallerID Lookup Sources) | percorso /lookup, query format=text&apikey=…&number=[NUMBER] |
| VitalPBX (sorgente di ricerca CID) | …/lookup?apikey=…&number=[CIDNUM] |
Esempio di dial plan (FreePBX: extensions_custom.conf, contesto from-pstn-custom o simile)
exten => _X.,1,Set(CURLOPT(httptimeout)=2)
same => n,Set(CALLERID(name)=${CURL(http://192.168.10.5:8080/lookup?apikey=API-KEY&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})})})
same => n,Goto(from-pstn,${EXTEN},1)
Poi ricaricate il dial plan (dialplan reload). Se CallerHub non è raggiungibile, il nome resta vuoto dopo 2 secondi e la chiamata prosegue normalmente. called passa il numero chiamato per le statistiche.
Analisi delle chiamate via AMI o Master.csv
Per tasso di risposta e livello di servizio, l’elenco dei richiami e la vista live, CallerHub legge i dati delle chiamate:
- Live via AMI: CallerHub si collega alla porta 5038. Create un utente con
read = cdrinmanager.confe impostateenabled = yesincdr_manager.conf. - File:
Master.csvdal modulo CDR di Asterisk, anche per le chiamate passate.

Errori frequenti
| Osservazione | Causa e rimedio |
|---|---|
| Il nome resta vuoto, CallerHub non mostra alcuna richiesta | La richiesta non arriva a CallerHub: controllate indirizzo, porta, firewall di Windows e firewall tra le reti; provate dal server Asterisk con curl. func_curl è caricato? |
Log: status=401 o 403 | Chiave API errata, oppure l’indirizzo del server Asterisk non è tra gli indirizzi IP consentiti. Dietro NAT il mittente è diverso. |
| La richiesta arriva, ma senza nome | Numero sconosciuto (provate con «Verifica numero»), format errato, oppure il timeout è più breve del tempo di risposta. |
| Dieresi o accenti visualizzati male | Le risposte sono in UTF-8; controllate il set di caratteri del centralino. |
Le guide per Asterisk, FreePBX, VitalPBX e Issabel si basano su interfacce pubblicate e non sono ancora state verificate con questi sistemi. Verificate segnaposto, percorsi di menu e nomi delle impostazioni nella documentazione della vostra versione.
Domande frequenti
Quale formato di risposta si aspetta Asterisk?
Testo semplice: solo il nome, vuoto per i numeri sconosciuti. È l’impostazione predefinita di CallerHub per Asterisk, FreePBX, VitalPBX e Issabel; con format potete scegliere anche JSON o XML.
La ricerca rallenta la chiamata?
CallerHub risponde alle chiamate dall’elenco dei numeri in memoria, quindi un database lento non ritarda la risposta. Anche il timeout nel dial plan limita l’attesa, a 2 secondi nell’esempio.
Posso collegare più server Asterisk?
Sì. Ogni centralino ha una propria interfaccia con propria chiave API, propri indirizzi IP consentiti e una propria selezione di fonti dati. L’edizione base consente un’interfaccia, quella completa fino a dieci.
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.