FUNDACION CODIGO LIBRE DOMINICANA DIVISION DE INGENIERIA Y PROYECTOS

Transcripción

1 Qué es PBX? Es la sigla para Private Branch exchange. Es el sistema que conecta llamadas dentro de la misma compañía. Comúnmente puede tener desde dos a diez mil extensiones y una conexión al sistema telefónico tradicional (PSTN) para llamadas hacia y desde el exterior de la compañía. Asterisk (en su definición mas común) Es una aplicación de software libre (bajo licencia GPL) creada inicalmente por mark spencer, provee funcionalidades de una central telefónica (PBX). Digium es empresa que promueve el software e invierte en ambos aspectos, el desenvolvimiento de código fuente y en hardware de telefonía de bajo costo que funciona con Asterisk, aunque podemos conectarlo a la red pública de telefonía PSTN (Public Service Telephony Network) con o sin hardware. El proyecto Zapata HOY Dahdi El proyecto ZAPATA fue conducido por Jim Dixon. El es el responsable por el desarrollo del hardware de DIGIUM. Es interesante resaltar que el hardware también es abierto y puede ser producido por cualquier empresa. Hoy Existen placa E1/T1s es producida por Digium, Sangoma y también por Varion. La historia del proyecto zapata puede ser vista en: Conceptos Basicos Canal: Es una conexion que conduce una llamada entrante o saliente en el sistema asterisk. La conexion puede venir o salir hacia telefonia tradicional analogica o digital, o VoIP. Dialplan: Se trata de la configuracion de la central de asterisk que indica el itinerario que sigue una llamada desde que entra o sale del sistema hasta que llega a su punto final. Se trata en lineas generales del comportamiento logico de la central. Extension: En telefonia tradicional, las extensiones se asocian con telefonos, interfaces o menues. En asterisk, una extension es una lista de comandos a ejecutar. Las extensiones se acceden cuando: Se recibe una llamada entrante por un canal dado. El usuario que ha llamado marca la extension Se ejecuta un salto de extensiones desde el dialplan de asterisk. Contexto: El dialplan o logica de comportamiento de asterisk se divide en uno o varios contextos. Un contexto es una coleccion de extensiones. Los contextos existen para poder diferenciar el lugar donde se encuentra una llamada. Aplicacion: Asterisk ejecuta secuencialmente los comandos asociados a cada extension. Esos comandos son realmente aplicaciones que controlan el comportamiento de la llamada y del sistema en si. Ejemplos: Hangup: Colgar la llamada Dial: Realiza una llamada saliente Playback: Reproduce un archivo de sonido Mas adelante hablaremos mas a fondo de aplicaciones.

2 Protocolo SiP fuentes Estructura de Directorios Una sesión de llamada SIP entre 2 teléfonos es establecida como sigue: El teléfono llamante envía un invite El teléfono al que se llama envía una respuesta informativa 100 Tratando retorna. Cuando el teléfono al que se llama empieza a sonar una respuesta 180 sonando es retornada. Cuando el receptor levanta el teléfono, el teléfono al que se llama envía una respuesta 200 OK El teléfono llamante responde con un ACK confirmado Ahora la conversación es transmitida como datos vía RTP Cuando la persona a la que se llama cuelga, una solicitud BYE es enviada al teléfono llamante El teléfono llamante responde con un 200 OK. Es tan simple como eso. El protocolo SIP es fácil de entender y es lógico. /etc/asterisk: Contiene los archivos de configuración. Si al compilar ejecutamos make samples, tendremos ejemplos en este directorio. /usr/lib/asterisk/modules: Contiene los módulos de Asterisk que hemos compilado. /var/lib/asterisk: Contiene diferentes librerías de Asterisk. /var/lib/asterisk/agi-bin: Directorio para contener los AGI. /var/spool/asterisk: Directorio para archivos que genera Asterisk (voic , etc.) /var/log/asterisk: Aquí se guardan los log de Asterisk. Archivos de Configuracion extensions.conf: el propio Dialplan. features.conf: dialplan para métodos complementarios (transferencias, call parking, grabación de llamadas bajo demanda, etc.). meetme.conf: para conferencias. musiconhold.conf: configuracion de la musica en espera. queues.conf: configuracion de colas de llamadas. voic .conf: configuracion de los buzones de voz. Asterisk se configura desde multiples archivos de configuracion, cada uno para una determinada area. Los mas importantes son: Archivo de configuracion maestro: asterisk.conf Archivo de configuracion de modulos: modules.conf Canales: iax.conf: Canales IAX (Inter Asterisk exchange) sip.conf: Canales SIP /etc/dahdi/system.conf: Telefonia Analogica y digital. Instalacion de Asterisk 1.8: Requerimientos Los requerimientos para instalar asterisk son de acuerdo a la necesidad del usuario podríamos poner unos requerimiento aunque podría ser irrelevante dado que los requerimientos varían constantemente de acuerdo a la necesidad.

3 Asterisk utiliza el procesador para procesar las llamadas esto quiere decir que de acuerdo a nuestra necesidad necesitaremos un procesador de gran capacidad para procesar las llamadas simultaneas Requerimiento de paquetes para compilar: libpri, dahdi y asterisk Centos: yum install -y gcc ncurses-devel libtermcap-devel kernel-devel kernel-smp-devel gcc-c++ openssl-devel newt-devel zlib-devel unixodbc-devel libtool wget make Debian: apt-get install build-essential subversion libncurses5-dev libssl-dev libxml2-dev vim-nox linux-source wget linux-headers-`uname -r` unixodbc-dev Esta opción es independiente de la distribución GNU/linux o derivado de (RedHat o Debian), pero instalara todas las dependencias [root@serverasterisk ~]# cd /usr/src/asterisk-src/asterisk-1.8-current [root@serverasterisk ~]#./contrib/scripts/install_prereq install [root@serverasterisk ~]#./contrib/scripts/install_prereq install-unpackaged Nota: nosotros vamos a crear un directorio de nombre asterisk-src /usr/src/ para extraer y compilar seguimos el orden: libpri, dahdi y por ultimo asterisk, usaremos wget para descargar los fuentes de digium. [root@serverasterisk ~]# mkdir /usr/src/asterisk-src [root@serverasterisk ~]# cd /usr/src/asterisk-src [src]# wget [src]# wget [src]# wget Extrayendo los códigos fuentes opcion 1 dotos a la vez [root@server src]#for x in *.gz;do tar zxvf $x;done opcion 2 paquete por paquete [root@srvasterisk src]#tar xzvf asterisk-1.8-current.tar.gz [root@srvasterisk src]#tar xzvf dahdi-linux-complete-current.tar.gz [root@srvasterisk src]#tar xzvf libpri-1.4-current.tar.gz Compilando Libpri [root@server src]#cd libpri-1.4-current [root@server src]#tar xzvf [root@server src]#make clean [root@server src]#make [root@server src]#make install Compilando Dahdi y Dahdi Tools [root@server src]#cd dahdi-linux-complete-current [root@server src]#make clean [root@server src]#make [root@server src]#make install Compilando Asterisk [root@server src]#cd asterisk-1.8-current [root@server src]#./configure [root@server src]#make menuconfig [root@server src]#make [root@server src]#make install [root@server src]#make config [root@server src]#make samples Agregando un usuario para asterisk Cambiando el usuario con que ejecutaremos asterisk

4 Creamos un usuario de nombre asterisk src]# adduser asterisk Cambiamos los permisos src]# chown -R asteriskpbx:asteriskpbx /usr/lib/asterisk/ src]# chown -R asteriskpbx:asteriskpbx /var/lib/asterisk/ src]# chown -R asteriskpbx:asteriskpbx /var/spool/asterisk/ src]# chown -R asteriskpbx:asteriskpbx /var/log/asterisk/ src]# chown -R asteriskpbx:asteriskpbx /var/run/asterisk src]# chown asteriskpbx:asteriskpbx /usr/sbin/asterisk src]# chown -R asteriskpbx:asteriskpbx /var/lib/asterisk/sounds/ Editamos el archivo asterisk.conf para indicarle con que usuario inicia asterisk src]# vim /etc/asterisk/asterisk.conf Modificamos el archivo en los parámetros runuser=asteriskpbx rungroup=asteriskpbx Configurando Asterisk PBX El archivo extensions.conf es la parte central de toda la configuración, dado que es donde se define el dialplan de Asterisk. caracteres alfanuméricos además del guión y el guión bajo. Ejemplo: Entradas invalidas y timeouts Ejemplo. exten => 100,1,Answer( ) ; contesta la llamada exten => 100,n,Background(enter ext of person) ; espera digitos y pasa a la extension en el mismo contexto exten => 100,n,WaitExten(10) exten => 100,n,Hangup() exten => 101,1,Dial(SIP/101,10) exten => 101,n,Playback(vm nobodyavail) exten => 101,n,Hangup() exten => 102,1,Dial(SIP/101,10) exten => 102,n,Playback(vm nobodyavail) exten => 102,n,Hangup() exten => i,1,playback(pbx invalid) ; Suena un mensaje que indica extension invalida exten => i,n,playback(vm goodbye) ; Otro mensaje de adios exten => i,n,hangup() ; Cuelga la llamada exten => t,1,playback(vm goodbye) ; mensaje de adios exten => t,n,hangup() ; Cuelga la llamada Algunas variables definidas automaticamente por asterisk Listado de variables más importantes: ${CALLERID}: caller ID actual, nombre y número. ${CONTEXT}: contexto actual. ${EXTEN}: extensión actual. ${CHANNEL}: canal actual. ${DIALSTATUS}: estado de la llamada: unavailable, congestion, busy, noanswer, answer, cancel, hangup. ${DATETIME}: hora actual. Un comando útil para ver el contenido es NoOp: NoOp ( ${VARIABLE} ) ; Mostrará en el CLI el valor. Variable ${EXTEN}

5 Permite saber cuál es la extensión que fue marcada. Se utiliza comunmente para eliminar dígitos marcados: ${EXTEN:x} Si x es positivo, quita los primeros x dígitos marcados exten => _XXX,1,SayDigits(${EXTEN:1}) Si x es negativo, devuelve los últimos x dígitos marcados exten => _XXX,1,SayDigits(${EXTEN: 1}) Aplicación GotoIf() GotoIf(expresion1?destino1:destino2) Ejemplo GotoIf [extensiones] exten => 105,1,Set(TEST=1) exten => 105,2,GotoIf($[${TEST} = 1]?10,3) exten => 105,3,Playback(weasels eaten phonesys) exten => 105,4,Playback(office iguanas) exten => 105,5,Set(COUNT=10) exten => 105,6,GotoIf($[${COUNT} > 0 ]?:10) exten => 105,7,SayNumber(${COUNT}) exten => 105,8,Set(COUNT=${COUNT} 1) exten => 105,9,Goto(2) exten => 105,10,Hangup() exten => 105,11,GotoIf($[${CALLERIDNUM} = ]?12:10) exten => 105,12,Dial(SIP/102) exten => 105,13,Playback(abandon all hope) exten => 105,14,Hangup() Bifurcación condicional basada en tiempo Verifica la hora actual del servidor, permitiendo tomar decisiones basadas en tiempo. Se utiliza cuando se quiere dar una bienvenida diferente en horarios de trabajo y fuera de trabajo. GotoIfTime(hora,dias_de_semana,dias_del_mes,meses?etiqueta) Envía la llamada a etiqueta si la fecha y hora actual concuerdan con el criterio especificado por los parámetros. Hora. Lista de uno o más rangos de horario en formato de 24 horas. 09:00 17:00 Dias_de_semana. Lista de uno o más días de la semana mon, tue Dias_del_mes. Día numérico del mes 7 12,15 Meses. Lista de uno o más meses del año un, apr, jul * Matchea con cualquier valor Etiqueta puede ser una prioridad dentro de una misma extensión, una prioridad y extensión dentro del mismo contexto o un contexto, extensión y prioridad. Ejemplo: [inicio] exten => 222,1,GotoIfTime(06:00 17:59),mon fri,*,*?entrada,s,1) exten => 222,n,Goto(afterhours,s,1) El ejemplo anterior indica que cuando se marque la extension 222, si el usuario marca entre las 6am y 5:59pm de lunes a viernes ira al contexto entrada, prioridad 1. De lo contrario ira al contexto afterhours, prioridad 1. Voic Una de las caracteristicas mas populares en la telefonia moderna es la capacidad de dejar mensajes de voz para ser recogidos mas tarde en caso de que el usuario a quien se llama no este disponible. Naturalmente, asterisk posee un voic bastante flexible con las siguientes caracteristicas: Ilimitada proteccion de passwords.

6 Diferentes saludos para los distintos tipos de estado(busy,noanswer,unavailable,etc) Saludos por defecto y tambien personalizados Notificacion por correo y con la opcion de adjuntar el mensaje de voz en el mismo. Indicador de que tiene un mensaje de voz. Aplicado para distintos tipos de telefonos ip. Directorio de la compania basado en los buzones de voz La configuracion del voic es muy facial, a continuacion paso a paso de una manera muy decriptiva como crear el buzon de voz y sus distintas opciones: Para la configuracion basica del voic se veran afectados los archivos de configuracion voic .conf, sip.conf y extensions.conf Primero declaramos el contexto al final del archivo voic .conf que contendra los buzones de voz correspondientes a las extensiones 101 y 102. La sintaxis es: voic .conf [buzon] 101 => 1234,Cristhian,cristhian@codigolibre.org 102 => 5678,Elvyn,elvyn@codigolibre.org Donde 101 = Es el numero o extension al cual se le asignara el buzon 1234 = Es la clave que sera usada para acceder al buzon de voz Cristhian = Nombre asociado al buzon cristhian@codigolibre.org = Correo donde recibira las notificaciones Ahora editamos el archivo sip.conf donde le diremos a las extensiones 101 y 102 cuales seran sus buzones. Quedara de la siguiente manera: sip.conf [101] type=friend callerid=cris context=extensiones username=101 secret=101 host=dynamic mailbox=101@buzon [102] type=friend callerid=elvyn context=extensiones username=102 secret=102 host=dynamic mailbox=102@buzon ; Friends place calls and receive calls ; This peer register with us ; Friends place calls and receive calls ; This peer register with us Notese como se le asigna a cada usuario un numero de buzon en el contexto buzon. Configuramos la aplicacion Voic en el diaplan correspondiente a los usuarios. De igual modo, tambien habilitamos la extension para llamar el buzon de voz el cual sera en nuestro caso la extension 888. El contexto extensiones quedaria asi: extensions.conf [extensiones] include => inicio

7 include => entrada exten => 101,1,Dial(SIP/101,20) exten => exten => 101,n,Playback(vm goodbye) exten => 101,n,Hangup() exten => 102,1,Dial(SIP/102,20) exten => exten => 101,n,Playback(vm goodbye) exten => 102,n,Hangup() ;Voic exten => Las Lineas en negritas habilitan el buzon de voz para los usuarios 101 y 102 y la extension 888 habilita la aplicacion Voic Main la cual es la administracion del buzon de voz. La opcion (@buzon) muestra la interfaz de administracion para el contexto buzon creado en el archivo voic .conf. Esto indica que cuando el usuario llame la extension 888 se le solicitara un numero de buzon y una clave para poder acceder. Ya dentro del buzon tendra varias opciones para administrar sus mensajes. Los mensajes se graban en el directorio /var/spool/asterisk/voic / Este es el menu mostrado al usuario para la administracion de sus mensajes a traves de la aplicacion Voic Admin: 1 Mensajes Leidos 3 Opciones Avanzadas 1 Responder 2 Devolver la llamada 3 Sobre 4 Llamada Saliente 5 Dejar un mensaje * Regresar al menu principal 4 Escuchar mensajes anteriores 5 Repetir mensaje actual 6 Tocar el proximo mensaje 7 Borrar el actual mensaje 8 Reenviar el mensaje a otro buzon de voz 9 Guardar el mensaje en un folder * Ayuda # Salir 2 Cambiar folder 3 Opciones avanzadas 0 Opciones del buzon 1 Grabar mensaje de no disponible 2 Grabar mensaje cuando el status sea ocupado 3 Grabar su nombre 4 Cambiar su password * Regresar al menu principal * Ayuda # Salir Ahora estamos listos para recibir mensajes de voz y poder escucharlos a traves del voic admin. Editando las opciones del archivo voic .conf Podemos editar algunas opciones en el archivo voic .conf, algunas son: enviar notificacion por

8 correo, adjuntar el archivo de grabacion en el correo, establecer un numero maximo de mensajes por buzon, establecer un tiempo maximo o minimo de grabacion de mensajes, establecer un cuerpo del mensaje a enviar, etc. server =asterisk@fcld.local :Indica el usuario que envia el mensaje. attach=yes : Establecido a yes el usuario recibira via el mensaje grabado maxmsg=100 : Maximo numero de mensajes que se le permitira al dueno del buzon. maxmessage=180 : Tiempo maximo permitida para la grabacion del mensaje. maxsilence=10 : El servidor espera 10 segundos de silencio antes de terminar la llamada. maxlogins=3 : Numero maximo de intentos fallidos. subject=[pbx]: Mensaje Nuevo ${VM_MSGNUM} en el buzon de voz ${VM_MAILBOX} : Corresponde al asunto que sera mostrado cuando le llegue un correo al usuario. Notese como se utilizan variables de mailbox, mas adelante hablaremos de ellas. body = : Indica el cuerpo del mensaje que recibira el usuario al ser notificado. dateformat=%a, %B %d, %Y at %r : Formato de Fecha donde: %A = Dia de la semana %B = Mes %d = Dia %Y = Ano %r = hora Ya tenemos buzon de voz habilitado en nuestro asterisk. Queues (colas) Las colas son utilizadas por los sistemas PSTN para mantener las solicitudes de sus clientes hasta que algun recurso este disponible. Significa que todo el trafico entrante que exceda la capacidad disponible se colocaran en linea hasta que puedan ser atendidos. Las colas basicamente consisten en: Llamadas entrantes son colocadas en la cola Miembros que responden la cola (Extensiones o usuarios que se loguean como agentes) Una estrategia de como manejar las colas y dividir las llamadas entre los meimbros Musica mientras esperan en cola Anuncios para miembros y clientes Existen dos maneras de crear colas en asterisk: Estatica: donde no necesitas utilizar el archivo agents.conf En esta configuracion, se especificara directamente cuales seran los usuarios que responderan las llamadas correspondiente a una cola especifica. Por Ejemplo, los usuarios SIP/101, SIP/102 y SIP/103 seran los responsables de responder a la cola [micola]. Ventajas: No necesitas utilizar las aplicaciones AgentLogin y AgentBacklogin para que los usuarios se logueen. El usuario se registrara automaticamente en esta cola cuando ingrese. Dinamica: Utilizacion de agents.conf A diferencia de la estatica, aqui debemos escribir no el numero del usuario pero si el numero del agente que esta registrado en el archivo agents.conf. Por ejemplo, member => Agent/1001, member => Agent/1002, member => Agent/1003, indica que los agentes 1001,1002 y 1003 perteneceran a esa cola. Si se decide utilizar este metodo entonces las aplicaciones Agentlogin y AgentCallbacklogin. Ventajas: La ventaja principal es que el usuario podria loguearse desde cualquier terminal o extension con solo digitar su usuario y clave en la aplicacion Asterisklogin. Opciones de Queues.conf: strategy: Determina como en cual orden las llamadas entraran a los agentes. Las opciones son: ringall: La llamada entra en todos los agentes y cualquiera podra responder roundrobin: La llamada entra en cada agente disponible leastrecent: La llamada entra al agente con mas tiempo sin contestar

9 fewestcalls: La llamada entra al agente con menos tiempo sin contestar random: Selecciona al agente de manera aleatoria sin ningun parametro rrmemory: round robin con memoria. Inicia la serie en aquel ultimo que contesto periodic announce: Realiza mensajes periodicos (Ejemplo: su llamada es importante para nosotros...) periodic announce frequency: Establece con que frecuencia anuncia los mensajes joinempty: Esta opcion controla si las llamadas entrantes pueden entrar a una cola sin miembros. Las opciones disponibles son: yes: Llamadas entrantes pueden ingresar a una cola sin miembros o estos no disponibles. No: Llamadas entrantes no pueden ingresar a una cola sin miembros strict: Llamadas entrantes no pueden ingresar a una cola sin miembros o estos no disponibles. Music: Establece la musica para la espera timeout: Cuanto tiempo se le permite al telefono de un agente sonar antes de considerarse timeout retry: El tiempo a esperar antes de intentar con los agentes nuevamente maxlen: Numero maximo de llamadas entrantes permitidas en una cola. 0 es ilimitado Ahora llevaremos esto a la practica: Creando Colas Estaticas Para la creacion de colas estaticas se editan los archivos queues.conf y extensions.conf. Queues.conf Se agregara un contexto con el nombre [micola] con los siguientes parametros [micola] context=extensiones periodic announce = fcld agents busy periodic announce frequency = 60 joinempty = strict music=default strategy=rrmemory timeout=15 retry=2 maxlen = 0 member => SIP/101 ; Especificamos estaticamente cuales seran las extensiones registradas en esta cola. member => SIP/102 member => SIP/103 Luego nos dirigimos a extensions.conf para habilitar la cola extensions.conf exten => 999,1,Answer() exten => 999,n,Ringing exten => 999,n,Wait(2) exten => 999,n,Queue(micola) exten => 999,n,HangUp Asi cuando un usuario llame a la 999 suena y lo coloca en la cola [micola]. Mientras esta a la espera de ser atendido estara por uno de los agentes registrados en esa cola y escuchando la musica por defecto establecida asi como los anuncios periodicos. Creando Colas Dinamicas La unica diferencia en este tema es la inclusion del archivo agents.conf. En este se crean los agentes

10 que mas adelante seran definidos en queues.conf agents.conf Agregamos los siguientes agentes: agent => 1001,1234,Cristhian Nunez agent => 1002,1234,Carlos Castro agent => 1003,1234,Elvyn Bolges y agregamos en extensions.conf una extension con la aplicacion Agentlogin para que puedan registrarse los agentes. Extensions.conf ;Agent Login exten => 888,1,AgentCallbacklogin( ${CALLERIDNUM}@extensiones) ;Agent Logout exten => 889,1,AgentCallbacklogin( l) Cuando el agente digite 888, la aplicacion le preguntara por un usuario (1001) y una clave (1234) y la extension donde recibira las llamadas. Luego de esto todas las llamadas seran enrutadas hacia la extension especificada por el agente. Cuando el agente digite 889 se le preguntara nuevamente por un usuario, clave y extension. El agente puede entrar una nueva extension para que las llamadas sean enrutadas hacia esta ultima. Parqueo de Llamadas (Call Parking) El parqueo de llamadas permite al usuario que recibe una llamada, enviar su llamada a un "cuarto" de parqueo, para volver a atenderla desde otra extensión. Este tipo de acción es útil en el siguiente ejemplo. Supongamos que el administrador de la red recibe una llamada a su extensión ubicada en su escritorio, y esta requiere que él se ubique de frente en un servidor que se encuentra tres pisos mas arriba, y no sabe si alguien podrá atender la llamada en el teléfono ubicado en el cuarto de equipos para que pueda hacer la transferencia normal de la llamada. En este caso, la opción es enviar la llamada a un cuarto temporal, donde mientras tanto el que llama, escuchará la música en espera configurada, hasta que el administrador llegue al cuarto de equipos y vuelva a tomar la llamada. En su central telefónica, para enviar la llamada actual para un cuarto de parqueo, transfiera la llamada a una extensión predefinida, utilizando el carácter predeterminado para transferir. Un vez digitada la extensión, usted escuchará el número de extensión que deberá marcar desde el otro teléfono para volver a recuperar la llamada. La llamada quedará en espera por un lapso máximo de 2 minutos. Mientras la llamada esta parqueada, el que está llamando escuchará la música configurada como "Music On Hold". Para esta configuración tenemos que trabajar con dos archivos de configuración el primero es features.conf y extensions.conf [general] parkext => 700 ; La extension a marcar para parquear una llamada parkpos => ; Rango de extensiones que se usaran como parqueo para las llamadas context => parkedcalls; contexto del parqueo de llamadas parkingtime = 90 ; Tiempo en el parqueo en segundos

11 Luego vamos al archivo extensions.conf y agregamos el siguiente contexto: include => parkedcalls Tenemos que incluir esto en el contexto del que deseemos que use esta característica... Aclarando un poco mas... Cuando parqueemos una llamada usando la extensión 700, una grabadora nos dirá donde tenemos que recogerla, puede que sea desde la 701 al 720. Asterisk Macros Los macros son muy utilizados para construir y evitar repeticiones en el dialplan. Una vez definido el macro, estos pueden ser llamados desde una linea asi como pasarle argumentos. Ilustremos el siguiente ejemplo: Tenemos 3 extensiones en el dialplan que se ven de la siguiente manera: [extensions] exten => 1001,1,Dial(SIP/1001,30) exten => 1001,n,Playback(vm nobodyavail) exten => 1001,n,Voic (1001@buzon) exten => 1001,n,Hangup() exten => 1002,1,Dial(SIP/1002,30) exten => 1002,n,Playback(vm nobodyavail) exten => 1002,n,Voic (1002@buzon) exten => 1002,n,Hangup() exten => 1003,1,Dial(SIP/1003,30) exten => 1003,n,Playback(vm nobodyavail) exten => 1003,n,Voic (1003@buzon) exten => 1003,n,Hangup() Imaginen que sean 100 extensiones en vez de 3. Para esto aplicamos los macros de la siguiente manera: [macro phones] exten => s,1,dial(sip/${arg1},25) exten => s,n,goto(${dialstatus},1) exten => ANSWER,1,Hangup exten => CANCEL,1,Hangup exten => NOANSWER,1,Voic (${ARG1}@buzon,u) exten => BUSY,1,Voic (${ARG1}@buzon,b) exten => CONGESTION,1,Voic (${ARG1}@buzon,b) exten => CHANUNAVAIL,1,Voic (${ARG1}@buzon,u) exten => 1001,1,Macro(phones,1001) exten => 1002,1,Macro(phones,1002) exten => 1002,1,Macro(phones,1002) Expliquemos la estructura del macro [macro phones] Este es el nombre con el que se crea el macro. exten => s,1,dial(sip/${arg1},25) exten => s,n,goto(${dialstatus},1) La primera linea ya conocida, ejecuta la aplicacion Dial hablando SIP. La variable ${ARG1} indica el

12 argumento pasado al macro. Mas adelante veremos como llamamos el macro. El Goto envia la llamada dependiendo del status de la misma a las siguientes extensiones: exten => ANSWER,1,Hangup exten => CANCEL,1,Hangup exten => NOANSWER,1,Voic (${ARG1}@buzon,u) exten => BUSY,1,Voic (${ARG1}@buzon,b) exten => CONGESTION,1,Voic (${ARG1}@buzon,b) exten => CHANUNAVAIL,1,Voic (${ARG1}@buzon,u) Para llamar el macro, simplemente se ejecuta la siguiente linea: exten => 1001,1,Macro(phones,1001) exten => 1002,1,Macro(phones,1002) exten => 1003,1,Macro(phones,1003) Por ejemplo, para habilitar la extension 1001 simplemente se agrega la extension mas la aplicacion Macro. Los datos entre parentesis (phones,1001) indican el nombre del macro mas la extension a llamar, en este caso la Tomese en cuenta que la extension 1001 es llo que el macro coloca en la variable ${ARG1}. Algunas variables que utiliza el macro son: ${ARG1}: El primer argumento pasado al macro. ${ARG2}: El segundo argumento pasado al macro. ${MACRO_CONTEXT}: El contexto de esta extension que acciona este macro. ${MACRO_EXTEN}: La extension que dispara este macro. Plantillas Sip (Sip Templates) El archivos sip.conf, al igual que los macros permite en este caso habilitar plantillas para evitar repeticiones en el mismo. Se hace un patron principal de la siguiente manera: En el archivo sip.conf creamos la plantilla general con las opciones en comun que tendran cada una de las extensioneso [basico](!) # Con esta opcion declaramos la plantilla type=friend context=extensiones host=dynamic language=es disallow=all allow=ulaw allow=gsm Ya de esta manera simplemente, creamos las extensiones y llamando la plantilla principal. [2003](basico) username=2003 secret=2003 [2004](basico) username=2004 secret=2004 MixMonitor Esta aplicacion hace grabaciones de audio del canal actual. [general] autofallthrough=yes [globals]

13 CALLTIME=${STRFTIME(${EPOCH},America/Santo_Domingo,%Y %m %d %H:%M:%S)} [extensions] exten => _1XXX,1,MixMonitor(${CALLERID(num)} ${CALLTIME} ${EXTEN}.wav) exten => _1XXX,n,Dial(SIP/${EXTEN},10) exten => _1XXX,n,Playback(vm nobodyavail) exten => _1XXX,n,Hangup() Asterisk no tiene una variable de fecha propiamente definida para ser legible inmediatamente por el ojo humano, en cambio usa la variable de fecha EPOCH que si imprime la fecha pero en formato Unix ( ), en [globals] la ponemos mas legible con una funcion de fecha y declaramos la variable CALLTIME, dandones un resultado en la primera prioridad de nuestra extension de: emisor fecha(incluyendo hora) receptor.wav Los conversaciones ya grabadas iran siendo guardadas en /var/spool/asterisk/monitor. Conferencia de llamadas (meetme.conf) Meetme es utilizado para hacer llamadas en conferencia. Se crea un salon (room) en el cual todo aquel que vaya a escuchar la conferencia acceda a el mediante una clave. Editamos el archivo meetme.conf con los siguientes parametros: conf => 9001 ; Estableciendo la extension para la conferencia Tambien se puede colocar claves y claves de administrador para la misma. El administrador como bien dice su nombre, establece la sesion de conferencia. Otros parametros; conf => 9001,12345 ; Inicia la sesion con clave Tambien se puede: conf => 9001,12345,33333; Inicia la sesion con clave y el administrador tendra clave En extensions.conf llamamos la aplicacion Meetme. exten => 9001,1,Answer exten => 9001,n,Wait(1) exten => 9001,n,MeetMe(9001 p) exten => 9001,n,Playback(vm goodbye) exten => 9001,n,Hangup Algunos parametros que le podemos pasar a la aplicacion Meetme son los siguientes: p > permite al usuario salir de la conferencia presionando # m > establece que el caller solo escucha, no habla Interconexion entre Asterisks Para establecer la interconexion entre asterisk, tenemos el siguiente escenario: Servidor 1: Servidor 2: Mediante el protocolo sip, el servidor 1 establecera comunicacion con el servidor 2 Servidor 1 en sip.conf: [general] register => asterisk1:pass1@ /asterisk2

14 [asterisk2] type=friend secret=pass2 context=asterisk2_entrada host=dynamic insecure=invite [1000] type=friend host=dynamic context=phones secret=1000 Donde: En el contexto [general] la opcion register indica que el servidor 1 se registara en el servidor 2 utilizando el usuario asterisk1 y la clave pass1,la direccion ip es la direccion del servidor 2 mientas que asterisk2 es la extension local en el servidor 1 a traves del cual se enrutaran las llamadas hacia el asterisk2. Mas abajo en la extension [asterisk2] es la extension que manejara el trunking entre estos 2 equipos. En extensions.conf: [general] autofallthrough=yes [globals] [phones] include => internal include => sucursal [internal] exten => 555,1,Answer() exten => 555,n,Playback(hello world) exten => 555,n,Hangup() exten => _1XXX,1,Dial(SIP/${EXTEN},20) exten => _1XXX,n,Playback(vm nobodyavail) exten => _1XXX,n,Hangup() [sucursal] exten => _2XXX,1,Dial(SIP/asterisk2/${EXTEN},20) exten => _2XXX,n,Playback(vm nobodyavail) exten => _2XXX,n,Hangup() [asterisk2_entrada] include => internal Donde: El patron exten => _1XXX muestra las extensiones locales para el servidor 1 bajo el contexto internal. El contexto [sucursal] muestra la conexion enrutada hacia el servidor 2 de la siguiente manera: [sucursal] exten => _2XXX,1,Dial(SIP/asterisk2/${EXTEN},20) exten => _2XXX,n,Playback(vm nobodyavail) exten => _2XXX,n,Hangup() Cualquier extension que comience el patron 2 (por ejemplo 2003) sera enrutado a traves del usuario

15 SIP/asterisk2 que a su vez es el usuario que esta haciendo el trunking con servidor 2. Servidor 2 La explicacion es exactamente la misma que el servidor 1 En sip.conf: [general] register => asterisk2:pass2@ /asterisk1 [asterisk1] type=friend secret=pass1 context=asterisk1_entrada host=dynamic insecure=invite [2000] type=friend host=dynamic context=phones secret=2000 En extensions.conf [general] autofallthrough=yes [globals] [phones] include => internal include => sucursal [internal] exten => 555,1,Answer() exten => 555,n,Playback(es/hello world) exten => 555,n,Hangup() exten => _2XXX,1,Dial(SIP/${EXTEN},20) exten => _2XXX,n,Playback(vm nobodyavail) exten => _2XXX,n,Hangup() [sucursal] exten => _1XXX,1,Dial(SIP/asterisk1/${EXTEN},20) exten => _1XXX,n,Playback(vm nobodyavail) exten => _1XXX,n,Hangup() [asterisk1_entrada] include => internal Para verificar el registro satisfactorio, escribir en asterisk cli el siguiente comando: sip show registry Asterisk Stats Precioso analizador de CDR, analiza de forma sencilla tus registros de CDR! Asterisk Stat proporciona diferentes reportes y gráficos para permitir al administrador de Asterisk analizar rápidametne y de forma sencilla el tráfico de su servidor Asterisk. Todos los gráficos & reportes (que son impresionantes) están basados on la base de datos CDR.

16 Requerimientos: php gd php common php 5 php mysql php jpgraph httpd nota:para instalar php jpgraph hay que descargar el paquete el siguiete link jpgraph/php jpgraph el5.rf.noarch.rpm ya que no esta disponible en los repositorios de fedora o centos. Instalando asterisk addons: Requerimientos: mysql mysql server mysql connector odbc mysql libs mysql devel libdbi dbd mysql MySQL python mod_auth_mysql Una vez instalado mysql agregamos una contraseña a root iniciamos el servicio de mysql. [root@srvasterisk ~]# service mysqld start [root@srvasterisk ~]# mysqladmin user=root password 'codigolibre' [root@srvasterisk ~]# chkconfig mysqld on Vamos al directorio /usr/src y descargamos el paquete y lo descomprimimos. [root@srvasterisk ~]# cd /usr/src/ [root@srvasterisk src]#wget tar.gz [root@srvasterisk src]# tar xzvf asterisk addons tar.gz [root@srvasterisk src]# cd asterisk addons / [root@srvasterisk asterisk addons ]#./configure [root@srvasterisk asterisk addons ]# make menuselect ;para seleccion de los paquetes deseado. [root@srvasterisk asterisk addons ]# make [root@srvasterisk asterisk addons ]# make install [root@srvasterisk asterisk addons ]# make samples Ahora vamos al archivo /etc/asterisk/cdr_mysql.conf para configurar el nombre de la base de datos el username y passwd para el accesso de la base de datos y lo editamos de la siguiente manera. [global] hostname=localhost dbname=asteriskcdrdb table=cdr password=fcld user=asterisk port=3306 sock=/var/lib/mysql/mysql.sock Editamos el archivo /etc/asterisk/modules.conf agregamos la seccion global con los siguiente.

17 [global] cdr_addon_mysql.so Vamos hacer un login a mysql como root para crear la base de datos y el usuario que va a acceder a la base de dato,y como crear las tablas. [root@srvasterisk ~]# mysql u root p Enter password: Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 3 Server version: Source distribution Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql> create database asteriskcdrdb; mysql> GRANT SELECT,INSERT ON asteriskcdrdb.* TO asterisk@localhost IDENTIFIED BY 'fcld'; Ahora creamos la tabla cdr en la base de datos asteriskcdrdb mysql> use asteriskcdrdb; Reading table information for completion of table and column names You can turn off this feature to get a quicker startup with A Database changed mysql> CREATE TABLE cdr ( calldate datetime NOT NULL default ' :00:00', clid varchar(80) NOT NULL default '', src varchar(80) NOT NULL default '', dst varchar(80) NOT NULL default '', dcontext varchar(80) NOT NULL default '', channel varchar(80) NOT NULL default '', dstchannel varchar(80) NOT NULL default '', lastapp varchar(80) NOT NULL default '', lastdata varchar(80) NOT NULL default '', duration int(11) NOT NULL default '0', billsec int(11) NOT NULL default '0', disposition varchar(45) NOT NULL default '', amaflags int(11) NOT NULL default '0', accountcode varchar(20) NOT NULL default '', uniqueid varchar(32) NOT NULL default '', userfield varchar(255) NOT NULL default '' ); ALTER TABLE `cdr` ADD INDEX ( `calldate` ); ALTER TABLE `cdr` ADD INDEX ( `dst` ); ALTER TABLE `cdr` ADD INDEX ( `accountcode` ); Reiniciamos asterisk y hacemos una llamada para ver el cdr se esta escribiendo en la base de datos. Tambien lo podemos ver por el cli de asterisk de la manera siguiente. [root@srvasterisk ~]# asterisk vvr srvasterisk*cli> cdr mysql status Deberia de mostrar un mensaje exatamente igual a este: Connected to asteriskcdrdb@localhost using table cdr for 0 hours, 15 minutes, 15 seconds. Wrote 1 records since last restart. mysql> select uniqueid, src, calldate from cdr;

18 Instalando asterisk stat: Vamos al directorio /var/www/html y descargamos el paquete de asterisk stat desde el siguiente link: [root@srvasterisk html]# wget stat v2/asterisk stat v2_0_1.tar.gz luego lo descomprimimos y renombramos el directorio. [root@srvasterisk html]# tar xzvf asterisk stat v2_0_1.tar.gz [root@srvasterisk html]# mv asterisk stat v2_0_1 asterisk Editamos el archivo defines.php que se encuentra en el directorio de /var/www/html/asterisk/lib/ y los modificamos de la manera siguiente: [root@srvasterisk html]#vim asterisk/lib/defines.php define ("WEBROOT", " define ("FSROOT", "/var/www/html/asterisk/"); define ("LIBDIR", FSROOT."lib/"); define ("HOST", "localhost"); define ("PORT", "3306"); define ("USER", "asterisk"); define ("PASS", "192582"); define ("DBNAME", "asteriskcdrdb"); define ("DB_TYPE", "mysql"); // mysql or postgres define ("DB_TABLENAME", "cdr"); Asterisk stat v2.0.1 tiene un bug cuando tu esta exportando un cdr en formato pdf para corregir esto hay que editar el archivo export_pdf.php cambiar la linea 5: include_once(dirname( FILE ). "/lib/fpdf.php"); cambiar a include_once(dirname( FILE ). "/lib/fpdf.php"); Crear un enlace simbólico de cdr.php index.php [root@srvasterisk asterisk]# ln sf cdr.php index.php Ahora iniciemos el servicio de httpd [root@srvasterisk asterisk]# service httpd start Lo agregamos al inicio del sistema [root@srvasterisk asterisk]# chkconfig httpd on Si todos los paso fueron exitosos accedemos desde el navegado a asterisk stat:

19 Asterisk Command Line Interface Para acceder a asterisk command line interface(cli) desde al shell ejecute el comando asterisk pasandole las siguiente opciones r que provee una conexión a la consola de asterisk si el proseso de asterisk ya esta corriendo te provee una interface para controlar la consola de asterisk. [root@srvasterisk ~]# asterisk rvv srvasterisk*cli> la opcion v proporciona mas informacion de asterisk entre mas v agregamos mas informacion nos mostrara.! Es para poder ejecutar comandos de el shell sobre el CLI de asterisk. srvasterisk*cli>!ifconfig eth0 dialplan add extension contiene unos cuantos subcomandos que le permite agregar algunas funcionalidades a tu PBX sin editar directamente los archivos de configuracion. srvasterisk*cli> dialplan add extension 112,1,Dial,SIP/112/ 20 Tt into phone dialplan show muestra el dialplan para un contexto en especifico. srvasterisk*cli> dialplan show phone dialplan add include incluye un contexto en otro contexto. srvasterisk*cli> dialplan add include salida into entrada

20 dialplan reload recarga solo el archivo extensions.conf. srvasterisk*cli> dialplan reload dialplan remove extension remueve una extension. srvasterisk*cli> dialplan remove extension Whole extension removed abort shutdown Cancela un shutdown corriendo srvasterisk*cli> abort shutdown agent logoff configura una agente offline srvasterisk*cli> agent logoff sip/112 agent show muestra los agentes configurados. srvasterisk*cli> agent show agent show online muestra los agentes online srvasterisk*cli> agent show online cdr mysql status muestra el status de la conexion de cdr_mysql srvasterisk*cli> cdr mysql status cdr status muestra el status de los CDR. srvasterisk*cli> cdr status console active configura el display en la console activa srvasterisk*cli> console active console answer responde a una entrada de una llama en la console. srvasterisk*cli> console answer core show applications muestra las aplicaciones registradas para el dialplan. srvasterisk*cli> core show applications core show application muestra una descripcion de la aplicacion. srvasterisk*cli> core show application dial core show channels muestra la informacion en los canales. srvasterisk*cli> core show channels core show channeltypes muestra la informacion de tipo de canal. srvasterisk*cli> core show channeltypes core show codecs muestra las lista de todos los codecs. srvasterisk*cli> core show codecs core show codec muestra un codec en especifico. srvasterisk*cli> core show codec 2 features show muestra los features configurados. srvasterisk*cli> features show http show status muestra el status del server HTTP srvasterisk*cli> http show status iax2 reload recarga la configuracion del iax2 file. srvasterisk*cli> iax2 reload