Asterisk, FreePBX, VitalPBX e Issabel: consulta del nombre del llamante por HTTP
Asterisk fija el nombre del llamante en el plan de marcación. Usted decide de dónde procede el nombre: una consulta HTTP por llamada que lo devuelve desde su CRM, su base de datos o su directorio.
Cómo busca Asterisk un nombre
- Asterisk directamente: en el contexto entrante, la función
CURL(módulofunc_curl) llama a una dirección; el resultado se escribe enCALLERID(name)antes de que suene el teléfono. - FreePBX e Issabel: el módulo CallerID Lookup Sources admite una fuente HTTP con host, puerto, ruta y consulta. Los detalles están en la documentación de Sangoma.
- VitalPBX: una fuente de consulta CID (HTTP/HTTPS) en la ruta entrante.
Mantenga corto el tiempo de espera: si el servicio no responde, la llamada debe sonar igualmente de inmediato. Con HTTPS, Asterisk debe confiar en el certificado del servicio (guarde el certificado raíz en el servidor Asterisk).
Con CallerHub: la dirección para su centralita
En CallerHub, cree una interfaz para su centralita en Interfaces → Añadir interfaz, introduzca la dirección del servidor Asterisk en Direcciones IP permitidas y elija Guardar y aplicar. «Copiar instrucciones» ofrece la dirección completa con la clave API real. Los ejemplos usan 192.168.10.5 como equipo de CallerHub y el marcador de posición API-KEY.
| Centralita | Consulta que hay que introducir |
|---|---|
| Asterisk / FreePBX (plan de marcación) | …/lookup?apikey=…&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})} |
| FreePBX / Issabel (CallerID Lookup Sources) | ruta /lookup, consulta format=text&apikey=…&number=[NUMBER] |
| VitalPBX (fuente de consulta CID) | …/lookup?apikey=…&number=[CIDNUM] |
Ejemplo de plan de marcación (FreePBX: extensions_custom.conf, contexto from-pstn-custom o similar)
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)
Después, recargue el plan de marcación (dialplan reload). Si no se puede alcanzar CallerHub, el nombre queda vacío tras 2 segundos y la llamada continúa con normalidad. called transmite el número llamado para las estadísticas.
Análisis de llamadas mediante AMI o Master.csv
Para la tasa de atención y el nivel de servicio, la lista de devoluciones de llamada y la vista en directo, CallerHub lee los registros de llamadas:
- En directo por AMI: CallerHub se conecta al puerto 5038. Cree un usuario con
read = cdrenmanager.confy establezcaenabled = yesencdr_manager.conf. - Archivo:
Master.csvdel módulo CDR de Asterisk, también para llamadas pasadas.

Errores frecuentes
| Observación | Causa y solución |
|---|---|
| El nombre queda vacío y CallerHub no muestra ninguna solicitud | La solicitud no llega a CallerHub: compruebe la dirección, el puerto, el cortafuegos de Windows y los cortafuegos entre las redes; pruebe desde el servidor Asterisk con curl. ¿Está cargado func_curl? |
Registro: status=401 o 403 | Clave API incorrecta, o la dirección del servidor Asterisk no está entre las direcciones IP permitidas. Detrás de NAT, el origen es otro. |
| La solicitud llega, pero sin nombre | Número desconocido (pruebe con «Comprobar número»), format incorrecto, o el tiempo de espera es más corto que el tiempo de respuesta. |
| Diéresis o acentos incorrectos | Las respuestas son UTF-8; compruebe el juego de caracteres de la centralita. |
Las guías para Asterisk, FreePBX, VitalPBX e Issabel se basan en interfaces publicadas y aún no se han comprobado con estos sistemas. Compruebe los marcadores de posición, las rutas de menú y los nombres de los ajustes en la documentación de su versión.
Preguntas frecuentes
¿Qué formato de respuesta espera Asterisk?
Texto sin formato: solo el nombre, vacío para números desconocidos. Es el valor predeterminado de CallerHub para Asterisk, FreePBX, VitalPBX e Issabel; con format también puede elegir JSON o XML.
¿La consulta ralentiza la llamada?
CallerHub responde a las llamadas desde la lista de números de teléfono en memoria, por lo que una base de datos lenta no retrasa la respuesta. Además, el tiempo de espera del plan de marcación limita la espera, a 2 segundos en el ejemplo.
¿Puedo conectar varios servidores Asterisk?
Sí. Cada centralita recibe su propia interfaz con su propia clave API, sus propias direcciones IP permitidas y su propia selección de fuentes de datos. La edición básica permite una interfaz; la completa, hasta diez.
Pruébelo con sus propios datos.
Pruebe la edición completa durante 30 días: solicite el periodo de prueba en CallerHub y la clave de prueba llega por correo electrónico. El asistente de configuración le guía por la fuente de datos, la centralita y la consulta de prueba. Después, CallerHub sigue funcionando como edición básica gratuita sin perder configuración ni datos.