CallerHub
ES
Download

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ódulo func_curl) llama a una dirección; el resultado se escribe en CALLERID(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.

CentralitaConsulta 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 = cdr en manager.conf y establezca enabled = yes en cdr_manager.conf.
  • Archivo: Master.csv del módulo CDR de Asterisk, también para llamadas pasadas.
Análisis de llamadas
Análisis de llamadas de los últimos 30 días con cifras de llamadas, tasa de atención, nivel de servicio, tasa de devolución de llamadas y devoluciones de llamada pendientes.

Errores frecuentes

ObservaciónCausa y solución
El nombre queda vacío y CallerHub no muestra ninguna solicitudLa 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 403Clave 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 nombreNú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 incorrectosLas 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

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.