CallerHub
PT
Download

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).

  1. 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.
  2. No STARFACE, abra Admin → Modules → Module library → Import module e escolha o ficheiro da pasta Samples.
  3. 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); em API_KEY, a chave da interface. Guarde e ative a configuração.
  4. Reencaminhe a porta do CallerHub (8080 por predefinição) na firewall para o computador do CallerHub.
  5. Ligue a partir de um número guardado no CRM. O acesso aparece no CallerHub em Pedidos recentes.
Interfaces · Central telefónica
Cartão Central telefónica com o guia para STARFACE.

“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çãoCausa e solução
Module Designer, separador Log File: ConnectTimeoutExceptionO STARFACE não consegue alcançar o CallerHub. Verifique o endereço, o reencaminhamento de porta e o HTTPS.
Registo: status=401A chave de API na configuração do módulo está errada.
Registo: status=403O endereço IP do STARFACE não consta dos endereços IP permitidos; o registo mostra-o como ip=….
Registo: status=404O endereço não termina em /lookup.
Nenhum pedido nas chamadasO tipo de módulo tem de ser Call-Processing e a configuração tem de estar ativa.
Todas as chamadas aparecem como efetuadasIntroduza 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.

Experimentar

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.