Fonti dati
CallerHub legge i nomi dai sistemi in cui i vostri contatti sono già gestiti. Legge soltanto e non crea alcun database proprio.
Guide passo passo: Esportazione DATEV · Microsoft 365 ed Exchange · Database SQL · Active Directory · Formato E.164 · tutte le soluzioni
Tipi di fonti dati
| Fonte | Accesso | Porta (esempio) | Note |
|---|---|---|---|
| Microsoft SQL Server | Autenticazione SQL o Windows, SELECT | 1433 | istanze denominate con \; utente di sola lettura ad es. con db_datareader o diritti su una vista |
| Oracle | Nome del servizio, SELECT | 1521 | il driver Oracle.ManagedDataAccess.dll è nella cartella Drivers; nessun client Oracle necessario |
| MySQL / MariaDB | ODBC | 3306 | MariaDB ODBC 3.1 o MySQL ODBC 8.0 Unicode Driver (64 bit) |
| PostgreSQL | ODBC | 5432 | PostgreSQL Unicode (x64) |
| Altri database ODBC | ODBC, facoltativamente una stringa di connessione propria | secondo il database | ad es. Firebird, SAP SQL Anywhere, SAP HANA (HDBODBC) |
| File CSV | file locale o su una condivisione | SMB 445 | riletto a ogni modifica; export DATEV, Excel e CRM con «Assegna colonne» |
| REST API | GET/POST con none, basic, bearer, OAuth2 o NTLM | 443 | modelli per HubSpot, Salesforce, Zoho, Odoo, SAP S/4HANA, Dynamics 365 e altri |
| LDAP / Active Directory | Ricerca LDAP | 389 / 636 (LDAPS) | anche OpenLDAP (bind=simple); consigliato LDAPS |
| Microsoft 365 (Graph) | Registrazione app in Entra ID | 443 | what=contacts (contatti della casella, Contacts.Read) o what=users (User.Read.All) |
| Exchange (EWS) | Exchange Server on-premise | 443 | Per Exchange Online usate invece Microsoft 365 (Graph); Microsoft ha annunciato la dismissione di EWS in Exchange Online. |


Esempio di lista numeri (SQL Server)
-- I nomi di colonna nummer, anzeigename, rang, land e id sono fissi.
SELECT c.phone AS nummer, c.company + ' - ' + c.name AS anzeigename,
0 AS rang, c.country AS land, c.id AS id
FROM dbo.contacts c WHERE c.phone IS NOT NULL
Per Oracle e SQL Server la guida descrive come creare un utente di sola lettura CALLERHUB e trovare la query giusta in un database sconosciuto. Un assistente SQL e la funzione «Bozza con IA» aiutano.
Modelli per CRM ed ERP
«Modello» inserisce una query o definizione pronta per il sistema scelto. A parte Infor COM, nessun modello è stato testato su un’installazione reale; nomi di tabelle e campi si basano su modelli di dati pubblicati.
| Sistema | Fonte | Stato |
|---|---|---|
| Infor COM | Oracle | testato con R7.9 |
| Infor CRM (Saleslogix) | SQL Server | Cercasi tester |
| Infor CloudSuite Industrial / SyteLine | SQL Server | Cercasi tester |
| Infor VISUAL | SQL Server, Oracle | Cercasi tester |
| Infor M3 | SQL Server | Cercasi tester |
| Infor LN / Baan | SQL Server, Oracle | Cercasi tester |
| Microsoft Dynamics CRM / 365 CE (on-premise) | SQL Server | esempio |
| Microsoft Dynamics 365 Business Central / NAV (on-premise) | SQL Server | esempio |
| SAP Business One | SQL Server | esempio |
| SAP Business One su SAP HANA | ODBC | Cercasi tester |
| Sage CRM | SQL Server | Cercasi tester |
| Oracle E-Business Suite | Oracle | Cercasi tester |
| Oracle JD Edwards EnterpriseOne | Oracle, SQL Server | Cercasi tester |
| SuiteCRM / SugarCRM CE | MySQL/MariaDB | sintassi testata con tabelle di test |
| vtiger CRM | MySQL/MariaDB | sintassi testata con tabelle di test |
| Dolibarr ERP/CRM | MySQL/MariaDB | sintassi testata con tabelle di test |
| Open Dental | MySQL/MariaDB | sintassi testata con tabelle di test |
| Odoo | PostgreSQL | sintassi testata con tabelle di test |
| Firebird, SAP SQL Anywhere | ODBC | modello |
| HubSpot CRM | REST | Cercasi tester |
| Pipedrive | REST | Cercasi tester |
| Salesforce | REST | Cercasi tester |
| SuiteCRM 8 / 7.x (V8 API) | REST | Cercasi tester |
| SugarCRM (REST v11) | REST | Cercasi tester |
| Zoho CRM | REST | Cercasi tester |
| Odoo (JSON-RPC) | REST | Cercasi tester |
| SAP S/4HANA | REST (OData) | Cercasi tester |
| Microsoft Dynamics 365 / Dataverse (online) | REST | Cercasi tester |
| Microsoft Dynamics 365 Business Central (online) | REST, OAuth2 | Cercasi tester |
| Microsoft Dynamics 365 Finance & Supply Chain | REST, OAuth2 | Cercasi tester |
| Infor CloudSuite tramite API ION | REST, OAuth2 | Cercasi tester |
| bexio | REST | Cercasi tester |
| HERO (software per artigiani) | REST (GraphQL) | Cercasi tester |
| Clio (studi legali) | REST, OAuth2 | Cercasi tester |
| Jobber (assistenza sul campo) | REST (GraphQL), OAuth2 | Cercasi tester |
| DATEV (export clienti/fornitori) | File CSV | proposta dai nomi di colonna |
| Active Directory, OpenLDAP | LDAP | testato con OpenLDAP |
| Contatti o utenti Microsoft 365 | Graph | Cercasi tester |
| Contatti Exchange | EWS | Cercasi tester |
Open Dental tratta dati dei pazienti; sono dati sanitari ai sensi del GDPR. Non c’è un modello per ServiceTitan perché la sua interfaccia contatti non restituisce nomi.
File CSV ed export DATEV
Senza altre impostazioni CallerHub legge UTF-8 con punto e virgola, senza riga di intestazione, nell’ordine numero, nome visualizzato, paese e link. Le righe che iniziano con # vengono ignorate.
«Assegna colonne» legge qualsiasi struttura, come un export clienti/fornitori da DATEV, una lista Excel o un export CRM. CallerHub rileva da solo separatore, codifica (UTF-8 o ANSI) e la riga di intestazione DATEV. Sono possibili più colonne telefono e valori di riserva come {Company} || {First name} {Last name}.
CallerHub legge solo il file esportato e non accede a DATEV.

# Numero;Nome visualizzato;Paese (facoltativo);Link (facoltativo)
040 66969000;Testkunde GmbH - Frau Beispiel;DE;https://crm.example.com/kontakt/1001
+41 44 000 45 67;Seeland Immobilien AG;;
044 000 43 21;Alpenblick Treuhand AG;CH;
API REST
Una fonte REST si descrive riga per riga con chiave=valore. Così si possono collegare anche interfacce proprie.
Per i sistemi dell’elenco dei modelli, «Modello» inserisce una definizione pronta. I dettagli per collegare interfacce proprie sono disponibili su richiesta al supporto.
Lista numeri e query diretta
Lista numeri (consigliato): CallerHub carica tutti i numeri in memoria all’avvio e all’intervallo impostato (da 1 a 1440 minuti) e risponde a ogni chiamata da lì. Se un aggiornamento fallisce, la lista precedente resta attiva.
Query diretta: CallerHub interroga la fonte a ogni chiamata. Parametri come :num_e164, :num_national, :num_digits, :num_local e :num_country vengono adattati a ogni database. I risultati vanno in cache (al massimo 20.000).
I numeri vengono normalizzati: spazi, trattini, barre, parentesi e «(0)» vengono rimossi; + e 00 indicano numeri internazionali.
Più fonti dati
- Le fonti vengono interrogate nell’ordine mostrato; la prima con un risultato fornisce il nome.
- Per ogni centralino decidete voi quali fonti interroga.
- Se una fonte si guasta, le altre continuano a rispondere. Se nessuna fonte trova il numero e una è guasta, CallerHub risponde 503 così il guasto non finisce in cache come «sconosciuto».
- L’edizione base consente una fonte, quella completa fino a dieci (di più con licenza speciale).
Paesi e prefissi
I numeri nazionali richiedono un prefisso internazionale. Se la fonte fornisce una colonna land, vale per riga; altrimenti vale il prefisso impostato (ad es. 49). Sono riconosciuti codici ISO (CH, AT, DEU), sigle automobilistiche (D, A, FL), prefissi (41, +41, 0041) e nomi di paese comuni. Il prefisso di teleselezione è gestito per paese, ad es. nessuno in Italia e Spagna, 06 in Ungheria o 8 in Russia.