Interfaccia e rete
Ciò che serve agli amministratori per la configurazione. Gli esempi usano 192.168.10.5 come server CallerHub, la porta 8080 e il segnaposto API-KEY.
URL di ricerca per il centralino
Il centralino richiama questo indirizzo a ogni chiamata e riceve il nome in risposta. Ogni interfaccia ha la propria chiave API; CallerHub risponde con le fonti dati di quell’interfaccia.
http://192.168.10.5:8080/lookup?apikey=API-KEY&number=040 66969000
→ Becker & Partner - Laura Becker (vuoto se sconosciuto)
L’indirizzo giusto per ogni sistema è nella pagina centralini; «Copia guida» in CallerHub lo fornisce con la chiave API reale. Invece del parametro apikey, la chiave può essere inviata anche nell’header X-Api-Key; così non compare nei log del proxy.
Codici di risposta
| Codice | Significato |
|---|---|
200 | Nome trovato (vuoto per un numero sconosciuto) |
401 | Chiave API o di accesso errata o mancante |
403 | Indirizzo IP non consentito per questa interfaccia |
404 | percorso sconosciuto o modulo disattivato |
405 | metodo HTTP errato |
429 | bloccato temporaneamente dopo troppe chiavi errate |
503 | nessuna fonte pronta o elenco numeri non ancora caricato |
Altro aiuto per la diagnosi: errori di connessione frequenti.
Connessioni di rete e porte
CallerHub stabilisce solo le connessioni che configurate. Non invia dati di chiamata né personali al fornitore; si collega a callerhub.de solo per la ricerca aggiornamenti e, con una propria chiave di licenza o una prova, per l’elenco delle licenze revocate e la verifica online della licenza.
| Connessione | Direzione | Porta (esempio) | Contenuto | Quando |
|---|---|---|---|---|
| Centralino → CallerHub | in entrata | 8080 HTTP / 8443 HTTPS | Numero, eventualmente numero chiamato e utente, chiave API → nome, eventualmente link | a ogni chiamata |
| CallerHub → database SQL | in uscita | 1433, 1521, 3306, 5432 | Accesso, SELECT | elenco a intervalli o a ogni chiamata |
| CallerHub → LDAP/AD | in uscita | 389 / 636 | Accesso, ricerca | a intervalli |
| CallerHub → Microsoft 365, EWS, REST | in uscita | 443 | Richiesta token, lettura contatti | a intervalli o a ogni chiamata |
| CallerHub → SMTP / webhook | in uscita | 587 / 465 / 25, 443 | Guasto e ripristino, report; senza numeri | in caso di guasto o da pianificazione |
| Browser / monitoraggio → CallerHub | in entrata | come l’interfaccia | Statistiche, analisi chiamate, monitoraggio con chiave di accesso | all’accesso |
| Telefoni → rubrica LDAP | in entrata | 389 / 636 | Ricerca per nome e inversa | a ogni ricerca |
| Ricezione live dei dati chiamate | in entrata o in uscita | 5100, 5101, 5038, 1080, 1012 o 443 | Dati per chiamata | continua o a intervalli |
| CallerHub → callerhub.de | in uscita | 443 | Richiesta dell’ultima versione, download del programma; con una propria chiave di licenza, l’elenco firmato delle licenze revocate | con «Cerca aggiornamenti» o aggiornamento; elenco delle revoche una volta al giorno |
| CallerHub → STARFACE (REST) | in uscita | 443 | Contatti nella propria rubrica STARFACE | di notte, dopo il ricaricamento, su richiesta |
| Telefoni Mitel → CallerHub | in entrata | HTTP, TFTP | File di configurazione, pagine del display | all’avvio del telefono, su richiesta |
| CallerHub → nuget.org | in uscita | 443 | Download del driver Oracle | solo se manca e confermate |
| Rilevamento di rete | in uscita | tra cui 1433, 1521, 3306, 5432, 389, 636, 5060, 1012; UDP 1434, 1900 | Tentativo di connessione senza accesso | solo dopo avvio esplicito |
Altre interfacce
- Accesso browser: statistiche e analisi chiamate nel browser, reindirizzamento alla scheda CRM per i pop-up CTI – con chiave di accesso propria.
- Monitoraggio: Nagios, Icinga, Checkmk, PRTG, Zabbix, Prometheus e Grafana – con chiave di monitoraggio propria.
- Dati ed eventi delle chiamate da centralini e script propri.
- Plugin: estensioni proprie eseguite a ogni chiamata.
I dettagli tecnici di queste interfacce (indirizzi e parametri, comandi console, interfaccia plugin ed eventi) sono disponibili su richiesta al supporto: info@callerhub.de.