Alfredo Certain Yance

GECKO NETWORKS Taller: Asterisk, Comunicaciones de Cdigo Abierto

Taller 1

Instalacin de Asterisk
Siga las siguientes instrucciones para instalar Asterisk y sus componentes en su equipo: 1. 2. Copie los archivos con el cdigo fuente de Asterisk al directorio /usr/src/ de su equipo de trabajo. Los archivos los encontrar en el CD-ROM en el directorio asterisk-src. Ingrese al directorio donde copi los archivos con el cdigo fuente: #cd /usr/src 3. Descomprima los archivos con el comando 'tar', por ejemplo: tar -zxvf nombrearchivo.tar.gz 4. Inicie instalando el driver zaptel Ingrese al directorio zaptel: #cd /usr/src/zaptel-version # make clean # make linux26 # make install # make install-udev Una vez hecho esto instale el script de inicio de zaptel: # make config 5. Instale libpri. Ingrese al directorio de libpri y ejecute los comandos: #cd /usr/src/libpri-version # make clean # make # make install 6. Instale Asterisk. Ingrese al directorio de asterisk y ejecute los siguientes comandos: #cd /usr/src/asterisk-version # make clean # make # make install Una vez hecho esto instale los archivos de configuracin de ejemplo: # make samples Si su equipo tiene conexin a internet instale el reproductor de MP3 mpg123: # make mpg123 7. Inicie el servicio zaptel e inicie asterisk para comprobar su instalacin.

Alfredo Certain Yance

Taller 2

Configuracin de un Telfono IP
Siga las siguientes instrucciones para configurar su telfono IP: 1. 2. 3. Determine la direccin IP de su equipo de trabajo, esta ser usada como la IP de su servidor Asterisk. Determine la direccin IP de su telfono IP asignado. Abra un navegador web y conectese a su telfono con la url: http://ipdesutelefono 4. Configure una cuenta con el nmero de extensin asignado. Utilize el mismo nmero como contrasea de la cuenta. Recuerde asignar la IP de su equipo como IP de su servidor de voz (SIPSERVER y OUTBOUND PROXY) Active los cambios realizados y reinicie su telfono si es necesario.

5.

GECKO NETWORKS Taller: Asterisk, Comunicaciones de Cdigo Abierto

Taller 3

Configuracin de una Extensin SIP

Siga las siguientes instrucciones para configurar su telfono IP como una extensin SIP: 1. Haga una copia de seguridad de su archivo sip.conf original y cree uno nuevo: #cp sip.conf sip.conf.original #touch sip.conf 2. Ingrese los datos bsicos al archivo sip.conf como se muestra a continuacin: ; Archivo de configuracion [general] port=5060 context=default bindaddr=0.0.0.0 language=es disallow=all allow=ulaw allow=alaw Cree un nuevo archivo con el nombre sip_dispositivos.conf #touch sip_dispositivos.conf Ingrese a este archivo la informacin necesaria para crear un dispositivo SIP: [su-numero-de-extension] type=friend host=dynamic context=interno username= su-numero-de-extension callerid=SuNombre <su-numero-de-extension> dtmfmode=rfc2833 mailbox=su-numero-de-extension@interno callgroup=1 pickupgroup=1 Active la inclusin de este archivo en el archivo sip.conf agregando las siguientes lneas al final de su archivo sip.conf: ; Incluir archivo de dispositivos #include sip_dispositivos.conf 3. Grabe los cambios en los archivos y activelos en Asterisk haciendo un reload con los siguientes comandos: Ingrese a la consola de Asterisk #asterisk -r Recargue la configuracin en el CLI CLI> reload 4. Verifique que su telfono registre correctamente en el servidor Asterisk con el siguiente comando:

Alfredo Certain Yance

CLI> sip show peers Si su telfono registr correctamente usted ver algo como:
CLI> sip show peers Name/username 101/101

Host 192.168.10.101

Dyn Nat ACL Port D 5060

Status Unmonitored

De lo contrario su telfono aparecer sin IP y sin puerto, como se muestra a continuacin:

CLI> sip show peers Name/username 101/101

Host (Unspecified)

Dyn Nat ACL Port D 0

Status Unmonitored

Si su telfono no registra verifique cada uno de los pasos anteriores incluyendo la configuracin de su telfono. Si los parmetros de su telfono y sus archivos de configuracin no coinciden su telfono no funcionar. En este punto su extensin puede realizar llamadas.

GECKO NETWORKS Taller: Asterisk, Comunicaciones de Cdigo Abierto

Taller 4

Activacin de Extensiones
Siga las siguientes instrucciones para activar su extensin en el plan de marcacin de su sistema: 1. Haga una copia de seguridad de su archivo extensions.conf original y cree uno nuevo: #cp extensions.conf extensions.conf.original #touch extensions.conf 2. Ingrese unos datos bsicos al nuevo archivo extensions.conf como se muestra a continuacin: ; Contexto global [globals] ; Funciones [func-generales] ;Macros ; Inclusion de archivos externos #include extensions_extra.conf 3. Cree el archivo donde colocar los contextos de extensiones #touch extensions_extra.conf 4. Ingrese los datos necesarios para hacer funcionar su extension SIP creada anteriormente: [default] include => interno [interno] include => func-generales ; extensiones SIP exten => su-numero-de-extension,1,Dial(SIP/su-numero-de-extension,30) 5. 6. A fin de probar su extensin SIP, active ahora un dispositivo IAX y cree la extension 500 que corresponde al telfono por software con protocolo IAX que est usando su instructor. Siga las siguientes instrucciones para configurar el archivo iax.conf de su sistema: 1. 2. 3. Haga una copia de su archivo iax.conf original. Renombrelo como iax.conf.original Cree un nuevo archivo iax.conf vaci usando el comando touch. Agregue las siguientes lneas al nuevo archivo iax.conf para definir los parmetros bsicos indicado que se usar el codec GSM: [general] language=es bindaddr=0.0.0.0 bandwidth=low disallow=all allow=gsm

Alfredo Certain Yance

4.

Agregue un dispositivo IAX para la extension 500. Esta ser igual en todos los equipos de los estudiantes. [500] type=friend context=interno username=500 callerid=Alfredo Certain <500> secret=500 qualify=no host=dynamic

5.

Agregue la extensin en su archivo extensions_extra.conf: ; Extensiones IAX exten => 500,1,Dial(IAX2/500,30)

6.

Ahora usted podr marcar a la extensin 500 y la extensin 500 le podr marcar a su extensin.

GECKO NETWORKS Taller: Asterisk, Comunicaciones de Cdigo Abierto

Taller 5

Uso de Variables
Siga las siguientes instrucciones para modificar su plan de marcacin para usar variables. 1. Agregue las siguientes lneas al contexto [globals] de su archivo extensions.conf, ajuste el contenido de estas lneas a los nmeros de extensin utilizados en su clase. ; Variables para extensiones SIP EXTsunumerodeextension = SIP/sunumerodeextension Por ejemplo, si su extensin es la 101 utilize: EXT101 = SIP/101 2. Modifique la forma de marcacin de su extensin modificando el archivo extensions_extra.conf. Reemplaze la lnea del comando Dial con la siguiente. Se supone como ejemplo que su extensin es la 101: exten => 101,1,Dial(${EXT101},30) Modifique la forma de marcacin para la extensin 500 que utiliza IAX. Cree primero la variable global y luego cambie la instruccin Dial asociada a la extensin. 3. Ahora la marcacin entre extensiones se realiza utilizando variables globales.

Alfredo Certain Yance

Taller 6

Creacin de Macros
Siga las siguientes instrucciones modificar su plan de marcacin para usar macros. 1. Agregue el siguiente cdigo a su archivo extensions.conf luego del comentario de Macros. [macro-stdexten] exten => s,1,Dial(${ARG1},20) exten => s,2,Voicemail(u${MACRO_EXTEN}@interno) exten => s,3,Hangup exten => s,102,Voicemail(b${MACRO_EXTEN}@interno) exten => s,103,Hangup 2. Modifique la forma en la que se realiza la marcacin en el archivo extensions_extra.conf reemplazando la lnea del comando Dial por la siguiente. Tomamos como ejemplo la extensin 101, utilize usted el nmero real de su extensin. exten => 101,1,Macro(stdexten,${EXT101}) Modifique tambin la extensin 500 creada anteriormente.

3.

Ahora su marcacin se realiza utilizando Macros.

10

GECKO NETWORKS Taller: Asterisk, Comunicaciones de Cdigo Abierto

Taller 7

Interconexin con IAX

Para esta seccin se debe trabajar en grupos de dos asistentes. Sigan las siguientes instrucciones para configurar el archivo iax.conf de cada mquina: 1. 2. Obtenga cada uno la direccin IP de su equipo de trabajo y tengala a la mano. Recuerde que esto puede hacerlo con el comando 'ifconfig' de Linux. Edite su archivo iax.conf y agregue cada uno el siguiente cdigo segn corresponda. EquipoA: Cree un dispositivo IAX que referencie al equipo de su compaero. [1001] type=friend username=1001 secret=1001 host=direccion-ip-equipo-B context=interno Equipo B: Cree un dispositivo IAX que referencie al equipo de su compaero. [1002] type=friend username=1002 secret=1002 host=direccion-ip-equipo-A context=interno 3. En el archivo extensions_extra.conf cree un mecanismo de llamada al servidor remoto para cada uno de los equipos. Equipo A: ; Contexto de llamadas x Interconexion IAX [interconexion] exten => _7X.,1,Dial(IAX2/1002:1002@direccion-ip-equipo-B/${EXTEN:1},30,r) Note que se utiliza el usuario IAX creado en el equipo B. Equipo B: ; Contexto de llamadas x Interconexion IAX [interconexion] exten => _7X.,1,Dial(IAX2/1001:1001@direccion-ip-equipo-A/${EXTEN:1},30,r) Note que se utiliza el usuario IAX creado en el equipo A. 4. Pruebe las llamadas en ambas direcciones as: Equipo A: Marque desde su extensin 7+numero-extesin-equipo-B

Alfredo Certain Yance

11

La llamada debe ingresar a la extensin del equipo B. Equipo B: Marque desde su extensin 7+numero-extesin-equipo-A La llamada debe ingresar a la extensin del equipo A. Ahora tiene dos sistemas interconectados por IAX con el codec GSM.

12

GECKO NETWORKS Taller: Asterisk, Comunicaciones de Cdigo Abierto

Taller 8

Activacin del Correo de Voz

Siga las siguientes instrucciones para activar el correo de voz en su sistema: 1. 2. Haga una copia de su archivo voicemail.conf con el nombre voicemail.conf.original. Edite el archivo voicemail.conf y agreguele un buzn de voz en el contexto default segn el siguiente ejemplo: [default] 101 => 101,SuNombre,sucorreo@suservidor.com,,attach=yes|saycid=no|envelope=no|delete=no 3. Modifique ahora su archivo extensions.conf y agregue la funcionalidad de llamado al buzn de mensajes de voz como se muestra en el siguiente ejemplo: ; Funciones [func-generales] exten => *98,1,Answer exten => *98,n,Wait(1) exten => *98,n,VoiceMailMain() exten => *98,n,Hangup() 4. 5. Asegurese de que el contexto [func-generales] est incluido dentro del contexto de sus extensiones. Pruebe el acceso a su buzn marcando *98 y siguiendo las instrucciones del buzn.

Alfredo Certain Yance

13

Taller 9

Creacin de Salas Meetme

Siga las siguientes instrucciones para configurar salas de conferencia multiples en su plan de marcacin. 1. 2. Renombre su archivo meetme.conf a meetme.conf.original. Cree un nuevo archico meetme.conf y agreguele el siguiente contenido: ; Archivo de Salas Meetme [general] [rooms] ; Uso: conf => numero-conferencia[,pin][,adminpin] conf => 201,1234 3. Cree un mecanismo para llamar a las salas meetme en su archivo extensions.conf, por ejemplo: [salas-meetme] exten => _*2XX,1,MeetMe(${EXTEN:1}) exten => _*2XX,2,Hangup 4. 5. Asegurese de que el nuevo contexto este disponible al contexto de sus extensiones. Pruebe su sala marcando el nmero de la sala. Si es posible utilize mas de una extensin para esta prueba o realize la prueba en equipo con su(s) compaeros de mesa de trabajo.

14

GECKO NETWORKS Taller: Asterisk, Comunicaciones de Cdigo Abierto

Taller 10

Call Center
Siga las siguientes instrucciones para crear un call center bsico. 1. Uno de los equipos del curso actuar como servidor principal Se debe elegir uno de los equipos y configurar todos los telfonos para que se registren contra ese servidor. Una parte de los asistentes actuar como agentes que reciben llamadas y la otra parte actuar como clientes que llaman al call center. 2. 3. En el servidor elegido se deben crear todas las extensiones SIP segn lo visto en los talleres anteriores. En ese mismo servidor se instrucciones: Colas & Agentes: 1. 2. Renombre su archivo queues.conf como queues.conf.original Cree un nuevo archivo queues.conf y agregue el siguiente contenido: [general] ; [default] ; ; Cola de pruebas [cola-curso] ; music = default announce = cola-pruebas strategy = roundrobin ;context = qoutcon timeout = 15 retry = 5 wrapuptime=15 maxlen = 0 ; member => Agent/4001 member => Agent/4002 member => Agent/4003 member => Agent/4004 member => Agent/4005 member => Agent/4016 member => Agent/4007 member => Agent/4008 member => Agent/4009 member => Agent/4010 ... Complete con tantos agentes como se requiera segn la cantidad de asistentes al curso. 3. Configure ahora los agentes teniendo cuidado de realizar una copia a su archivo original agents.conf y luego coloque el siguiente contenido: deben crear las colas y agentes del call center segn las siguientes

Alfredo Certain Yance

15

; Agent configuration [agents] ; ackcall=no ;musiconhold => default ; Listado de Agentes ; Uso: agent => numero-agente, clave, nombre-agente agent => 4001,4321,Nombre Agente agent => 4002,4321,Nombre Agente agent => 4003,4321,Nombre Agente agent => 4004,4321,Nombre Agente agent => 4005,4321,Nombre Agente agent => 4006,4321,Nombre Agente agent => 4007,4321,Nombre Agente agent => 4008,4321,Nombre Agente agent => 4009,4321,Nombre Agente agent => 4010,4321Nombre Agente 4. Ahora debe crearse un mecanismo para loguear y desloguear los agentes. Puede utilizar el siguiente ejemplo y agregarlo en su archivo extensions.conf en un contexto adecuado como el de funciones generales: ;Ingreso y Salida de Agentes exten => #400,1,AgentCallbackLogin(|${CALLERIDNUM}@local) 5. Finalmente debemos proveer un mecanismo que reciba las llamadas y las direccione a una cola: [entrantes-rtpc] exten => 900,1,Answer exten => 900,2,SetLanguage(es) exten => 900,3,SetMusicOnHold(default) exten => 900,4,GotoIfTime(06:00-18:00|mon-sun|*|*?envio-cola,s,1) exten => 900,5,DigitTimeout,2 exten => 900,6,ResponseTimeout,3 exten => 900,7,Playback(mensaje-horario) [envio-cola] exten => s,1,Queue(cola-curso|tT|||20) exten => s,2,Playback(operadores_ocupados) exten => s,3,Hangup() 6. Luego de regargar la configuracin y asegurar que todas las extensiones funcionan correctamente registrandose al servidor elegido, decidir que asistentes sern agentes y cuales sern lamantes. Los agentes debern registrarse marcando #400 y siguiendo las instrucciones, los llamantes podrn simular una llamada entrante marcando 900. Se puede monitorear el estado de los agentes y la cola en el CLI con los comandos: CLI> show queues CLI> show agentes para mostrar las colas para mostrar los agentes y sus estados

16

GECKO NETWORKS Taller: Asterisk, Comunicaciones de Cdigo Abierto

AUTOR
Alfredo Certain Yance
Ingeniero Elctrico con ms de diez (10) aos de experiencia en Telecomunicaciones y entre estos mas de tres (3) aos de experiencia con Asterisk a partir del ao 2003 y primer profesional en Latinoamrica con la Certificacin dCAP "Digium Certified Asterisk Professional". Ha diseado y ejecutado diversos montajes de Asterisk en Colombia para sectores de alta importancia en el pas tales como Bolsa, Banca, Call Center, Oficinas Virtuales y el Sector Corporativo en general. Tambin cuenta con experiencia en proyectos activos con Asterisk en Brasil y EEUU. Actualmente Gerente General de Gecko Networks.

GECKO NETWORKS www.gecko.com.co Av 15 N 106 50, Of 403 Bogot D.C. - Colombia

GECKO, 2005-2006. GECKO es una marca registrada de Gecko Networks. LINUX es una marca registrada de Linus Torvalds. ASTERISK es una marca registrada de Digium. Todas las otras marcas son propiedad de su respectivo propietario. Anexo Taller AsteriskTM, Comunicaciones de Cdigo Abierto por: Alfredo Certain Yance Copyright 2006 GECKO EU, GECKO NETWORKS. Todos los derechos reservados Impreso en Colombia Pre-Edicin Especial de distribucin controlada. Todos los derechos reservados. Ninguna parte de este documento podr ser reproducido, almacenado o transmitido por ningn medio impreso o electrnico sin el permiso escrito del autor. El autor no asume ninguna responsabilidad por errores u omisiones. No se asume ninguna responsabilidad por los daos resultantes del uso de la informacin contenida en este documento. Todas las marcas son propiedad de sus respectivos propietarios.

Alfredo Certain Yance

17