Recientemente hemos descubierto las ventajas de la programación AGI en el dialplan de Asterisk, y nos preguntabamos si sería posible integrar una libreta de direcciones con asterisk de forma que se pudiera mostrar en el caller id el nombre del usuario que estaba llamando. De esta forma podremos ver en la ventana emergente de nuestro softphone (o en el display del teléfono IP) el nombre del contacto, en lugar del número desde el que está llamando.

En nuestro caso trabajamos con la libreta de direcciones de eGroupWare, y una vez localizada la base de datos y la tabla en la que se almacenan los contactos, el resto no supone mucho trabajo.

Empezaremos por editar el dialplan de nuestro Asterisk, e indicarle que todas las llamadas entrantes deben ser pasadas a nuestro script para comprobar si están en la libreta de contactos.

[entrantes]
exten => s,1,AGI(callerid.agi)  ;Reconocimiento del callerID
exten => s,2,Goto(horarios,s,1)  ;Comprobación del horario de oficina

A continuación crearemos nuestro script de reconocimiento de callerid. Para ello vamos a utilizar Python, pero igualmente lo podríamos haber hecho en Perl, Ruby o Php. La ventaja de la programación AGI es que es independiente del lenguaje que utilicemos, ya que la comunicación entre el dialplan y el AGI se realiza mediante la salida/entrada estándar.

Previamente hemos instalado en nuestro servidor la librería MySQLdb para Python que nos permitirá hacer consultas SQL a la base de datos de eGroupWare.

#!/usr/bin/python
#FILE: callerid.agi
 
import sys
import MySQLdb
 
# datos de la conexion SQL
host = 'avefenix'
user = 'USER'
password = 'PASS'
database = 'egroupware'

Recogemos todos los datos introducidos por la entrada estándar, aunque el unico que nos interesa es el campo ‘agi_callerid’ que es el que contiene el número teléfono entrante.

callerid = "Oculto" # por defecto
while 1:
        line = sys.stdin.readline().strip()
        if line =='':
                break
        key,data = line.split (':')
        if key  == 'agi_callerid':     #Extraemos la variable de entorno "agi_callerid"
                callerid=data.strip()	# Lo guardamos en la variable callerid
                break

Una vez obtenido el callerId conectamos con la base de datos, y le dejamos todo el peso de la operación de búsqueda a la consulta SQL. En nuestro caso vamos a buscar el teléfono en los campos de teléfono de trabajo, de casa, móvil y fax.

#Conectamos con la base de datos de Avefenix
db=MySQLdb.connect(host,user,password,database)
 
#Creamos un cursor para ejecutar la consulta
cursor = db.cursor()
 
#Hacemos la consulta SQL
cursor.execute('select n_fn,org_name from egw_addressbook where tel_work=' + callerid + ' or tel_cell=' + callerid + ' or tel_home=' + callerid + ' or tel_fax=' + callerid)

Una vez tenemos el resultado de la consulta, construimos un callerid con el nombre del contacto y la empresa a la que pertenece y se lo pasamos al dialplan mediante SET CALLERID, en caso de no encontrar ninguna coincidencia simplemente salimos y dejamos que el dialplan muestre el número de teléfono entrante.

# Cogemos el primer resultado
registro = cursor.fetchone()
 
# Si hemos encontrado al menos un resultado
if (registro != None):
        #Ponemos el nuevo callerId con el formato nombre(empresa)
        callerid = ''
        if (registro[0] != None): #Nombre del contacto
        		callerid = callerid + registro[0]
        if (registro[1] != None): #Empresa del contacto
        		callerid = callerid + '(' + registro[1] + ')'
 
        callerid = callerid.replace (' ','\ ') #Sustituimos los espacios por ‘\ ‘
 
        sys.stdout.write ("SET CALLERID " + callerid + "\n")
        sys.stdout.write ("VERBOSE El\ nuevo\ callerid\ de\ entrada\ es\ " + callerid + "\n")
        sys.stdout.flush ()
else:
        # si no hemos encotnrado el contacto en la BD
        sys.stdout.write ("VERBOSE No\ se\ ha\ encontrado\ el\ contacto\n")
        sys.stdout.flush ()

A continuación salvamos el script, en nuestro caso lo guardaremos en /var/lib/asterisk/agi-bin/callerid.agi, que será donde lo buscará nuestro dialplan. Reiniciamos Asterisk y vemos que funciona correctamente.

Aún nos quedan algunos problemas por resolver como puede ser la duplicidad de números en la agenda, o la visualización incorrecta de caracteres especiales como acentos y eñes, pero como una primera aproximación es una solución muy válida.