GUIA EJEMPLIFICADA DE INSTALACION Y CONFIGURACION DE

ASTERISK

Autores:
xsanzkizsh [darkbox]
Beelzebu [kowell]

Bluebox 2007

INTRODUCCION AL SCRIPT DE ASTERISK

Este Script explicativo, esta enfocado en la instalacin y configuracin de una PBX basada en Asterisk.
Los ejemplos y archivos de configuracin presentados corresponden a un Dialplan base diseado para tres funciones
fundamentales:

Manejo de Usuarios a travs de Anexos digitales, conectados mediante el protocolo SIP, y salida de llamadas
atravs de ZAP por los canales habilitados de la conexin telefnica anloga o de la PSTN.

Construccin de un IVR (Men Interactivo de Voz) con la funcionalidad de Contestar, reproducir mediante audio
pre-grabado las opciones, esperar la respuesta del cliente atravs de un dgito telefnico, y conexin entre las
opciones a anexos de usuarios conectados a Asterisk. Correo de Voz y redireccionamiento de la llamada como
prioridad en caso que el anexo no conteste. Tambin posee la configuracin para que Asterisk corte la llamada tras
un cierto tiempo de espera sin respuesta por parte del cliente.

Como opciones para el IVR, el script posee los pasos para la creacin de Casillas de Voz, Msica en Espera, y
Conferencias con MeetMe, con sus respectivos ejemplos.

Este Script pretende ser una gua base para la creacin de una Central Telefnica Digital, la cual posea interaccin con un
un linea anloga, o con una E1, un IVR base con contestacin de llamadas y men, msica en espera, voicemail y
conferencias, de tal manera que la implementacin de esta pueda ser metdica, y simplificada, sin olvidar que tras esta
configuracin se encuentran mltiples opciones asociadas a los distintos ficheros de configuracin para realizar un trabajo
ms especifico.

PREPARACION DE ASTERISK

1.-REQUERIMIENTOS
1.1.- HARDWARE:
Lista de requerimientos ptimos para la correcta utilizacin de Asterisk como servidor.

Menos de 5 lineas
5 a 10
Hasta 15
Ms de 15

400-MHz x86, 256 MB RAM

1-GHz x86, 512 MB RAM
3-GHz x86, 1 GB RAM
CPUs duales, Clustering

1.2.- DEPENDENCIAS DE SOFTWARE:

Lista de dependencias de software en sistemas GNU/Linux.

gcc
OpenSSL
ncurses
zlib
glibc-devel
ncurses-devel
openssl-devel
zlib-devel
kernel-devel (kernel-source)

2.- INSTALACION:
Instalacin del software base para la posterior implementacin de una PBX basada en Asterisk. Recordar que todos los
comandos deben ejecutarse como root.
Libpri
$ tar -zxvf libpri-*.tar.gz
$ make && make install
$ make config
Zaptel
$ tar -zxvf zaptel-*.tar.gz
$ make && make install
$ make config

Asterisk
$ tar -zxvf asterisk-*.tar.gz
$ make && make install
$ make config

CONFIGURACION BASE DE ASTERISK

1.- CONFIGURACION DE HARDWARE:
Para Asterisk existe diverso Hardware para la interconexion con las PSTN. Dependiendo del tipo de tarjeta, esto puede
realizarse atravs de una o ms lineas anlogas, o a travs de lineas digitales del tipo E1, T1, J1 PRI.
En este caso, veremos la configuracin de la tarjeta de Digium TE250P para lineas digitales E1, y la configuracin de la
tarjeta Digium TDM400P para lineas anlogas a travs de FXO y FXS utilizando LS.
1.1.-DIGIUM TDM400P
1.1.1- Editar archivo /etc/asterisk/zapata.conf y agregar al final de este, segn configuracin de los mdulos fsicos de la
tarjeta Digium TDM400P :
context = interno
channel => 1
signalling=fxs_ls
context = FXO
channel => 3
signallings=fxo_ls
;; FXO e interno son los contextos configurables en extensions.conf para salida y
entrada ;; de la seal telefnica anloga, y para la conexin de un telfono anlogo a
Asterisk.

1.1.2.- Editar archivo /etc/zaptel.conf y aadir al final:

fxols=1
fxsls=3

1.1.3.- Editar el loadzone del archivo y el defaultzone, quedando de la siguiente forma:

loadzone=cl
defaultzone=cl
1.2.-DIGIUM TE205P:
1.2.1.- Editar /etc/asterisk/zapata.conf:
[channels]
language=es
context=default
switchtype = euroisdn
pridialplan = unknown
signalling = pri_cpe

;;Contexto utilizado en /etc/asterisk/extensions.conf

;;Tipo de linea E1,T1,J1

;;Tipo de seal de la linea

group=1
callgroup=1
pickupgroup=1
channel => 1-15
channel => 17-31

Desde este punto, se pueden configurar en zapata.conf de forma opcional, las siguientes funciones:
usecallerid=yes
hidecallerid=no
callwaiting=yes
callwaitingcallerid=yes
threewaycalling=yes
transfer=yes
cancallforward=yes
echocancel=yes
immediate=no
amaflags=documentation
musiconhold=default

1.2.2.- Editar /etc/zaptel.conf

span=1,1,0,ccs,hdb3,crc4
bchan=1-15
;;Configuracin del canal 1
dchan=16
bchan=17-31
span=2,1,0,ccs,hdb3,crc4
bchan=32-46
;;Configuracin del canal 2
dchan=47
bchan=48-62
loadzone = cl
defaultzone = cl

2.-CONFIGURACIN DE ANEXOS Y USUARIOS:

Para que Asterisk pueda funcionar con el protocolo SIP, deben crearse cuentas de usuarios, y posteriormente extensiones o
anexos vinculados a los usuarios creados. A continuacin se detalla y ejemplifican los dos pasos correspondientes a esta
configuracin.
2.1.- Usuarios:
Editar /etc/asterisk/sip.conf al final del archivo crear los usuarios correspondientes a cada anexo. A modo de ejemplo:
[usuario1]
type=friend
secret=1234
callerid="usuario1"
host=dynamic
nat=yes
allow=ulaw
context=anexos
2.2.- Anexos y Extensiones:
Editar /etc/asterisk/extensions.conf:
[default]
include =>
include =>
include =>
include =>

usuarios
externo
salida-analoga
mailbox

[anexos]

exten
exten
exten
exten

=>
=>
=>
=>

1001,1,Dial(SIP/usuario1,15,tT)
1001,2,Hangup
1002,1,Dial(SIP/usuario2,15,tT)
1002,2,Hangup

[mailbox]
exten => 501,1,VoiceMailMain()

;;Extensin que llama al correo de voz

[FXO]
include => IVR
[salida-analoga]
exten => _9.,1,Dial(Zap/1/${EXTEN:1}) ;; Salida a linea anloga
exten => _9.,2,Hangup

CONFIGURACION DE ASTERISK COMO CENTRAL DE LLAMADAS

1.- IVR MENU DE VOZ INTERACTIVO:
Un IVR es un men interactivo telefnico, la siguiente configuracin corresponde a un IVR base, el cual consiste en dar un
mensaje de bienvenida, y dar las opciones pre-grabadas en un archivo de sonido .gsm, guardado en asterisk-sounds/ Vale
destacar que este ejemplo, corresponde a la continuacin del archivo extensions.conf, configurado anteriormente.
[IVR]
exten
exten
exten
exten
exten
exten

=>
=>
=>
=>
=>
=>

s,1,Answer
s,2,Wait,0
s,3,Background(mensaje-inicio0)
s,n,Set(TIMEOUT(digit)=5)
s,n,Set(TIMEOUT(response)=10)
s,n,WaitExten

;; Contesta una llamada

;; Espera 0 segundos antes de continuar
;; Reproduce una opcin de IVR
;; Tiempo mximo para presionar un dgito
;; Tiempo mxima de respuesta
;; A espera de una extensin

De aqu en adelante se detallan como extensiones las funciones que

queramos que se procesen al presionar un dgito en el IVR. Es importante mencionar, que si este IVR incluye otro contexto
mediante include => , tambin sern validas las llamadas a anexos configurados en ese contexto.
exten
exten
exten
exten
exten

=>
=>
=>
=>
=>

1,1,Dial(SIP/1001,15,tT)
1,2,Voicemail(u1001)
1,3,HangUp
1,102,Voicemail(b1001)
1,103,HangUp

exten
exten
exten
exten
exten

=>
=>
=>
=>
=>

2,1,Dial(SIP/1002,15,tT)
2,2,Voicemail(u1001)
2,3,HangUp
2,102,Voicemail(b1001)
2,103,HangUp

2.- CREACION DE CASILLAS DE VOZ (VOICEMAIL)

2.1.- En la seccin [general] del archivo, pondremos los formatos que queramos que sean utilizados como medios de
grabacin, y a continuacin debemos ingresar el servidor de correo con el cual se comunicara Asterisk con nosotros
mediante E-Mail, en la mayora de las veces estas lineas existirn, por lo cual bastara con descomentarlas:
format=wav49|gsm|wav

;; Tambin puede incluirse otros formatos soportados

serveremail=asterisk

;; Esta opcin corresponde al servidor de correo a utilizar.

2.2.- Para crear casillas de voz, debemos editar /etc/asterisk/voicemail.conf y agregar en la seccion [default]:
numero-de-casilla => clave,Nombre,e-Mail,e-Mail2,attach=yes
3.-MUSICA EN ESPERA
Para poner msica en espera de manera personalizada, en formato mp3, dentro de algn contexto o de nuestro IVR,
debemos seguir los siguientes pasos:
3.1.- Editar el archivo /etc/asterisk/musiconhold.conf y crear su contexto:
[nombre]
mode=quitemp3
;; Modo de reproduccin de la msica
directory=/var/mp3/ ;; Ruta de la msica
3.2.- Editar /etc/asterisk/zapata.conf, y agregar en [channels] :
musiconhold=nombre
3.3.- Editar /etc/asterisk/extensions.conf y agregar en el contexto deseado:
exten => s,2,MusicOnHold(Default),5

3.4.- Para poder reproducir MP3 en MusicOnHold() en la instalacion de Asterisk, como ultimo paso hay que ejecutar el
siguiente comando:
$ make mpg123

4.- CONFERENCIAS CON MEETME

MeetMe() es una aplicacin Asterisk que nos permite realizar conferencias seguras, separadas por salas o rooms, y
protegidas por contraseas. Para configurar esta aplicacin debemos hacer lo siguiente:
4.1.- Editar /etc/asterisk/meetme.conf:
[rooms]
conf => 600

;; nombre-de-la-sala => numero de la sala

4.2.- Editar /etc/asterisk/extensions.conf:

exten => 1004,1,MeetMe(600,i,1234);;(sala,ingreso,contrasea para asignar)

4.3.- Elementos opcionales para agregar a extension.conf para ser utilizarlos con Meetme:
exten => 1005,1,Playback(conf-thereare)
exten => 1005,2,Playback(conf-peopleinconf)

Atribucin-NoComercial 2.0 (Chile)

Usted es libre de:

copiar, distribuir, exhibir, y ejecutar la obra

hacer obras derivadas
Bajo las siguientes condiciones:

Atribucin. Usted debe atribuir la obra en la forma

especificada por el autor o el licenciante.

No Comercial. Usted no puede usar esta obra con fines

comerciales.

Ante cualquier reutilizacin o distribucin, usted debe dejar claro a los otros los tminos de la
licencia de esta obra.
Cualquiera de estas condiciones se puede dispensar si usted obtiene permiso del titular de los
derechos de autor.

Sus usos legtimos u otros derechos no son afectados de ninguna manera por lo dispuesto
precedentemente.
Este es un resumen legible-por-humanos del Cdigo Legal (la licencia completa).
Limitacin de Responsabilidad

10