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ódigo | Significado |
|---|---|
200 | Nome encontrado (vazio para número desconhecido) |
401 | Chave de API ou de acesso errada ou em falta |
403 | Endereço IP não permitido para esta interface |
404 | caminho desconhecido ou módulo desligado |
405 | método HTTP errado |
429 | bloqueado temporariamente após muitas chaves erradas |
503 | nenhuma 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ção | Direção | Porta (exemplo) | Conteúdo | Quando |
|---|---|---|---|---|
| Central telefónica → CallerHub | entrada | 8080 HTTP / 8443 HTTPS | Número, opcionalmente número chamado e utilizador, chave de API → nome, opcionalmente ligação | a cada chamada |
| CallerHub → base de dados SQL | saída | 1433, 1521, 3306, 5432 | Início de sessão, SELECT | lista em intervalos ou a cada chamada |
| CallerHub → LDAP/AD | saída | 389 / 636 | Início de sessão, pesquisa | em intervalos |
| CallerHub → Microsoft 365, EWS, REST | saída | 443 | Pedido de token, leitura de contactos | em intervalos ou a cada chamada |
| CallerHub → SMTP / webhook | saída | 587 / 465 / 25, 443 | Falha e recuperação, relatórios; sem números | em caso de falha ou conforme o agendamento |
| Browser / monitorização → CallerHub | entrada | igual à interface | Estatísticas, análise de chamadas, monitorização com chave de acesso | ao aceder |
| Telefones → lista telefónica LDAP | entrada | 389 / 636 | Pesquisa por nome e inversa | a cada pesquisa |
| Receção em direto de registos | entrada ou saída | 5100, 5101, 5038, 1080, 1012 ou 443 | Registo por chamada | contínua ou em intervalos |
| CallerHub → callerhub.de | saída | 443 | Consulta da versão mais recente, transferência do programa; com chave de licença própria, a lista assinada de revogação de licenças | em “Procurar atualizações” ou atualização; lista de revogação uma vez por dia |
| CallerHub → STARFACE (REST) | saída | 443 | Contactos na própria lista telefónica do STARFACE | à noite, após recarregar, a pedido |
| Telefones Mitel → CallerHub | entrada | HTTP, TFTP | Ficheiros de configuração, páginas do visor | ao iniciar o telefone, a pedido |
| CallerHub → nuget.org | saída | 443 | Transferência do controlador Oracle | só se faltar e o utilizador confirmar |
| Deteção de rede | saída | incl. 1433, 1521, 3306, 5432, 389, 636, 5060, 1012; UDP 1434, 1900 | Tentativa de ligação sem início de sessão | só após início explícito |
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.