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ódulofunc_curl) chama um endereço; o resultado é escrito emCALLERID(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ónica | Consulta 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 = cdremmanager.confe definaenabled = yesemcdr_manager.conf. - Ficheiro:
Master.csvdo módulo CDR do Asterisk, também para chamadas anteriores.

Erros comuns
| Observação | Causa e solução |
|---|---|
| O nome fica vazio, o CallerHub não mostra nenhum pedido | O 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 403 | Chave 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 nome | Número desconhecido (teste com “Verificar número”), format errado, ou o tempo limite é inferior ao tempo de resposta. |
| Tremas ou acentos errados | As 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.
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.