3CX: consulta de contactos a partir da sua própria base de dados
O 3CX mostra nomes dos seus próprios contactos. Para dados de um CRM, de um ERP ou de uma base de dados, oferece uma integração CRM: um modelo descreve que endereço o 3CX chama com o número de telefone e como lê a resposta.
Como o 3CX consulta um CRM
Numa chamada recebida, o 3CX chama o endereço guardado no modelo com o número de telefone e adota o nome e, se existir, a ligação ao registo. O modelo é carregado na consola de gestão do 3CX em Integrations → CRM; o caminho exato do menu depende da versão. A estrutura e os marcadores do modelo estão descritos na documentação do 3CX.
Para isso funcionar, o 3CX tem de alcançar o serviço consultado através da rede. Se o seu 3CX funcionar num fornecedor de alojamento ou na nuvem, o serviço precisa de um endereço acessível a partir da internet; nesse caso, use HTTPS e limite os endereços de origem permitidos.
Com o CallerHub: criar o modelo, carregá-lo, pronto
- No CallerHub, escolha 3CX em Interfaces → Adicionar interface, indique um nome e clique em Criar.
- No cartão Central telefónica, escolha “3CX (modelo CRM)”, introduza o endereço do 3CX em Endereços IP permitidos e clique em Guardar e aplicar.
- Guarde o modelo com Modelo 3CX …. O ficheiro contém o endereço e a chave de API desta interface.
- No 3CX, carregue o modelo em Integrations → CRM e selecione CallerHub como CRM.
- Ative a pesquisa por número de telefone e faça uma chamada de teste. O acesso aparece no CallerHub em Pedidos recentes.
O 3CX consulta com format=json e recebe o nome, o número de telefone e – se estiver configurado para a origem de dados – o endereço do registo no CRM.

De onde vêm os nomes
O 3CX pergunta apenas ao CallerHub; o CallerHub consulta todas as origens de dados selecionadas para esta interface, pela ordem que definir. A primeira origem com resultado fornece o nome. Uma configuração típica é um CRM como base de dados SQL ou através de uma API REST, mais o Active Directory para os colegas ou uma exportação DATEV. Se uma origem falhar, as outras continuam a responder.
O número de telefone pode chegar em qualquer notação (nacional, +49, 0049, com espaços); o CallerHub normaliza-o antes da pesquisa, ver números de telefone no formato E.164.
Análise de chamadas com o 3CX
Para a taxa de atendimento, o nível de serviço e a lista de retornos de chamada, o CallerHub precisa dos registos de chamadas do 3CX. Estes chegam após a chamada:
- Saída CDR (v18/v20): no 3CX, em Admin → Settings → CDR; ativa (o CallerHub escuta numa porta, p. ex. 5100) ou passiva, ou como exportação CSV.
- 3CX V20 via API (nuvem ou local): o CallerHub obtém os dados via XAPI; no 3CX, crie um cliente com acesso XAPI em Integrations → API.
O guia do 3CX baseia-se em interfaces publicadas e ainda não foi verificado com um 3CX real. Confirme os caminhos de menu e os nomes das definições na documentação da sua versão.
Perguntas frequentes
Tenho de escrever eu próprio o modelo CRM para o 3CX?
Não. O CallerHub guarda o modelo com o botão “Modelo 3CX …”; o endereço e a chave de API da interface já estão incluídos. Basta carregar o ficheiro no 3CX.
O 3CX também mostra uma ligação para o cliente no CRM?
Sim, se estiver configurada uma ligação ao registo na origem de dados (p. ex. um endereço com um marcador para o número de cliente). O CallerHub transmite-a ao 3CX na resposta.
Funciona com a edição Básica gratuita?
Sim. A edição Básica permite uma interface e uma origem de dados; o 3CX pode ser essa interface. A edição Completa permite até dez interfaces e dez origens de dados e acrescenta a análise de chamadas alargada.
Teste com os seus próprios dados.
Experimente a edição Completa durante 30 dias: peça o período de teste no CallerHub e a chave de teste chega por e-mail. O assistente de configuração guia-o pela origem de dados, pela central telefónica e pela consulta de teste. Depois, o CallerHub continua como edição Básica gratuita, sem perder definições nem dados.