CallerHub
PT
Download

Asterisk, FreePBX, VitalPBX e Issabel: consulta do nome do chamador via HTTP

O Asterisk define o nome do chamador no plano de marcação. Cabe-lhe decidir de onde vem o nome: uma consulta HTTP a cada chamada que o devolve a partir do seu CRM, base de dados ou diretório.

Como o Asterisk consulta um nome

  • Asterisk diretamente: no contexto de entrada, a função CURL (módulo func_curl) chama um endereço; o resultado é escrito em CALLERID(name) antes de o telefone tocar.
  • FreePBX e Issabel: o módulo CallerID Lookup Sources aceita uma origem HTTP com host, porta, caminho e consulta. Os detalhes estão na documentação da Sangoma.
  • VitalPBX: uma origem de consulta CID (HTTP/HTTPS) na rota de entrada.

Mantenha o tempo limite curto: se o serviço não responder, a chamada deve tocar na mesma de imediato. Com HTTPS, o Asterisk tem de confiar no certificado do serviço (guarde o certificado raiz no servidor Asterisk).

Com o CallerHub: o endereço para a sua central telefónica

No CallerHub, crie uma interface para a sua central telefónica em Interfaces → Adicionar interface, introduza o endereço do servidor Asterisk em Endereços IP permitidos e escolha Guardar e aplicar. “Copiar instruções” fornece o endereço completo com a chave de API real. Os exemplos usam 192.168.10.5 como computador do CallerHub e o marcador API-KEY.

Central telefónicaConsulta a introduzir
Asterisk / FreePBX (plano de marcação)…/lookup?apikey=…&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})}
FreePBX / Issabel (CallerID Lookup Sources)caminho /lookup, consulta format=text&apikey=…&number=[NUMBER]
VitalPBX (origem de consulta CID)…/lookup?apikey=…&number=[CIDNUM]

Exemplo de plano de marcação (FreePBX: extensions_custom.conf, contexto from-pstn-custom ou semelhante)

exten => _X.,1,Set(CURLOPT(httptimeout)=2)
 same => n,Set(CALLERID(name)=${CURL(http://192.168.10.5:8080/lookup?apikey=API-KEY&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})})})
 same => n,Goto(from-pstn,${EXTEN},1)

Depois, recarregue o plano de marcação (dialplan reload). Se o CallerHub não estiver acessível, o nome fica vazio após 2 segundos e a chamada continua normalmente. called transmite o número chamado para as estatísticas.

Análise de chamadas via AMI ou Master.csv

Para a taxa de atendimento e o nível de serviço, a lista de retornos de chamada e a vista em direto, o CallerHub lê os registos de chamadas:

  • Em direto via AMI: o CallerHub liga-se à porta 5038. Crie um utilizador com read = cdr em manager.conf e defina enabled = yes em cdr_manager.conf.
  • Ficheiro: Master.csv do módulo CDR do Asterisk, também para chamadas anteriores.
Análise de chamadas
Análise de chamadas dos últimos 30 dias: chamadas, taxa de atendimento, nível de serviço, taxa de retorno de chamada e retornos de chamada em aberto.

Erros comuns

ObservaçãoCausa e solução
O nome fica vazio, o CallerHub não mostra nenhum pedidoO pedido não chega ao CallerHub: verifique o endereço, a porta, a firewall do Windows e as firewalls entre as redes; teste a partir do servidor Asterisk com curl. O func_curl está carregado?
Registo: status=401 ou 403Chave de API errada, ou o endereço do servidor Asterisk não consta dos endereços IP permitidos. Atrás de NAT, o endereço de origem é outro.
O pedido chega, mas sem nomeNúmero desconhecido (teste com “Verificar número”), format errado, ou o tempo limite é inferior ao tempo de resposta.
Tremas ou acentos erradosAs respostas são UTF-8; verifique o conjunto de carateres da central telefónica.

Os guias para Asterisk, FreePBX, VitalPBX e Issabel baseiam-se em interfaces publicadas e ainda não foram verificados com estes sistemas. Confirme os marcadores, os caminhos de menu e os nomes das definições na documentação da sua versão.

Perguntas frequentes

Que formato de resposta espera o Asterisk?

Texto simples: apenas o nome, vazio para números desconhecidos. É a predefinição do CallerHub para Asterisk, FreePBX, VitalPBX e Issabel; com format também pode escolher JSON ou XML.

A consulta atrasa a chamada?

O CallerHub responde às chamadas a partir da lista de números de telefone em memória, pelo que uma base de dados lenta não atrasa a resposta. O tempo limite no plano de marcação também limita a espera, a 2 segundos no exemplo.

Posso ligar vários servidores Asterisk?

Sim. Cada central telefónica tem a sua própria interface, com chave de API própria, endereços IP permitidos próprios e a sua própria seleção de origens de dados. A edição Básica permite uma interface; 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.