CallerHub
PT
Download

Interface e rede

Aquilo de que os administradores precisam para a configuração. Os exemplos usam 192.168.10.5 como servidor do CallerHub, a porta 8080 e o marcador API-KEY.

URL de consulta para a central telefónica

A central telefónica chama este endereço a cada chamada e recebe o nome como resposta. Cada interface tem a sua própria chave de API; o CallerHub responde com as origens de dados dessa interface.

http://192.168.10.5:8080/lookup?apikey=API-KEY&number=040 66969000
  → Becker & Partner - Laura Becker   (vazio se desconhecido)

O endereço certo para cada sistema está na página Centrais telefónicas; “Copiar guia” no CallerHub fornece-o com a chave de API real. Em vez do parâmetro apikey, a chave também pode ir no cabeçalho X-Api-Key; assim, não aparece nos registos do proxy.

Códigos de resposta

CódigoSignificado
200Nome encontrado (vazio para número desconhecido)
401Chave de API ou de acesso errada ou em falta
403Endereço IP não permitido para esta interface
404caminho desconhecido ou módulo desligado
405método HTTP errado
429bloqueado temporariamente após muitas chaves erradas
503nenhuma origem pronta ou lista de números ainda não carregada

Mais ajuda para o diagnóstico: erros de ligação comuns.

Ligações de rede e portas

O CallerHub só estabelece as ligações que configurar. Não envia dados de chamadas nem pessoais ao fornecedor; só se liga a callerhub.de para a procura de atualizações e, com chave de licença própria ou um teste, para a lista de revogação e a verificação online da licença.

LigaçãoDireçãoPorta (exemplo)ConteúdoQuando
Central telefónica → CallerHubentrada8080 HTTP / 8443 HTTPSNúmero, opcionalmente número chamado e utilizador, chave de API → nome, opcionalmente ligaçãoa cada chamada
CallerHub → base de dados SQLsaída1433, 1521, 3306, 5432Início de sessão, SELECTlista em intervalos ou a cada chamada
CallerHub → LDAP/ADsaída389 / 636Início de sessão, pesquisaem intervalos
CallerHub → Microsoft 365, EWS, RESTsaída443Pedido de token, leitura de contactosem intervalos ou a cada chamada
CallerHub → SMTP / webhooksaída587 / 465 / 25, 443Falha e recuperação, relatórios; sem númerosem caso de falha ou conforme o agendamento
Browser / monitorização → CallerHubentradaigual à interfaceEstatísticas, análise de chamadas, monitorização com chave de acessoao aceder
Telefones → lista telefónica LDAPentrada389 / 636Pesquisa por nome e inversaa cada pesquisa
Receção em direto de registosentrada ou saída5100, 5101, 5038, 1080, 1012 ou 443Registo por chamadacontínua ou em intervalos
CallerHub → callerhub.desaída443Consulta da versão mais recente, transferência do programa; com chave de licença própria, a lista assinada de revogação de licençasem “Procurar atualizações” ou atualização; lista de revogação uma vez por dia
CallerHub → STARFACE (REST)saída443Contactos na própria lista telefónica do STARFACEà noite, após recarregar, a pedido
Telefones Mitel → CallerHubentradaHTTP, TFTPFicheiros de configuração, páginas do visorao iniciar o telefone, a pedido
CallerHub → nuget.orgsaída443Transferência do controlador Oraclesó se faltar e o utilizador confirmar
Deteção de redesaídaincl. 1433, 1521, 3306, 5432, 389, 636, 5060, 1012; UDP 1434, 1900Tentativa de ligação sem início de sessãosó após início explícito
Esquema: o STARFACE Cloud alcança o CallerHub pela firewall via HTTPS 8443; o CallerHub lê o SQL Server da rede interna.
Exemplo A: STARFACE Cloud, base de dados na sua rede. Entrada apenas pela porta 8443 a partir do STARFACE.
Esquema: 3CX ou Asterisk na sua rede consulta o CallerHub via HTTP 8080; o CallerHub lê o Active Directory via LDAPS e um CSV via SMB.
Exemplo B: central telefónica na sua rede com Active Directory e ficheiro CSV (esquemas em alemão).

Outras interfaces

  • Acesso pelo browser: estatísticas e análise de chamadas no browser, redirecionamento para o registo no CRM em pop-ups CTI – com chave de acesso própria.
  • Monitorização: Nagios, Icinga, Checkmk, PRTG, Zabbix, Prometheus e Grafana – com chave de monitorização própria.
  • Registos e eventos de chamadas de centrais telefónicas e scripts próprios.
  • Plugins: extensões próprias executadas a cada chamada.

Os detalhes técnicos destas interfaces (endereços e parâmetros, comandos de consola, interface de plugins e de eventos) estão disponíveis mediante pedido ao suporte: info@callerhub.de.