CallerHub
IT
Download

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 (modulo func_curl) richiama un indirizzo; il risultato viene scritto in CALLERID(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.

CentralinoQuery 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 = cdr in manager.conf e impostate enabled = yes in cdr_manager.conf.
  • File: Master.csv dal modulo CDR di Asterisk, anche per le chiamate passate.
Analisi delle chiamate
Analisi delle chiamate degli ultimi 30 giorni con valori su chiamate, tasso di risposta, livello di servizio, tasso di richiamata e richiamate aperte.

Errori frequenti

OsservazioneCausa e rimedio
Il nome resta vuoto, CallerHub non mostra alcuna richiestaLa 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 403Chiave API errata, oppure l’indirizzo del server Asterisk non è tra gli indirizzi IP consentiti. Dietro NAT il mittente è diverso.
La richiesta arriva, ma senza nomeNumero sconosciuto (provate con «Verifica numero»), format errato, oppure il timeout è più breve del tempo di risposta.
Dieresi o accenti visualizzati maleLe 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

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.