Origens de dados
O CallerHub lê os nomes dos sistemas onde os seus contactos já são mantidos. Apenas lê e não cria uma base de dados própria.
Guias passo a passo: Exportação DATEV · Microsoft 365 e Exchange · Bases de dados SQL · Active Directory · Formato E.164 · todas as soluções
Tipos de origens de dados
| Origem | Acesso | Porta (exemplo) | Observações |
|---|---|---|---|
| Microsoft SQL Server | Autenticação SQL ou do Windows, SELECT | 1433 | instâncias nomeadas com \; utilizador só de leitura, p. ex. com db_datareader ou permissões numa vista |
| Oracle | Nome do serviço, SELECT | 1521 | o controlador Oracle.ManagedDataAccess.dll está na pasta Drivers; não é necessário cliente Oracle |
| MySQL / MariaDB | ODBC | 3306 | MariaDB ODBC 3.1 ou MySQL ODBC 8.0 Unicode Driver (64 bits) |
| PostgreSQL | ODBC | 5432 | PostgreSQL Unicode (x64) |
| Outras bases de dados ODBC | ODBC, opcionalmente uma cadeia de ligação própria | conforme a base de dados | p. ex. Firebird, SAP SQL Anywhere, SAP HANA (HDBODBC) |
| Ficheiro CSV | ficheiro local ou numa partilha | SMB 445 | relido a cada alteração; exportações do DATEV, Excel e CRM através de “Mapear colunas” |
| REST API | GET/POST com none, basic, bearer, OAuth2 ou NTLM | 443 | modelos para HubSpot, Salesforce, Zoho, Odoo, SAP S/4HANA, Dynamics 365 e outros |
| LDAP / Active Directory | Pesquisa LDAP | 389 / 636 (LDAPS) | também OpenLDAP (bind=simple); LDAPS recomendado |
| Microsoft 365 (Graph) | Registo de aplicação no Entra ID | 443 | what=contacts (contactos da caixa de correio, Contacts.Read) ou what=users (User.Read.All) |
| Exchange (EWS) | Exchange Server local | 443 | Para o Exchange Online, use o Microsoft 365 (Graph); a Microsoft anunciou o fim do EWS no Exchange Online. |


Exemplo de lista de números (SQL Server)
-- Os nomes de coluna nummer, anzeigename, rang, land e id são fixos.
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
Para Oracle e SQL Server, a ajuda descreve como criar um utilizador só de leitura CALLERHUB e encontrar a consulta certa numa base de dados desconhecida. Um assistente SQL e a função “Rascunho com IA” ajudam nisso.
Modelos para CRM e ERP
“Modelo” insere uma consulta ou definição pronta para o sistema escolhido. Com exceção do Infor COM, nenhum modelo foi testado numa instalação real; os nomes de tabelas e campos baseiam-se em modelos de dados publicados.
O seu sistema ainda não foi testado? Torne-se cliente piloto – 12 meses da edição Completa grátis.
| Sistema | Origem | Estado |
|---|---|---|
| Infor COM | Oracle | testado com R7.9 |
| Infor CRM (Saleslogix) | SQL Server | Procuram-se testers |
| Infor CloudSuite Industrial / SyteLine | SQL Server | Procuram-se testers |
| Infor VISUAL | SQL Server, Oracle | Procuram-se testers |
| Infor M3 | SQL Server | Procuram-se testers |
| Infor LN / Baan | SQL Server, Oracle | Procuram-se testers |
| Microsoft Dynamics CRM / 365 CE (local) | SQL Server | exemplo |
| Microsoft Dynamics 365 Business Central / NAV (local) | SQL Server | exemplo |
| SAP Business One | SQL Server | exemplo |
| SAP Business One no SAP HANA | ODBC | Procuram-se testers |
| Sage CRM | SQL Server | Procuram-se testers |
| Oracle E-Business Suite | Oracle | Procuram-se testers |
| Oracle JD Edwards EnterpriseOne | Oracle, SQL Server | Procuram-se testers |
| SuiteCRM / SugarCRM CE | MySQL/MariaDB | sintaxe testada com tabelas de teste |
| vtiger CRM | MySQL/MariaDB | sintaxe testada com tabelas de teste |
| Dolibarr ERP/CRM | MySQL/MariaDB | sintaxe testada com tabelas de teste |
| Open Dental | MySQL/MariaDB | sintaxe testada com tabelas de teste |
| Odoo | PostgreSQL | sintaxe testada com tabelas de teste |
| Firebird, SAP SQL Anywhere | ODBC | modelo |
| HubSpot CRM | REST | Procuram-se testers |
| Pipedrive | REST | Procuram-se testers |
| Salesforce | REST | Procuram-se testers |
| SuiteCRM 8 / 7.x (V8 API) | REST | Procuram-se testers |
| SugarCRM (REST v11) | REST | Procuram-se testers |
| Zoho CRM | REST | Procuram-se testers |
| Odoo (JSON-RPC) | REST | Procuram-se testers |
| SAP S/4HANA | REST (OData) | Procuram-se testers |
| Microsoft Dynamics 365 / Dataverse (online) | REST | Procuram-se testers |
| Microsoft Dynamics 365 Business Central (online) | REST, OAuth2 | Procuram-se testers |
| Microsoft Dynamics 365 Finance & Supply Chain | REST, OAuth2 | Procuram-se testers |
| Infor CloudSuite via API ION | REST, OAuth2 | Procuram-se testers |
| bexio | REST | Procuram-se testers |
| HERO (software para prestadores de serviços) | REST (GraphQL) | Procuram-se testers |
| Clio (escritórios de advocacia) | REST, OAuth2 | Procuram-se testers |
| Jobber (serviços no terreno) | REST (GraphQL), OAuth2 | Procuram-se testers |
| DATEV (exportação de clientes/fornecedores) | Ficheiro CSV | sugestão a partir dos nomes de coluna |
| Active Directory, OpenLDAP | LDAP | testado com OpenLDAP |
| Contactos ou utilizadores do Microsoft 365 | Graph | Procuram-se testers |
| Contactos do Exchange | EWS | Procuram-se testers |
O Open Dental trata dados de pacientes; são dados de saúde na aceção do RGPD. Não há modelo para o ServiceTitan porque a sua interface de contactos não devolve nomes.
Ficheiro CSV e exportação DATEV
Sem outras definições, o CallerHub lê UTF-8 com ponto e vírgula, sem linha de cabeçalho, pela ordem número, nome de apresentação, país e link. As linhas que começam com # são ignoradas.
“Mapear colunas” lê qualquer estrutura, como uma exportação de clientes/fornecedores do DATEV, uma lista do Excel ou uma exportação de CRM. O CallerHub deteta automaticamente o separador, a codificação (UTF-8 ou ANSI) e a linha de cabeçalho do DATEV. São possíveis várias colunas de telefone e valores alternativos como {Company} || {First name} {Last name}.
O CallerHub só lê o ficheiro exportado e não acede ao DATEV.

# Número;Nome de apresentação;País (opcional);Link (opcional)
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;
APIs REST
Uma origem REST é descrita linha a linha com chave=valor. Assim, também pode ligar as suas próprias interfaces.
Para os sistemas da lista de modelos, “Modelo” insere uma definição pronta. Os detalhes para ligar as suas próprias interfaces estão disponíveis mediante pedido ao suporte.
Lista de números e consulta direta
Lista de números (recomendado): o CallerHub carrega todos os números para a memória ao iniciar e no intervalo configurado (1 a 1440 minutos) e responde a cada chamada a partir dela. Se uma atualização falhar, a lista anterior continua ativa.
Consulta direta: o CallerHub consulta a origem a cada chamada. Parâmetros como :num_e164, :num_national, :num_digits, :num_local e :num_country são adaptados a cada base de dados. Os resultados ficam em cache (no máximo 20.000).
Os números são normalizados: espaços, hífens, barras, parênteses e “(0)” são removidos; + e 00 marcam números internacionais.
Várias origens de dados
- As origens são consultadas pela ordem apresentada; a primeira com resultado fornece o nome.
- Para cada central telefónica, decide que origens são consultadas.
- Se uma origem falhar, as outras continuam a responder. Se nenhuma encontrar o número e uma estiver com falha, o CallerHub responde 503 para que a falha não fique em cache como “desconhecido”.
- A edição Básica permite uma origem; a Completa, até dez (mais com licença especial).
Países e indicativos
Os números nacionais precisam do indicativo do país. Se a origem fornecer uma coluna land, esta aplica-se por linha; caso contrário, aplica-se o indicativo configurado (p. ex. 49). São reconhecidos códigos ISO (CH, AT, DEU), siglas de matrícula (D, A, FL), indicativos (41, +41, 0041) e nomes de países comuns. O prefixo nacional é tratado por país, p. ex. nenhum em Itália e em Espanha, 06 na Hungria ou 8 na Rússia.