STARFACE: nome do chamador a partir de CRM, ERP ou SQL
Por si só, o STARFACE conhece os nomes dos seus próprios livros de endereços. Se os seus clientes estiverem guardados num CRM, num ERP ou numa base de dados, a central telefónica precisa de uma consulta a cada chamada ou de uma sincronização para o livro de endereços. Esta página descreve ambas as opções.
Como o STARFACE obtém um nome
- Livro de endereços da central telefónica: os contactos guardados num livro de endereços do STARFACE aparecem como nome. Se forem importados ou mantidos aí manualmente, é preciso manter atualizada uma segunda cópia dos dados.
- Um módulo por chamada: o STARFACE não tem consulta de nome integrada por endereço web. Um módulo do tipo Call-Processing pode chamar um endereço a cada chamada recebida e definir a resposta como nome do chamador.
Para o módulo, precisa de acesso de administrador ao STARFACE. Os módulos são importados em Admin → Modules → Module library → Import module (guia STARFACE, em alemão). Um STARFACE na nuvem tem de alcançar o serviço consultado a partir da internet; nesse caso, a porta é reencaminhada na sua firewall para esse computador.
Com o CallerHub: um nome para cada chamada recebida
O CallerHub inclui um módulo pronto: o ficheiro CallerHub_Interface_….sfm na pasta Samples. Numa chamada recebida, o módulo pede o nome ao CallerHub e mostra a resposta. O guia foi testado com o STARFACE 10.0.2.6 (nuvem).
- No CallerHub, escolha STARFACE em Interfaces → Adicionar interface, indique um nome e clique em Criar. Em Endereços IP permitidos, introduza o endereço de origem do STARFACE, verifique as origens de dados consultadas e clique em Guardar e aplicar.
- No STARFACE, abra Admin → Modules → Module library → Import module e escolha o ficheiro da pasta
Samples. - No Module manager, separador Module configuration, crie uma nova configuração para o módulo CallerHub. Em
LOOKUP_URL, introduza o endereço do CallerHub, p. ex.https://callerhub.example.com:8080/lookup(a terminar em/lookup, sem parâmetros); emAPI_KEY, a chave da interface. Guarde e ative a configuração. - Reencaminhe a porta do CallerHub (8080 por predefinição) na firewall para o computador do CallerHub.
- Ligue a partir de um número guardado no CRM. O acesso aparece no CallerHub em Pedidos recentes.

“Copiar instruções” no cartão fornece o mesmo guia com a chave de API real. Os nomes vêm de todas as origens de dados selecionadas para esta interface, p. ex. uma base de dados SQL, uma exportação DATEV ou o Active Directory.
Chamadas efetuadas, aplicação e cliente web: sincronizar o livro de endereços
Nas chamadas efetuadas, a aplicação STARFACE, o cliente web e as listas de chamadas só mostram nomes dos livros de endereços do STARFACE. Para estes casos, o CallerHub grava os contactos das suas origens de dados num livro de endereços separado através da interface REST do STARFACE: todas as noites à hora definida, após cada recarregamento das origens de dados e com um clique.
- Só no próprio livro de endereços: o CallerHub cria, altera e elimina contactos apenas aí. Se uma origem estiver vazia ou tiver diminuído mais de metade, não elimina nada.
- Ligação a partir do interior: o CallerHub liga-se à central telefónica; para isso, não é necessária nenhuma regra de firewall de entrada. A partir do STARFACE 10, com OAuth.
- Criar o livro de endereços: a partir do STARFACE 10, é criado em Administration → Address book → Directory configuration com acesso de escrita, com o mesmo nome que no CallerHub.
Análise de chamadas e vista em direto
Introduza também EVENT_URL no módulo: o mesmo endereço, a terminar em /event. O módulo comunica então cada evento de uma chamada (a tocar, atendimento, fim da chamada, reencaminhamento) para a análise de chamadas, as estatísticas e a vista em direto. Para isso, o CallerHub precisa do número base da central telefónica (p. ex. +49 40 66969); caso contrário, não consegue reconhecer a direção nem as chamadas internas.
Para chamadas anteriores, use a exportação dos dados de chamadas: Administration → Evaluation → Export call data; depois, coloque o ficheiro output.csv na pasta da interface.
Erros comuns
| Observação | Causa e solução |
|---|---|
Module Designer, separador Log File: ConnectTimeoutException | O STARFACE não consegue alcançar o CallerHub. Verifique o endereço, o reencaminhamento de porta e o HTTPS. |
Registo: status=401 | A chave de API na configuração do módulo está errada. |
Registo: status=403 | O endereço IP do STARFACE não consta dos endereços IP permitidos; o registo mostra-o como ip=…. |
Registo: status=404 | O endereço não termina em /lookup. |
| Nenhum pedido nas chamadas | O tipo de módulo tem de ser Call-Processing e a configuração tem de estar ativa. |
| Todas as chamadas aparecem como efetuadas | Introduza o número base da central telefónica no CallerHub. |
O registo do módulo STARFACE pode conter credenciais. Verifique-o antes de o partilhar e remova as palavras-passe.
Perguntas frequentes
Tenho de criar eu próprio o módulo STARFACE?
Não. O CallerHub inclui o módulo como ficheiro na pasta Samples; basta importá-lo e introduzir o endereço e a chave de API. Se a importação mostrar “Licence required”, o suporte ajuda.
Funciona com o STARFACE Cloud?
Sim. O guia foi testado com o STARFACE 10.0.2.6 na nuvem. O CallerHub precisa então de um endereço acessível a partir da internet, e os endereços IP permitidos limitam os pedidos ao endereço de origem do seu STARFACE.
Os dados de clientes são copiados para o STARFACE?
Não para a consulta de nome: o módulo pergunta a cada chamada e o CallerHub responde a partir da sua lista em memória. Só a sincronização opcional do livro de endereços grava contactos num livro de endereços STARFACE separado.
Que origens de dados pode o STARFACE consultar desta forma?
Todas as origens de dados do CallerHub: SQL Server, Oracle, MySQL/MariaDB, PostgreSQL e outras bases de dados ODBC, ficheiros CSV como a exportação DATEV, APIs REST de sistemas CRM e ERP, LDAP/Active Directory, Microsoft 365 e Exchange. A edição Básica permite uma origem de dados; a Completa, até dez.
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.