Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Asterisk Desconsola
Asterisk Desconsola
Ante cualquier reutilizacin o distribucin, usted debe dejar claro a los otros los
trminos de la licencia de esta obra.
Nada en esta licencia menoscaba o restringe los derechos morales del autor.
www.asterio.com.ar
Introduccin
ndice
Introduccin ......................................................................................... 4
Acerca de Asterisk Desconsolado.............................................................................................4
OpenSource en las comunicaciones............................................................................................4
Qu es PBX? .................................................................................................................................5
Asterisk: El PBX profesional........................................................................................................5
Configuracin........................................................................................ 7
Extensiones extensions.................................................................................................................9
Feature codes ...............................................................................................................................15
Configuraciones generales - general settings..........................................................................15
Rutas salientes - outbound routes ............................................................................................19
Troncales trunks..........................................................................................................................21
Lista negra Blacklist....................................................................................................................26
Fuentes de bsqueda de nombres de llamados Caller Name Lookup Sources. ................26
Agregar una fuente.....................................................................................................................26
Rutas entrantes - inbound routes..............................................................................................28
Follow me.....................................................................................................................................30
Colas queues................................................................................................................................32
DISA..............................................................................................................................................38
Grupos de extensiones - ring groups .......................................................................................39
Callback........................................................................................................................................41
Grabaciones de sistema - system recordings...........................................................................42
IVR - Digital Receptionist ..........................................................................................................42
Salas de conferencia - conferences............................................................................................44
Horarios - time conditions .........................................................................................................45
Misc destinations ........................................................................................................................47
PIN sets.........................................................................................................................................47
Gestin de usuarios - administrators ......................................................................................49
Msica en espera - music on hold ............................................................................................50
Herramientas ...................................................................................... 51
www.asterio.com.ar
Asterisk Desconsolado
Gestor Mdulos - Module admin. ............................................................................................52
Asterisk Logfiles..........................................................................................................................52
Asterisk API.................................................................................................................................53
Asterisk CLI. ................................................................................................................................53
Asterisk Info. ...............................................................................................................................55
Directorio telefnico. Asterisk Phonebook..............................................................................55
Backup & Restore........................................................................................................................56
PHP Info.......................................................................................................................................56
Sys Info. ........................................................................................................................................57
Java SSH. ......................................................................................................................................57
Edit Configuration. .....................................................................................................................57
phpMyAdmin..............................................................................................................................58
System Status...............................................................................................................................58
Informes ............................................................................................. 59
Flash Operator Panel........................................................................... 64
Grabaciones ........................................................................................ 79
Web MeetMe Control ........................................................................... 83
Funciones de llamada.......................................................................... 84
Miscelneos ........................................................................................ 88
Instalacin de un softphone. .....................................................................................................88
Tycho ............................................................................................................................................95
Putty..............................................................................................................................................96
WinSCP ........................................................................................................................................97
Glosario............................................................................................... 98
Eplogo .............................................................................................. 100
www.asterio.com.ar
Introduccin
Introduccin
Acerca de Asterisk Desconsolado.
Este no es un manual de Asterisk.
Asterisk Desconsolado, es un manual de las aplicaciones ms populares que sirven a la
administracin y uso de una central telefnica Asterisk. Estas aplicaciones, son las mismas que
se incluyen en las distribuciones de fcil instalacin ms populares de la comunidad Asterisk.
El manual est dispuesto de manera tal, que el orden del ndice le permite configurar las
prestaciones y servicios de Asterisk para tenerlo de manera completamente funcional.
www.asterio.com.ar
Asterisk Desconsolado
Lo que convierte a Asterisk en el sistema de comunicaciones que le permite lograr este
control y este nivel de prestaciones es la caracterstica de ser un sistema de cdigo abierto.
El cdigo abierto tiene la potencialidad de ser adaptable a cualquier necesidad. Con este
sistema usted puede lograr que todas las modificaciones que requieran ser aplicadas lo sean de
manera efectiva y a su justa medida, sin costos adicionales ni de mantenimiento. Cada
particularidad puede ser atendida sin restricciones de compatibilidad.
Contando con este sistema, usted podr conseguir llevar adelante las cientos de
comunicaciones de las ms variadas caractersticas, con los costos ms bajos que pueda
conseguir en el mercado mundial.
Desde llamadas internacionales IP, con una calidad de sonido impecable, conferencias,
monitoreo de llamadas, ingreso a la red celular de cualquier pas a costos locales, un sistema de
recepcionista virtual con men interactivo, hasta notificaciones de correo de voz personalizadas
transferencias personalizadas; asegurndose de no perder ninguna llamada importante estar
al corriente de cualquier eventualidad.
La caracterstica nica de Asterisk de ser de cdigo abierto, le permite adaptarlo a
cualquier sistema que ya est utilizando su empresa, ya sea una base de datos telfonos
virtuales, sin que su fabricante, modelo compatibilidad sean un inconveniente. Usted podr
integrar estos sistemas a su sistema de comunicaciones Asterisk de forma efectiva y funcional.
Qu es PBX?
Es la sigla para Private Branch eXchange. Es el sistema que conecta llamadas dentro de la
misma compaa. Comnmente puede tener desde dos a diez mil extensiones y una conexin al
sistema telefnico tradicional (PSTN) para llamadas hacia y desde el exterior de la compaa.
www.asterio.com.ar
Introduccin
www.asterio.com.ar
Asterisk Desconsolado
Configuracin
En este captulo se tratan todos los mdulos de FreePBX que sirven a la completa
configuracin de Asterisk.
Para acceder a FreePBX, abra un navegador Web y escriba la direccin IP que haya
configurado durante la instalacin seguida por /admin.
www.asterio.com.ar
Configuracin
Dashboard de FreePBX.
www.asterio.com.ar
Asterisk Desconsolado
Muchos de los trminos utilizados en los mdulos son expuestos tambin en ingls dada la
familiaridad que existe con ellos entre los usuarios que ya hayan administrado una PBX
tradicional anteriormente.
Extensiones extensions
Informacin.
Esta rea es para handsets, softphones, sistemas de pager o cualquier otra cosa que pueda
ser considerada una extensin del sistema clsico PBX.
Prefacio.
Definir y editar extensiones es probablemente la tarea ms comnmente realizada por un
administrador de PBX, como tal, usted estar muy familiarizado con esta pgina. Actualmente
existen cuatro tipos de dispositivos de soporte SIP, IAX2, ZAP y personalizado (custom).
Desde esta pgina, tambin se configura la casilla de mensajes (voicemail) asociada a la
extensin creada.
www.asterio.com.ar
Configuracin
www.asterio.com.ar
10
Asterisk Desconsolado
Extensin.
El valor ingresado en este campo debe ser
nico. Este es el nmero que puede ser
marcado desde otra extensin cualquiera,
directamente desde la recepcionista digital
(IVR), si est activado este mdulo. Este
nmero puede tener cualquier largo, pero
convencionalmente es utilizado un nmero de
tres cuatro dgitos.
Nombre asociado.
Esto es el texto del identificador de
llamada que se presenta a los que son llamados.
Debera ser cualquier lnea ISO8859-1( ASCII).
Pero aceptar UTF-8. Ntese que algunos
telfonos tendrn problemas con nombres de
varios bytes, por ejemplo los UTF-8,
posiblemente colapsando los telfonos. Si
utiliza nombres de varios bytes, experimente
cautelosamente.
SIP Alias
Direct DID
Aqu se coloca el nmero directo (PSTN o
VoIP) tal como es recibido por la central, al que
Parmetros a configurar en el caso de haber seleccionado un
se quiere asociar con este interno. Por ejemplo,
dispositivo SIP.
si tenemos una lnea con el nmero 11-55551234 y las llamadas a este que suenen
directamente en este interno, debemos colocar 1155551234.
11
www.asterio.com.ar
Configuracin
Music on Hold.
Esta opcin especifica que categora de msica usar este interno cuando necesite enviar
msica en espera a la parte llamante. Las categoras se configuran previamente en el mdulo
Music on Hold
Outbound CID
Debe ingresarse un valor con el formato Nombre <#########>. Este valor sobrescribir
el Caller ID de la lnea cuando este interno realice una llamada al exterior.
Ring Time
Aqu se configuran los segundos de espera antes de derivar al llamante al voicemail. La
opcin default toma el valor ingresado en el mdulo Configuraciones Generales.
Call Waiting
Permite activar o desactivar la funcin de llamada en espera para el interno que se est
creando. Esta funcin puede activarse o desactivarse posteriormente utilizando *70 o *71.
CID de emergencia.
El valor que se ingrese en este campo, sobrescribir todos los ajustes anteriores referentes a
la identificacin de llamada cuando se utilice una ruta saliente marcada como Llamadas de
emergencia.
Contrasea (secret).
Esta es la contrasea (password) utilizada por el dispositivo telefnico para autentificarse
al servidor de Asterisk cuando se crea una extensin SIP o IAX2. Esto es generalmente
configurado por el administrador antes de dar el telfono al usuario, y comnmente no
conocida por el usuario. Si el usuario esta utilizando un softphone, entonces necesita saber esta
contrasea para configurar el programa.
www.asterio.com.ar
12
Asterisk Desconsolado
Seleccionar el modo en que Asterisk intenta determinar si el origen de la llamda es de un
equipo de fax. Colocar Zaptel si el interno est vinculado a una lnea directa de protocolo Zap.
Si el interno est configurado para contestar llamadas originadas de troncales VoIP (SIP o IAX2)
colocar NVFax.
Aplicar privacidad.
Si la persona que llama no tiene identificador de llamada (nmero privado), se le pedir
que ingrese los 10 nmeros de su nmero telefnico.
Language Code.
Aqu puede especificar en idioma de los paquetes de sonido que Asterisk utilizar para este
interno. Por ejemplo, en para ingles, es para espaol, it para italiano, etc.
Grabacin entrante.
Opciones para grabar las llamadas recibidas en la extensin. Existen tres opciones:
Siempre
Nunca
A pedido (el usuario puede presionar *1 para activarlo durante cualquier llamada)
Grabacin saliente.
Funciona de la misma manera que el anterior, pero con llamadas salientes.
13
www.asterio.com.ar
Configuracin
Direccin de e-mail.
Las direcciones a las que el correo de voz (voicemail) enviar las notificaciones cuando
haya un nuevo correo almacenado.
Reproducir CID.
Reproduce el nmero que llam antes de reproducir el mensaje, e inmediatamente despus
anuncia la fecha y hora (envelope) en la que fue grabado el mensaje.
www.asterio.com.ar
14
Asterisk Desconsolado
Feature codes
Informacin.
Este mdulo permite personalizar los nmeros
que se deben marcar para acceder a las funciones de
Asterisk. Tambin pueden deshabilitarse funciones,
como por ejemplo, aquellas que puedan
comprometer la privacidad.
La descripcin detallada de estas funciones
puede encontrarse en el captulo funciones.
Configuraciones
generales general settings
Opciones de marcado.
o Opciones de marcado
Esta opcin habilita las diferentes opciones que el usuario podr utilizar para las llamadas
que reciba.
Las opciones ms comunes son Tr, que significa La persona que est recibiendo la
llamada puede transferirla usando # y Generar tonos de llamado cuando una extensin esta
llamando. Otras opciones utilizables son:
15
www.asterio.com.ar
Configuracin
Nota: esta lista es incompleta. La lista completa de opciones es enorme y puede ser vista
ingresando show application Dial en la consola de Asterisk.
Correo de voz.
o Segundos que los telfonos llamarn antes de enviar el llamado al correo de
voz.
Esto es razonablemente explicativo en s mismo, con la excepcin de que esta cantidad es
tambin utilizada para determinar la cantidad de tiempo en que cada telfono sonar en un
grupo de llamada en un grupo de nmeros asociados en la memoria del grupo de llamada.
Directorio de la empresa.
o Hallar usuarios en el Directorio de la empresa por...
Con esta opcin, se cambia la forma en la que Asterisk busca en el directorio de la empresa.
Cuando un usuario entra al directorio marcando *411 (o el cdigo que se haya establecido en el
www.asterio.com.ar
16
Asterisk Desconsolado
mdulo features codes) se le solicitar ingresar las tres primeras letras del nombre o apellido
de acuerdo a lo que se seleccione en esta opcin.
o Operator Extensin
Este campo viene completado con el nmero del operador del sistema (recepcionista).
Puede ser un nmero de interno, el de una cola o el de un grupo de internos.
Mquina de Fax.
o Extensin de maquina de fax para recibir faxes.
Seleccione sistema para que el sistema reciba y enve por correo electrnico los faxes. La
opcin deshabilitado hara que las llamadas entrantes sean atendidas ms rpidamente.
International Settings
o Country Indications
Son los tonos de ocupado, tono de llamada, llamada en espera adaptables a distintos
formatos internacionales. Simplemente seleccione el pas donde se encuentra.
Security Settings
o Permitir el ingreso de llamadas SIP annimas? (Allow Anonymous Inbound
SIP Calls)
Configurar esto en S (Yes) permitir que cualquier persona pueda llamar dentro de su
servidor Asterisk utilizando el protocolo SIP. Esto slo debera ser utilizado si usted comprende
completamente el impacto de permitir llamadas annimas dentro de su servidor.
17
www.asterio.com.ar
Configuracin
www.asterio.com.ar
18
Asterisk Desconsolado
o PIN set.
Esta opcin le permite seleccionar una de las configuraciones ya realizadas en el men
PIN set. De esta manera es ms simple administrar las contraseas. Si utiliza esta opcin, deje
en blanco en campo de contrasea de ruta.
o Msica en espera.
Es posible seleccionar la categora de msica que se desea reproducir al momento en que se
active la msica en espera en una llamada que haya sido generada a travs de esta ruta. El
objetivo de esta funcin sera dar la posibilidad de reproducir mensajes publicitarios en el
idioma del pas (o grupo de paises) al que se est llamando.
19
www.asterio.com.ar
Configuracin
o Patrones de marcado.
Un patrn de discado es una serie nica de dgitos que seleccionar esta troncal. Ingrese un
patrn de discado por lnea.
Reglas:
X
1237-9
|
Separa los prefijos de marcado del nmero a marcar. Por ejemplo, 9|NXXXXXX
equivaldr cuando alguien marque 95551234 pero slo enviar 5551234 a la troncal.
000
9|911
Slo usa esta ruta si el usuario ha marcado 9911 pero quita el primer nueve
antes de enviarlo a la troncal.
0|.
o Secuencia de troncales.
Cuando esta ruta es reconocida por el patrn de discado anteriormente mencionado, la
central intenta realizar la llamada usando las troncales en el orden en que sean seleccionadas en
este punto. Obsrvese que si usted tiene una troncal protegida por una contrasea, y el usuario
ingresa mal la contrasea, no intentar continuar a la siguiente troncal. Asegrese de haber
seleccionado agregar (add) despus de haber agregado la troncal, y antes de haber
seleccionado enviar cambios (submit).
www.asterio.com.ar
20
Asterisk Desconsolado
Troncales trunks
Las Troncales son lo que se utiliza para llevar una varias llamadas a un VSP (VOICE
SERVICE PROVIDER) a algn dispositivo que responda al nmero que se marc (por
ejemplo, otro Asterisk o la PSTN). Existen cinco tipos de Troncales:
ZAP (lneas analgicas)
21
www.asterio.com.ar
Configuracin
IAX2 (Inter Asterisk)
SIP (Session Initiation Protocol)
ENUM
Personalizada (Custom trunk)
Todas las troncales son configuradas de la misma forma
o Canales mximos.
Esto limita el nmero mximo de canales (llamadas simultneas) que pueden ser usados
por esta troncal, llamadas entrantes y salientes. Djelo en blanco para no especificar el mximo.
[1237-9]
|
Quita un prefijo de discado del nmero (por ejemplo: 613|NXXXXXX
equivaldr cuando alguien marque 61335551234, pero slo ingresar en la troncal 5551234)
+
Suma un prefijo de discado al nmero marcado (por ejemplo: 1613+NXXXXXX
equivaldr cuando alguien marca 5551234 e ingresar a la troncal como 16135551234)
Si usted est configurando una troncal SIP que le pide usar el prefijo 011 para las llamadas
internacionales y ninguno para las llamadas a Estados Unidos y Canad (001XXXXXXXXXX),
debera configurar estas dos reglas:
011+N
www.asterio.com.ar
22
Asterisk Desconsolado
1|.
La primera, agrega el prefijo 011 a todos los nmero pasados por una Ruta saliente (que
debe quitar el 00 antes de pasar el nmero a la trocal) que inicie con un nmero del 2 al 9.
La segunda, quita el 1 (cdigo internacional de Estados Unidos y Canad) del nmero
pasado por la ruta saliente.
auth
context
Si type est fijado en user, es el contexto para las llamadas
entrantes. Si est fijado en peer, es el contexto para las llamadas salientes. Si type=friend, es
el contexto para llamadas entrantes y salientes.
host
Es cmo la central busca al servidor del VSP contratado. Los valores
posibles son dynamic, hostname o direccin ip.
insecure
Especifca como manejar la conexin con el otro punto. Los valores
posibles son: very, yes, no, invite, port.
port
secret
Si Asterisk est actuando como un cliente de un servidor SIP remoto,
en secret colocamos la contrasea que usar para autenticarse.
23
www.asterio.com.ar
Configuracin
type
Relacin de la central con el servidor o cliente remoto. Los valores
posibles son: user, peer o friend.
username
o Cadena de registro:
La mayora de los VSP requieren que la central se registre con el servidor. Los parmetros y
forma de los registros es suministrado por el proveedor. En general, suelen tener un formato
similar a este:
nombre_de_usuario:contrasea@servidor
o Troncal personalizada.
Si usted est usando H323, Chan, capi cualquier otro tipo de troncal no estandarizada,
usted puede configurar la lnea de marcado para ser usada con este tipo de troncal,
reemplazando el nmero a ser marcado con $OUTNUM$, por ejemplo:
CAPI/XXXXXXXX/$OUTNUM$/b
Usted puede identificar grupos CAPI controles individuales usando gX ContrX
H323/$OUTNUM$@XXX.XXX.XXX.XXX:XXXX
vpb/1-1/$OUTNUM$:
www.asterio.com.ar
24
Asterisk Desconsolado
25
www.asterio.com.ar
Configuracin
26
Asterisk Desconsolado
http: ejecuta una direccin de Internet que pasa variables usando el mtodo GET
pasando el nmero llamante como el contenido de una variable para recuperar el nombre
correcto.
MySQL: Se genera una consulta a la base de datos MySQL para recuperar el nombre
del llamante.
o Cache results
Decide si guardar no los resultados en la base de datos de Asterisk; sobrescribir los
valores presentes al momento de guardar. No afecta el comportamiento de la fuente interna.
http
Host: Nombre de Host direccin IP.
Port: Puerto de escucha http.
Username: Nombre de usuario para la autenticacin http.
Pasword: Contrasea para utilizar en la autenticacin http.
Path: Ruta del archivo que recibe las variables. Ejemplo: /cidlookup.php
Query: Cadena de la consulta donde [NUMBER] es reemplazado por el nmero del
llamate. Por ejemplo: number=[NUMBER]&source=crm.
27
www.asterio.com.ar
Configuracin
o Nmero de DID.
Para un SIP un par IAX2, este es
normalmente su nmero de cuenta. Si su
cuenta es 888123123 ingresar esto ah
reconocer llamadas de ese proveedor. Si lo
deja en blanco reconocer todas.
www.asterio.com.ar
28
Asterisk Desconsolado
o Email del fax.
Se usar la direccin de mail ingresada si se selecciona system en extensin del fax. Si
deja este campo en blanco, freePBX usar la configuracin establecida en configuraciones
generales.
Privacidad.
o Aplicar privacidad.
Si el nmero que llama no tiene Caller ID (un nmero privado), esta opcin preguntar a la
persona que llama que introduzca los 10 dgitos de su nmero de telfono. Tendr tres intentos.
o Music on Hold?
Puede seleccionar alguna de las categoras de msica de espera creadas en el mdulo
Music On Hold de FreePBX.
o Signal RINGING
Algunos dispositivos o proveedores, requieren una seal de llamada antes de poder
contestar. Notar que esto ocurre si pasa la llamada que est entrando a un telfono, pero si la
deriva a un IVR, la llamada no ser conectada.
Opciones.
o Sonido de alerta.
La informacin de alerta puede ser usada para un tono de llamada distintivo con ciertos
dispositivos SIP. Los nombres estndar son Bellcore-dr1 a Bellcore-dr7. Algunos telfonos
pueden utilizar una direccin URL de un archivo WAP MP3.
29
www.asterio.com.ar
Configuracin
Follow me
Prefacio.
La configuracin de follow me es
como un mini grupo de extensiones, pero
esta ligada directamente a una extensin. Se
configura de la misma manera en la que se
configura un grupo de extensiones,
incluyendo la prestacin de anunciar a la
persona que llama que est siendo
transferida a otra parte.
El plan de marcado ha sido
estructurado de tal forma que de cualquier
lugar desde el cual se pueda llamar a una
extensin, el grupo de llamado de rastreo
ser activado si es definido de esa manera.
Esto significa que desde una llamada
entrante por el IVR desde afuera
internamente, cuando usted marque una
extensin se llegar al grupo de llamado en
lugar de la extensin. Este comportamiento
es activado simplemente incluyendo el
contexto ext-findmefollow delante del
contexto ext-local en cualquier lugar en
que la extensin es marcada.
Existen otros usos para la funcin de
follow me. Como algo simple, puede
ingresar en la extensin del rastreo una
opcin para ir al correo de voz si no es
respondida la llamada. La diferencia es que
as se puede variar el tiempo de llamado,
introducir un anuncio, ir a otro correo de
voz si el destino no es alcanzado, puede
agregar mltiples nmeros y estrategias de
llamado, para cuando esa extensin sea
solicitada.
El lugar donde la funcin de rastreo no
es prioritaria es cuando la extensin local es
seleccionada como un destino explcito
Configuracin de follow-me para la extensin 416.
desde varias pantallas. En ese caso, el
destino est siendo enviado a ext-local y no ser interceptada por el contexto ext-findmefollow.
Para configurar follow me, haga clic en alguna de las extensiones ya creadas que
aparecen a la derecha de la pantalla.
30
Asterisk Desconsolado
o Initial Ring Time:
En este campo se elige la cantidad de segundos que sonar el primer nmero de la lista
follow-me si aplica a la estrategia de llamada seleccionada.
o Listado de extensiones.
Aqu se agregan uno por lnea, los nmeros que se quiere hacer sonar. Si se ingresa un
nmero externo, debe agregarse el signo # al final.
o Estrategia de ring.
Ringallv2: Llama al primer nmero de la lista durante el tiempo establecido en Initial
Ring Time. Luego, llama a los dems nmeros ingresados por el tiempo fijado en Ring Time.
Ringall: Llama a todos los canales disponibles al mismo tiempo hasta que alguno conteste.
Hunt: toma turnos llamando a cada extensin disponible.
Memoryhunt: Llama a la primera extensin, luego a la primera y a la segunda, luego a la
primera y a la segunda y a la tercera, y as sucesivamente.
firstavailable: Llama solo al primer nmero disponible.
firstnotonphone: Llama solo al primer nmero que no se encuentre en estado off-hook
(descolgado), ignorando la funcin de llamada en espera.
*-prim: Las variantes indicadas con la terminacin prim, se comportan del siguiente
modo:
Si el primer nmero de la lista est ocupado, los dems sern ignorados.
Si el primer nmero posee la funcin DND activada, se aplicar a los dems nmeros y por
lo tanto, no sonar ninguno.
Si el primer nmero tiene configurada la funcin de redireccin de llamada incondicional,
se llamar a todos los nmero ingresados en la lista.
o Announcement.
El sonido seleccionado de esta lista (previamente cargado en el mdulo Grabaciones del
Sistema) ser reproducido antes de marcar los nmeros de la lista.
31
www.asterio.com.ar
Configuracin
o Sonido de alerta.
La informacin de alerta puede ser usada para un tono de llamada distintivo con ciertos
dispositivos SIP. Los nombres estndar son Bellcore-dr1 a Bellcore-dr7. Algunos telfonos
pueden utilizar una direccin URL de un archivo WAP MP3.
o Confirm Calls?
Activar esta opcin si se ingresaron a la lista follow-me nmeros que necesiten ser
confirmados. La persona llamante deber presionar 1 para que la llamada pueda ser realizada.
Esta funcin puede ser til para evitar el final inesperado del follow-me producido por la casilla
de mensajes de un celular.
o Remote Announce.
El sonido seleccionado ser reproducido a la persona que recibe la llamada si Confirm
Calls est activado.
o Too-Late Announce.
El sonido seleccionado ser reproducido a la persona que recibe la llamada si la llamada es
aceptada antes de que haya presionado 1.
Colas queues
Prefacio.
Las colas le permiten
administrar un gran nmero de
llamadas entrantes, como es de
esperarse en un call center en un
contact center. Esta es una
aplicacin muy completa, y como
tal, tiene muchas opciones de
configuracin.
Aadir cola.
o Cola nmero.
Este es el nmero a ser marcado desde cualquier extensin para ser ubicado en una cola.
Este tambin es el nmero que se usar para seleccionar un destino. Los agentes (las personas
que reciben las llamadas) ingresan y salen de las colas marcando el nmero, entonces, un slo
asterisco para ingresar y dos para salir (Ejemplo: 700* para ingresar y 700** para salir de la cola
700)
www.asterio.com.ar
32
Asterisk Desconsolado
o Nombre de la cola.
Un pequeo nombre para la cola. Esto es nicamente utilizado en la interfase de la web
para una simple identificacin.
o Miembros estticos.
Los miembros estticos son extensiones que se asume que siempre estarn en la cola.
Dichos miembros no necesitan ingresarse a la cola y tampoco se les permite salir de ella.
Se debe ingresar una extensin por lnea. Tambin es posible ingresar un nmero externo,
de ser as, es necesario contar con una ruta de salida vlida para dicho nmero.
33
www.asterio.com.ar
Configuracin
o Mximo de llamadas.
El nmero mximo de llamantes que se permite que esperen en la cola. Si este nmero es
alcanzado, cualquier persona que llegue despus ser enviado a destino en caso de no ser
atendido.
www.asterio.com.ar
34
Asterisk Desconsolado
o Estrategia de ring.
Existen seis patrones de llamado para elegir.
ringall (sonar todos): Llamar a todos los agentes hasta que uno responda (preestablecida)
Round Robin: Toma turnos llamando a cada agente disponible.
leastrecent (menos reciente): Llama al agente que atendi una llamada de esta cola por
ultima vez.
fewestcalls (menor cantidad de llamadas): Llama al agente que complet la menor
cantidad de llamadas de esta cola.
random (al azar): Llama a cualquier agente de la cola indistintamente.
rrmemory (Round Robin con memoria): toma turnos llamando a cada agente disponible,
recordando desde dnde dej de llamar en adelante.
o Reintentar.
La cantidad de segundos de espera antes de hacer sonar todos los telfonos nuevamente.
o Tiempo de wrap-up.
Despus de una llamada realizada con xito, la cantidad de segundos a esperar antes de
enviar a un agente libre otra llamada. La cantidad preseleccionada es cero Intente dejarlo en
treinta segundos.
o Grabacin de llamada.
Las llamadas entrantes a los agentes son grabadas. Son grabadas en
/var/spool/asterisk/monitor.
o Anunciar posicin.
Seleccione si (yes) para anunciar la posicin de la llamada en la cola a la parte llamante.
35
www.asterio.com.ar
Configuracin
Periodic Announcements
o IVR Break Out Menu.
El men de IVR seleccionado en esta opcin, ser reproducido en los intervalos indicados
en repeat frequency para servir como va de salida a la cola. Por ejemplo, podra seleccionarse
un IVR que diga la frase si no desea seguir esperando, marque su nmero telefnico y un
representante se comunicar con usted tan pronto como sea posible.
o Repeat frequency.
Es el intervalo de tiempo en que ser reproducido el IVR seleccionado en la opcin anterior.
o Anuncio al unirse.
Este anuncio es reproducido a los llamantes antes de ingresar a la cola. Estas grabaciones
son manejadas desde el las grabaciones del sistema.
www.asterio.com.ar
36
Asterisk Desconsolado
37
www.asterio.com.ar
Configuracin
DISA
Prefacio.
DISA (Que es la sigla de Direct Inward
System Access) le permite proveer un tono de
discado interno a llamantes externos. Cuando
usted configura un destino DISA, usted puede
usarlo como un men de destino de una
recepcionista digital, para poder obtener un
tono de discado interno de Asterisk. Esto
significa que usted podra llamar a su Asterisk
y hacer una llamada desde el mismo Asterisk
como si usted estuviera utilizando una
extensin conectada con el mismo Asterisk
dentro de la empresa.
Simple configuracin de una cuenta DISA.
Aadir DISA
o DISA name.
Un nombre familiar para identificar el destino DISA fcilmente.
o PIN.
Una contrasea que es solicitada al llamante para acceder al tono de marcado. Usted
debera siempre solicitar una contrasea con el propsito de mantener la seguridad. Usted
puede, si debe, dejar esto en blanco. El anuncio solicitar la clave, pero no necesitar ingresarla.
o Digit timeout.
Es la mxima cantidad de tiempo permitida entre dgitos que el llamante tiene cuando est
marcando un nmero.
www.asterio.com.ar
38
Asterisk Desconsolado
o Contexto (Context):
De forma preestablecida se utiliza from-internal. Usted puede proveer un contexto
personalizado para limitar el acceso a DISA (solo para usuarios experimentados).
39
www.asterio.com.ar
Configuracin
o Listado de extensiones.
Lista las extensiones a llamar, una por
lnea. Usted puede incluir una extensin en
un sistema remoto, un nmero externo
mediante el sufijo de un nmero con un
numeral (#). Ejemplo: 2448089# marcar
2448089 en la troncal apropiada.
www.asterio.com.ar
40
Asterisk Desconsolado
Callback
Informacin.
Esta opcin consiste en llamar a un nmero que haya intentado previamente comunicarse
con la empresa. La central devuelve el tono de ocupado a la llamada entrante y pasados los
segundos fijados en delay before callback marca el nmero ingresado en callback number
para establecer la comunicacin anteriormente intentada por el llamante.
Una vez configurado el mdulo, es necesario crear una ruta de entrada para que desve el
nmero del llamante al callback configurado.
Esta funcin puede ser til para el ahorro en llamadas a telfonos mviles.
41
www.asterio.com.ar
Configuracin
IVR
Prefacio.
La pgina de la recepcionista digital (IVR)
es la interfase utilizada para configurar su autorespuesta cuando las personas llaman a su
empresa a su hogar. Normalmente se escucha
algo como Gracias por llamar a (como sea que
se llame su compaa), para ventas marque uno,
para servicios marque dos, etc.
Cuando usted selecciona IVR, la primera
pgina es una pequea serie de instrucciones
sobre como manejarlo. Usted puede, si bien,
editar el IVR existente, crear uno nuevo
presionando en Aadir IVR(Add IVR).
Editar men.
Ejemplo de configuracin de un IVR.
o Change name.
Este es el ttulo descriptivo que aparece a la derecha, y en el men de Destinos.
o Timeout.
Esto es la cantidad de tiempo que el sistema espera antes de enviar la llamada al destino t.
o Enable directory.
Si usted activa esto, los usuarios sern capaces de marcar el cdigo de prestaciones para el
directorio desde el IVR y acceder al servicio de directorio (ver Cdigo de funciones
www.asterio.com.ar
42
Asterisk Desconsolado
o Enable direct dial.
Si usted activa esto, los usuarios adems de poder discar las opciones del IVR, sern
capaces de discar directamente un nmero de extensin.
o Anuncio:
Un sonido previamente agregado en grabaciones de sistema que es reproducido a los
usuarios cuando ingresan en el IVR. Esto puede ser configurado en nada.
Opciones de su IVR.
En el casillero a la izquierda, ingrese el nmero de opcin para el usuario. Esto puede ser
uno, una serie de nmeros.
i: Esto es el destino usado cuando un llamante ingresa una opcin invlida Si usted slo
tiene 1;2 y 3 definidos, y el llamante pulsa 4, lo llevar a este destino i. La opcin predefinida
para esto, si usted no ingresa ningn destino i, es repetir el presente men. Si llegan al destino
i ms de tres veces, la llamada es desconectada.
t: Este es el destino utilizado cuando se supera el tiempo fuera. Usted puede preferir que
este destino vaya a un operador, el en caso que el llamante no tenga un telfono DTMF. As
como i, la opcin predefinida es repetir el men, y si ha sido repetido tres veces, la llamada es
desconectada.
Obsrvese que con FreePBX 2.1 Destinos son slo mostrados si al menos hay una entrada
creada. Por ejemplo, si usted no ha creado ninguna cuenta DISA, esta opcin, no aparecer en
Destinos.
El resto de la pgina es bastante clara. Use Incrementar opciones (Increase Options) o
Disminuir opciones (Decrease Options) para alterar el nmero de opciones disponibles. Esto
no va a permitirle descender a menos del nmero de opciones actualmente disponibles.
Para borrar una opcin, simplemente deje la seccin en blanco.
Cuando termine, haga clic en Guardar (Save).
43
www.asterio.com.ar
Configuracin
Add Conference.
Detalles de la conferencia.
o Nmero de la sala.
Este es un nmero que los usuarios
locales pueden marcar para incluirse en la
conferencia.
o Nombre de la sala
Esto es usado como un identificador,
junto con el nmero, cuando se selecciona
una conferencia como destino.
o PIN de usuario.
Si cualquiera de estas opciones estn
activadas, cualquiera que llame a la
conferencia le ser requerida una contrasea
PIN. Si el user es dejado en blanco, el
usuario slo debe presionar # para
Creacin de una sala de conferencias
ingresarse a la conferencia. El nico uso de
admin es no abrir una conferencia hasta
que el administrador halla llegado. Si la msica en espera est activada, los usuarios sern
puestos en espera con una reproduccin de la msica hasta ese momento.
Opciones de la sala.
o Mensaje de entrada
Este es un sonido que escucharn los conferencistas al ingresar
o Esperar administrador.
Cuando existe un PIN de administrador, la conferencia no comenzar hasta que el
administrador ingrese. Vea el punto PIN del moderador..
www.asterio.com.ar
44
Asterisk Desconsolado
o Modo silencio.
Generalmente un bing es reproducido cuando un usuario ingresa sale de la
conferencia. Usted puede desactivarlo seleccionando si (Yes) aqu.
o Cuenta de usuarios
Cuando alguien ingrese, la conferencia dir they are (nmero de conferencistas) people in
this conference.
o Aviso entrada/salida.
Cuando alguien ingrese a la conferencia, le ser requerido que grabe su nombre. La
conferencia lo anunciar cuando ingrese y cuando salga, por nombre.
o Msica en espera
Activa desactiva la msica en espera en esta conferencia.
o Permitir men
Le permite al usuario administrador ingresar a la administracin de la conferencia
presionando *. Los comandos en el modo de administracin son:
1: Silenciarse.
4 6: Aumentar disminuir, respectivamente, el volumen de la conferencia.
7 9: Aumentar disminuir, respectivamente, el volumen de su voz.
2: Traba destraba la conferencia.
3: Expulsa la ltima persona que se uni a la conferencia.
45
www.asterio.com.ar
Configuracin
Destinos.
Usted tiene una eleccin sobre qu
destinos alcanzar, dependiendo de si el
tiempo es reconocido no. Usted puede
encadenar las condiciones de tiempo para
lograr un efecto de adicin exclusin.
o Ejemplo de exclusin.
Supongamos que usted quiere que el
IVR1 funcione de Lunes a Viernes de 9am a 5
pm, los Sbados de 9am a 12pm y el resto
de los das que funcione el IVR2.
o Ejemplo de adicin
Dentro de 9am y 5pm de Lunes a Mircoles, eljase IVR 2, de otra forma eljase IVR 1.
www.asterio.com.ar
46
Asterisk Desconsolado
Misc destinations
Prefacio.
Los destinos miscelneos le permiten usar cualquier cosa que marque desde una extensin
estndar como un destino.
Ejemplo
Si usted quiere hablar con Juan, quizs prefiera tener una opcin en el IVR que sea Si
quiere hablar con el celular de Juan puede hacerlo marcando 2 y tener un destino miscelneo
de:
Celular de Juan
91554545454 (Observe el 9 delante, como si estuviera haciendo una llamada externa)
Entonces, en el men del IVR, usted selecciona Celular de Juan como un destino, y se
conectar la llamada.
PIN sets
La configuracin de contraseas es un mdulo que le permite usar un rango de contraseas
en lugar de slo una. Esto es nicamente utilizable por las troncales, pero puede ser usado en
DISA en cualquier otra cosa que requiera el uso de contraseas para la autentificacin.
47
www.asterio.com.ar
Configuracin
www.asterio.com.ar
48
Asterisk Desconsolado
Restricciones de acceso.
o Rango de la extensin.
Cuando un usuario est en el sistema, ellos slo vern el rango especificado aqu. Esto es
prctico si usted est configurando muchos ocupantes en el sistema.
49
www.asterio.com.ar
Configuracin
o Administrar accesos.
Esta es una seccin de mltiples accesos. Usted puede seleccionar el rango de reas a los
que les est permitido a los usuarios acceder presionando control ( apple si es mac) y
seleccionarlos de forma individual, arrastrando el Mouse hasta la lista de los cuales usted
quiere darle acceso.
Subiendo un archivo.
Sencillamente seleccione examinar y seleccione un archivo MP3 en sus sistema.
Entonces seleccione Subir. Aparecer en la lista de MOH (Music on hold).
www.asterio.com.ar
50
Asterisk Desconsolado
Herramientas
51
www.asterio.com.ar
Herramientas
Asterisk Logfiles.
Muestra las ltimas dos mil lneas del archivo log ubicado en la carpeta
/var/log/asterisk. En este archivo se guardan acciones generales realizadas por las extensiones
y las llamadas entrantes. Tambin registra los errores que pueden inducir a un
malfuncionamiento, en el caso de encontrarse con un error, es una bitcora de la funcionalidad.
www.asterio.com.ar
52
Asterisk Desconsolado
Asterisk API.
Este mdulo nos permite configurar los permisos para las conexiones de algunos
programas al Asterisk Manager.
Asterisk manager permite que ciertos programas puedan conectarse a una instancia
Asterisk para ejecutar comandos o leer eventos a travs de un stream sobre TCP/IP. Las
conexiones de los programa cliente se realizan mediante un usuario y contrasea. La
configuracin de estas conexiones se encuentra en el archivo /etc/asterisk/manager.conf.
Asterisk CLI.
Esto le permite correr comandos como si fueran ingresados en el Asterisk CLI (command
line interface). Puede accederse con el comando asterisk r desde la consola de linux.
o Comandos generales.
sip shows peers: Esto muestra todos los dispositivos SIP, y su estado, de acuerdo a
Asterisk.
show channels: Muestra todos los canales que estn en uso en el momento.
soft hangup <channel> 1 : Corta el canal especificado. El corte se producir cuando el
controlador vuelva a interactuar sobre el canal.
restart gracefully: Deja de recibir llamadas, espera que el volumen de llamadas se vace y
reinicia Asterisk.
!<command>: Ejecuta el comando indicado.
abort halt: Cancela el apagado del equipo.
add extension <exten>,<priority>,<app>,<app-data> into <context>: Agrega una nueva
extensin dentro de un contexto.
add ignorepat <pattern> into <context>: Agrega una regal ignorada en un contexto.
debug channel <channel>: Realiza un debug sobre el canal especificado.
dont include <context> in <context>: Quita un contexto incluido de otro contexto.
help: Muestra una lista de los comandos con una breve descripcin.
include <context> in <context>: Incluye un contexto en otro contexto.
load: Carga un modulo dinmico por nombre.
logger reload: Vuelve a abrir los archivos log (ver apartado Backup and Restore).
logger rotate: Rota y vuelve a abrir los archivos log.
no debug channel <channel>: Deshabilita el depurador sobre el canal especificado.
1 Los valores indicados entre los smbolos < > representan las variables con las que los
comandos trabajan. Por ejemplo cuando se lee soft hangup <channel> Channel se
reemplaza por el nmero del canal sobre el que se quiere trabajar.
53
www.asterio.com.ar
Herramientas
pri debug span <span>: Habilita el depurador sobre el span indicado.
remove extension exten@context [priority]: Remueve una extensin del contexto
especificado. Si se indica la prioridad, solo ella es eliminada de la extensin.
remove ignorepat <pattern> from <context>: Remueve una extensin ignorada de un
contexto especfico.
save dialplan: Sobrescribe el archivo extensions.conf con una versin tomada de la actual
configuracin de su plan de marcado. No hace una copia de sus archivos modificados. Los
valores inicales de las variables globales definidas en la categora [globals] retienen sus valores
iniciales previos; los valores corrientes de las variables globales ahora estn escritas en el nuevo
extensions.conf. Al utilizar save dialplan tendr como resultado la prdida de cualquier
comentario en su actual extensions.conf.
core set verbose <level>: Configura el nivel de mensajes verbales a ser mostrados. 0
significa que ningn mensaje debe ser mostrado. En el inicio es el equivalente a -v[v[v...]].
show agents: Muestra el estado de los agentes configurados en el archivos agents.conf de la
carpeta /etc/asterisk.
show applications: Muestra la lista completa de las aplicaciones.
show application <application>: Describe a la aplicacin especificada.
show channel <channel>: Muestra informacin sobre el canal especificado.
show channels: Muestra informacin sobre los canales activos.
show codecs: Muestra informacin sobre los codecs disponibles.
meetme: Devuelve una lista de las conferencias en uso.
show dialplan: Muestra el plan de marcado (dialplan).
show hints: Muestra la lista completa de extensiones indicando en que estado se
encuentran.
show manager commands: Muestra una lista de los comandos de Asterisk.
show manager connect: Expone la lista de los usuarios administradores conectados.
show parkedcalls: devuelve una lista de las llamadas estacionadas.
show queues: Devuelve la lista de las colas con un detalle de la configuracin de cada una.
show voicemail users: Muestra una lista de las casillas de correo de voz definidas.
show voicemail zones: Muestra la lista de la zona de los formatos de mensaje. El formato
de los mensajes est relacionado con la zona geogrfica del origen de este mensaje. Si alguien en
un distinto huso horario le enva un mensaje, Asterisk tiene la capacidad de transformar el
horario en relacin a la diferencia de husos horarios.
54
Asterisk Desconsolado
show uptime: Devuelve el tiempo transcurrido desde el ultimo inicio del sistema.
show version: Devuelve informacin sobre la versin instalada de Asterisk.
Asterisk Info.
Muestra la informacin de Asterisk, como por ejemplo: Versin de Software, uptime del
sistema, canales activos, extensiones, troncales SIP y usuarios de correo de voz (voicemail), etc.
55
www.asterio.com.ar
Herramientas
o Correr programacin.
Usted puede elegir una programacin pre-configurada desde el men de seleccin,
configurar su propia programacin utilizando minutos, horas, das, meses y fines de semana
desde la casilla de seleccin. Las opciones pre-configuradas son: Diario (al medioda), Semanal
(Domingo Sbado), Mensual (En el primero de cada mes a la medianoche) Anual (el en
primero de Enero a la medianoche).
PHP Info.
Muestra la informacin sobre el mdulo de PHP instalado en el equipo.
www.asterio.com.ar
56
Asterisk Desconsolado
Sys Info.
Muestra informacin completa sobre el sistema. Es importante controlar el espacio en el
disco y el uso de la memoria en forma peridica para prevenir un malfuncionamiento del
sistema.
Java SSH.
Muestra la consola del Asterisk en un navegador web en forma segura.
Edit Configuration.
La forma en que Asterisk deba trabajar est regulada por una serie de archivos de texto.
Estos archivos guardan la informacin de las extensiones, colas, IVR y hasta de la configuracin
del hardware.
Esta herramienta permite editar los archivos de configuracin ubicados en cuatro carpetas
sin la necesidad de utilizar programas como el putty (ver apartado) o el vi desde la consola.
Estas carpetas son:
/etc/asterisk: Contiene los archivos de configuracin del hardware y del plan de marcado.
/var/www/html/panel: Contiene los archivos para manejar el FOP.
/etc: Contiene los archivos de la configuracin del sistema en general.
/tftpboot: No contiene archivos por el momento.
57
www.asterio.com.ar
Herramientas
Luego de editar alguno de estos archivos, es necesario hacer clic en re-read configs para
que los cambios hagan efecto.
phpMyAdmin.
Es una interfaz grfica web para administrar de forma sencilla la base de datos MySQL.
Sitio oficial: http://www.phpmyadmin.net
System Status.
Muestra el tiempo transcurrido desde el ltimo inicio del sistema. Permite adems reiniciar
el sistema (reboot) o apagarlo (shutdown).
www.asterio.com.ar
58
Asterisk Desconsolado
Informes
Asterisk guarda un registro llamado CDR (Call Detail Record) de todas las comunicaciones
efectuadas a travs del sistema, en la base de datos asteriskcdrdb, a la cual es posible acceder
utilizando phpMyAdmin (ver captulo anterior).
La tabla cdr cuenta con los siguientes campos:
59
Informes
Dentro del mdulo de informes se accede a un programa amigable que permite visualizar
la informacin contenida en esta base de datos dando la posibilidad de aplicar distintos filtros a
fin de devolver solo el registro de llamada relevante a su bsqueda.
Filtros
Los filtros se aplican a fin de acotar el resultado de una bsqueda, facilitando de esta
manera la confeccin de estadsticas que ayudarn a controlar el uso y costo de las
comunicaciones.
o Destination
Toma la informacin realizada solo al destino ingresado. Hay cuatro maneras distintas de
buscar el nmero ingresado:
Exact: Devuelve los registro de la base de datos que coincidan con el nmero
ingresado.
Begins with: Devuelve los registros cuyo destino comienza con el nmero
ingresado. Por ejemplo, para conocer el caudal de llamadas a celulares, basta
ingresar 915 seleccionando esta opcin.
Contains: Realiza la bsqueda en la base de datos, devolviendo los registros
cuyo nmero de destino contenga el nmero ingresado.
Ends with: Realiza la bsqueda en la base de datos, devolviendo los registros
cuyo nmero de destino finalice igual al nmero ingresado.
www.asterio.com.ar
60
Asterisk Desconsolado
o Source
Toma la informacin de las comunicaciones realizadas por el nmero ingresado. Ya sea
interno no.
o Channel
Devuelve solo las llamadas efectuadas desde y hacia el canal especificado.
o Duration
Devuelve un informe sobre las comunicaciones efectuadas en relacin con la duracin. Se
pueden filtrar las llamadas respecto a la cantidad de minutos de comunicacin para buscar
llamadas en particular.
Mdulos
Esta aplicacin tiene cuatro mdulos distintos que organizan la informacin de acuerdo a
diferentes parmetros.
o Call Logs
Devuelve la informacin detallada de las comunicaciones efectuadas de acuerdo a los
filtros aplicados a la bsqueda, en forma de tabla. Las columnas de fecha, nmero marcado y
tiempo de conversacin pueden ordenarse de manera ascendente descendente haciendo clic
en el ttulo de la columna.
La columna APP ofrece la posibilidad de visualizar el nombre de usuario del nmero de
destino. Para configurarla, es necesario editar el archivo defines.php ubicado en la carpeta
/var/www/html/admin/cdr/lib y copiar la lnea de cdigo que se muestra a continuacin las
veces que sea necesario.
$appli_list['numero]=array("nombre");
o Compare Calls
Devuelve un grfico que agrupa las comunicaciones efectuadas en dos ejes, el vertical
representa la cantidad de llamadas y el horizontal el horario en que fueron realizadas las
llamadas. Cada lnea representa un da.
61
www.asterio.com.ar
Informes
o Monthly Trafficc
Devuelve un grfico en forma de torta que representa el tiempo de comunicacin segn los
filtros aplicados, en relacin a los meses seleccionados.
o Daily Load
Devuelve un grfico en forma de barras que representa la cantidad de comunicaciones
efectuadas por hora a lo largo del da seleccionado.
www.asterio.com.ar
62
Asterisk Desconsolado
63
www.asterio.com.ar
Canales estacionados
www.asterio.com.ar
64
Asterisk Desconsolado
o Configurando Asterisk.
Asegrese de tener un usuario con privilegios de administrador de Asterisk. Simplemente
edite /etc/asterisk/manager.conf y agregue uno si no lo hizo an.
event_mask: Este comando filtra las acciones o eventos que usted quiere
visualizar en el panel. Los valores posibles son encendido (on), apagado
(off), sistema (system), llamada (call), e ingreso (log).
65
www.asterio.com.ar
o AstManProxy
AstManProxy es un multi-threaded servidor proxy para Asterisk escrito en C/P-theads.
Est diseado para manejar comunicaciones con mltiples servidores Asterisk y actuar como un
punto nico de contacto para las aplicaciones. Astmanproxy maneja multiples formatos de
entrada y salida incluyendo XML, CSV, and HTTP, HTTPS and SSL.
Usted puede conectarse a astmanproxy en lugar del asterisk manager port mediante la
especificacin de estos parmetros:
flash_dir: Debe ser la direccin exacta del directorio donde est ubicado el
archivo operator_panel.swf. Siguiendo estos ejemplos, debera apuntar a
/var/www/html/panel
www.asterio.com.ar
66
Asterisk Desconsolado
El nivel preconfigurado es cero (sin debug). Si usted quiere ver los eventos
provenientes de Asterisk y los comandos enviados a l, configrelo en 3
(1+2). Si usted quiere un debug completo, configrelo en 255.
Usted puede sobrescribir esta configuracin desde el comando con la lnea
X.
67
Para que el ingreso a las salas de conferencia funcione, usted debe agregar
extensiones en su propio contexto en su plan de marcado (dialplan). Edite
/etc/asterisk/extensions.conf y agregue algo como esto (el nmero de la extensin
debe coincidir el nmero de la sala de conferencia):
[conferences]
exten=>900,1,MeetMe(900)
exten=>901,1,MeetMe(901)
exten=>902,1,MeetMe(902)
Y en /etc/asterisk/meetme.conf usted necesita algo como esto:
[rooms]
conf=>900
www.asterio.com.ar
68
Asterisk Desconsolado
conf=>901
conf=>902
o Configuracin de botones.
Edite el archivo op_butons.cfg ubicado en la carpeta /var/www/html/panel para
adaptarse a sus necesidades. La sintaxis es similar a la de configuracin de archivos de Asterisk.
Usted debe configurar los botones que quiere que sean expuestos en el panel. Cualquier
canal que no tenga el nombre definido no ser expuesto.
[ZAP/4]
Position=1
Label=11 Reception
Extension=11
Context=local
Icon=1
Mailbox=11@localvm
URL=mypage.php
Target=myframe
;No Rectangle=trae
El nombre del canal est escrito entre corchetes. Dependiendo del nombre del canal y de la
posicin de la cabecera (header) usted seleccionar el tipo de botn. La sintaxis para los canales
SIP es SIP/username (SIP/nombre de usuario). Para ZAP es ZAP/channelnumber
(ZAP/nmero de canal). Para IAX2 es IAX2/username (IAX2/nombre de usuario). Otros
canales siguen reglas similares. Usted puede seleccionar el debug a 1 y buscar nombres de
canales venidos de Asterisk para que coincidan con los suyos. Tambin hay botones especiales
para situaciones y aplicaciones particulares, como botones de conferencias (meet me), botones
de estacionamiento (park button), botones de colas (queue) y regexp.
position: Es el nmero del botn. Los botones estn dibujados desde arriba hacia abajo y de
izquierda a derecha. El nmero total de botones depende del tamao y del padding (Esto es
el espacio vaco, usted puede elegir los valores en op_style.cfg). Usted puede poner un valor
exacto, una lista separada por comas, un rango, un valor especial n (next). Si un botn tiene
ms de una posicin definida, ser tratado especialmente: si es un canal regular, se
69
www.asterio.com.ar
www.asterio.com.ar
70
Asterisk Desconsolado
Mailbox: Es el buzn de correo de voz (voicemail) a monitorear. Si usted tiene cuentas de
correo de voz para las extensiones, deber especificar el usuario de correo de voz y el contexto.
Si usted deja este campo libre, el servidor no verificar el buzn de voz para esa extensin.
Tipos de botones.
o Conferencias.
Para hacer un botn para una sala de conferencia, el nombre del canal debe ser slo el
nmero de la conferencia. Ese botn mostrar el nmero de personas dentro de la sala de
conferencia. Si usted tiene un nmero de sala de conferencia 900, el nombre del canal ser 900.
[900]
Position=1
Label=Meetme Room 900
Extension=900
Context=conferences
Icon=6
o Colas.
Para hacer un botn para una cola, el nombre del canal deber ser el nombre de la cola
prefijado con QUEUE/. El botn mostrar el nmero de personas esperando en la cola, y el
mximo de tiempo de espera presente. Por ejemplo, si usted tiene una cola llamada ventas, la
configuracin del botn se ver como:
[QUEUE/ventas]
Position=2
Label=Ventas Queue
Extension=3
Context=queues
Icon=5
o Colas (posiciones).
Usted puede reservarse varios botones para las posiciones de la cola. Cada posicin ser
utilizada por los usuarios esperando en esa cola. Digamos que tiene a tres usuarios esperando
en la cola soporte, entonces, los primeros tres lugares (slots) sern ocupados, uno por cada
persona, en las posiciones que hay para esa cola (slot 1 para la posicin 1, slot 2 para la posicin
2, y dems). El botn de posicin en la cola muestra el nmero de identificacin de llamadas, el
nombre y la cantidad de tiempo de espera para cada persona. Para definir los botones de
posicin de cola, el nombre del canal es el mismo que el de la cola, pero usted tiene que usar
ms de una posicin para ese botn (tantas como guste). Ejemplo:
71
www.asterio.com.ar
o Agentes de cola.
Este tipo de botn puede ser usado para mostrar los agentes que son miembros de una cola
en particular, mediante el ingreso del agente (agentcallbacklogin), agregado de un agente
(addqueuemember) configurado estticamente, sin preocuparse por el mtodo a utilizar.
[QUEUEAGENT/sales]
Position=3-10
Label=Sales Queue
Extension=-1
Icon=3
o Agentes
Sirve para monitorear un agente en particular mediante su nmero.
[AGENT/1002]
Position=12
Label=Agent 1002
Extension=1002
Context=Agents
Icon=3
o Espacios de estacionamiento.
Usted puede utilizar botones para mostrar espacios de estacionamiento. El botn se
enciende cuando una llamada es estacionada en ese espacio y mostrar una cuenta regresiva
hasta que se agote el tiempo de estacionamiento en lugar del temporizador normal. Ejemplo:
[PARK/701]
Position=12
Label=701 Park
Extension=701
Icon=0
o Botones REGEXP
Existen ocasiones en las que se deben monitorear varios canales simultneamente
nombres de canales dinmicamente generados. Las expresiones comunes (Regular Expressions)
www.asterio.com.ar
72
Asterisk Desconsolado
pueden resultar adecuadas. Para utilizar una expresin comn como equivalente al nombre del
canal, usted debe prefijarlo con un underscore. Este tipo de botones no puede ser utilizado
para originar una llamada porque usted no tiene la certeza de qu canal originar la llamada.
Las expresiones comunes son siempre en caso insensible. Hay algunos caracteres reservados
que no pueden ser utilizados: & y =. Ejemplo:
[_SIP/.*]
regexp to match all sip channels
Position=1,2,3
Label=All Sip channels
Extension=-1
o Botones de Canales.
El tipo de botn estndar. Slo use TECHNOLOGY/channel_name. Algunos tipos de
TECH requieren una conversin nominal especial como se ve en los ejemplos de abajo. Si un
botn utiliza solo una posicin, acumular todas las actividades de las lneas en ese botn
(existen telfonos con la capacidad de tener ms de una llamada por vez). Si usted utiliza ms
de una posicin, se comportarn como botones de troncal (explicado debajo). Ejemplos:
[ZAP/4]
Position=1
Label=11 Reception
Extension=11
Context=local
Icon=1
Mailbox=11@localvm
[SIP/12]
Position=2
Label=12 Mary
Extension=12
Context=local
Icon=1
Mailbox=12@localvm
[IAX2/david]
Position=3
Label=13 David
Extension=13
Context=local
Icon=2
Mailbox=13@localvm
[CAPI[contr1/NNNNNNNNN]]
; where NNN is the ISDN number.
Position=4
Label=External CAPI
Context=in-extern
Icon=4
o Botones de Troncales.
Cuando se especifique ms de una posicin para un botn ser considerado como una
troncal. Un botn normal mostrar instancias del mismo nombre de canal en ese nico botn.
En un botn de troncal, cada instancia ser mostrada en el siguiente botn disponible para esa
troncal. Si usted tiene un DID desde un proveedor IAX2 SIP, y recibe ms de una llamada de
ese usuario, usted debe definir ese botn como una troncal con tantas instancias como
73
www.asterio.com.ar
www.asterio.com.ar
74
Asterisk Desconsolado
Encendiendo el servidor.
Asegrese de configurar el bit ejecutable en op_server.pl, si no est configurado (chmod
a+x op_server.pl). Y verifique la ubicacin de su Perl. Queda asumido que ser /usr/bin/perl.
Si no es as, modifique la ruta en op_server.pl. Para correr el servidor slo escriba en el mismo
directorio como el archivo mismo:
75
www.asterio.com.ar
Acciones
Acciones que puede desarrollar desde el Panel de operador Flash.
Desconectar un canal.
www.asterio.com.ar
76
Asterisk Desconsolado
o Iniciar una llamada.
Usted puede arrastrar y soltar el pequeo telfono en otra extensin. Llamar su telfono,
cuando usted atienda, llamar la otra extensin. Una vez que la otra extensin atienda, la
llamada est en curso.
Referencias rpidas.
Cuando el canal est ocupado, hay alguien en una conferencia cola, el botn
ser rojo.
Cuando pase el puntero del Mouse sobre un botn, si existe actividad en ese
botn, podr leerla en la barra de estado, que es la barra gris sobre los botones.
Antes de realizar alguna accin sobre un canal, usted deber ingresar el cdigo
de seguridad. Si el cdigo no es reconocido, sus acciones sern ignoradas.
77
url: La direccin URL que usted desea traer cuando la extensin especificada
arriba sea llamada.
www.asterio.com.ar
www.asterio.com.ar
78
Asterisk Desconsolado
Grabaciones
ARI (Asterisk recording interface) es un portal de usuario central para el programa de
Asterisk PBX. Proporciona una interfase simple para el correo de voz (voicemail) y las
grabaciones de monitoreo de las llamadas. Asimismo, proporciona el acceso a configuraciones
de usuario en Asterisk.
Prestaciones:
79
Activacin de callforward.
www.asterio.com.ar
Grabaciones
Soporte de PHP5.
Configuracin.
Ubquese en /var/www/html/recordings/includes
Abra el archivo main.conf.php
Para utilizar el ARI para la autenticacin de la base de datos configrelo como
$standalone[use]=true y configure nombre de usuario y contrasea.
Si nicamente desea utilizar el monitoreo de llamadas, configrelo como $ari_no_login=1
La forma preconfigurada del IGN para el monitoreo de llamadas le permitir ver las
llamadas de la extensin que est ingresada en la pgina web.
Si usted prefiere que ciertas extensiones vean todas las llamadas en el monitor de llamadas
de ARI, configrelo como $callmonitor_admin_mailboxes y un signo igual y separando con
comas para limitar la lista de extensiones.
Si usted prefiere que todos los usuarios vean todas las llamadas monitoreadas en el ARI,
configrelo como $callmonitor_admin_mailboxes a todos (all)
Buzn de voz.
En esta pantalla se muestran los ltimos mensajes de voz recibidos. Para escucharlos, basta
hacer click en el vnculo escuchar como se ve en la figura. Los mensajes pueden borrarse,
moverse a otra carpeta o reenviarlos a otra extensin. Tambin pueden abrirse los mensajes
viejos seleccionando la carpeta Antiguos.
www.asterio.com.ar
80
Asterisk Desconsolado
Registro de llamadas.
Muestra una tabla con una lista de todas las llamadas realizadas por la extensin que
ingres al ARI. Para las conversaciones que hayan sido grabadas (ver captulo funciones)
muestra un vinculo en la ltima columna que permite escucharla.
81
www.asterio.com.ar
Grabaciones
Opciones
En esta pgina, cada usuario puede cambiar las propiedades de su correo de voz.
www.asterio.com.ar
82
Asterisk Desconsolado
83
www.asterio.com.ar
Funciones de llamada
Funciones de llamada
En este captulo se detallan las funciones ya programadas en Asterisk. Para el acceso a ellas,
se considera que no se realizaron cambios en el mdulo features codes.
Redireccin de llamada.
Desva las llamadas que entran a una extensin a otra o a un nmero externo.
*72: Activa la redireccin incondicional.
*73: Desactiva la reaccin incondicional.
*74: Desactiva la redireccin preguntando antes el nmero de la extensin. En los casos
anteriores, los cambios se efectan sobre la extensin que se utiliz para ajustar el desvo.
*90: Activa la redireccin cuando la extensin est en uso.
*91: Desactiva la redireccin cuando la extensin est en uso.
*92: Igual que *91 pero preguntando la extensin sobre la que se quiere hacer el cambio.
*52: Activa la redireccin de llamada cuando la extensin no responde o no est disponible.
*53: Desactiva la redireccin de llamada cuando la extensin no responde o no est
disponible.
www.asterio.com.ar
84
Asterisk Desconsolado
Llamada en espera.
La llamada en espera permite recibir una llamada mientras se mantiene una comunicacin.
Una seal acstica indica que una nueva llamada ha ingresado. Con las teclas flash o recall se
toma la nueva llamada y se deja la anterior en espera.
*70: Activa la llamada en espera.
*71: Desactiva la llamada en espera.
No molestar (DND).
Esta funcin desconecta el telfono impidindole recibir llamadas.
*78: Activa DND
*79: Desactiva DND.
Servicios.
*43: Prueba de eco. Esta funcin permite verificar el tiempo de latencia entre la extensin y
Asterisk. Es til para verificar el retardo en las extensiones remotas (SIP o IAX2).
*60: Reproduce un mensaje que seala la hora del servidor donde corre Asterisk.
*62: Funcin de llamada despertador. Al marcar esta combinacin, usted deber ingresar 4
nmeros para indicar la hora a la que desea que entre una llamada a su extensin.
*65: Reproduce un mensaje que indica el nmero de extensin.
*69: Indica el nmero telefnico de la ltima llamada recibida y permite comunicarse
directamente con l.
Discado rpido.
El discado rpido consiste en memorizar un nmero de telfono en otro de 3 cifras,
agilizando as el proceso de marcado. Existen dos tipos de discado rpido. Uno de acceso a
todos los usuarios y desde cualquier extensin. Quiere decir, que es posible configurar hasta 100
nmeros de discado rpido para todas las extensiones de la empresa. Aqu deberan ingresarse
los nmeros de uso comn entre los empleados. Se configura de la siguiente manera:
300 3nn 9XXXXXXXX: Ajusta el discado rpido 3nn al nmero 9XXXXXXXX.
3nn: Discado rpido del nmero ingresado a 3nn.
*3nn: Reproduce un mensaje que reproduce el nmero asignado al discado rpido 3nn.
La otra forma, es reservada para cada extensin. Quiere decir, que cada extensin cuenta
con 100 nmeros de marcado. Los cuales pueden ser configurados solo por la extensin que
har uso de l. Se configura de la siguiente manera:
500 5nn 9XXXXXXXX: Ajusta el discado rpido 5nn al nmero 9XXXXXXXX.
5nn: Discado rpido del nmero ingresado a 5nn.
*5nn: Reproduce un mensaje que dice el nmero asignado al discado rpido 5nn.
85
www.asterio.com.ar
Funciones de llamada
www.asterio.com.ar
86
Asterisk Desconsolado
Colas.
XXX*: Para ingresar la extensin a la lista de agentes de una cola. Donde XXX es el nmero
para acceder a la cola.
XXX**: Retira la extensin marcada de la lista de agentes de la cola XXX.
Lista negra.
Esta funcin agrega un nmero a eleccin o el de la ltima llamada recibida a una lista para
rechazarlos en el futuro.
*30: Agrega un nmero en forma manual a la lista negra.
*31: Borra de la lista negra un numero a eleccin.
*32: Agrega a la lista el nmero de la ltima llamada recibida.
Estacionamiento de llamada.
#70: Estaciona la llamada. Luego de marcar #70, la llamada es estacionada en un lugar
disponible del 71 al 79. Un mensaje indica en que nmero fue estacionada. Para tomarla, basta
marcar ese nmero desde cualquier extensin.
Grabaciones.
*1: Cuando es marcado graba la llamada hasta que finalice la comunicacin. Para escuchar
las grabaciones se utiliza el ARI.
Para habilitar esta funcin, es necesario colocar una w en las opciones de marcado del
mdulo opciones generales (ver captulo configuracin).
87
www.asterio.com.ar
Miscelneos
Miscelneos
Instalacin de un softphone.
Un softphone es un programa que emula un telfono convencional para ser usado en una
computadora. En general, utilizan los protocolos SIP o IAX2 de la misma manera que los utiliza
Asterisk a la hora de crear extensiones. La nica diferencia, es que el softphone trabaja como
cliente y Asterisk como un proveedor del servicio de comunicacin.
Existe una gran cantidad de compaas que ofrecen este software. Se pueden encontrar
tanto versiones gratuitas como pagas para trabajar en distintas plataformas. En este caso,
tomaremos como ejemplo el x-lite para plataforma Windows desarrollado por CounterPath.
Del sitio oficial (http://www.counterpath.com), puede descargarse la ltima versin de xlite. En este caso trabajaremos con la versin 3.0.
Una vez descargado el archivo basta ejecutarlo y seguir estos pasos:
Hacer click en next.
www.asterio.com.ar
88
Asterisk Desconsolado
89
www.asterio.com.ar
Miscelneos
a.
www.asterio.com.ar
90
Asterisk Desconsolado
Cuando el equipo termina de reiniciarse, ver un mensaje como el que se muestra abajo.
Haga clic en s.
91
www.asterio.com.ar
Miscelneos
Haga clic en add para configurar x-lite con los datos correspondientes a la extensin SIP
creada previamente en Asterisk.
www.asterio.com.ar
92
Asterisk Desconsolado
93
www.asterio.com.ar
Miscelneos
En el caso de tener un firewall activo (en este caso el de Windows), veremos un mensaje
como este:
www.asterio.com.ar
94
Asterisk Desconsolado
Tycho
Tycho es un administrador de correo de voz (voicemail) y asistente de marcado para
Asterisk PBX, aunque no nicamente para Asterisk. A diferencia de la mayora de las interfases
de correo de voz basadas en formato web disponibles, Tycho es una aplicacin nativa de
Java/Eclipse, y como tal, resulta en una solucin ms amigable con el usuario.
95
Facilidad en el uso
Facilidad en la personalizacin
www.asterio.com.ar
Miscelneos
Funcionamiento
Como ya se mencion, Tycho es una aplicacin cliente basada en Java/Eclipse, que
funciona en su computadora local y simultneamente una serie de scripts php de Server,
llamados VMXML, funcionando en su servidor Asterisk bajo un servidor web Apache.
Voicemail2xml
Voicemail2xml es un conjunto de scripts php los cuales permiten el fcil acceso y
manipulacin de los archivos de correo de voz de Asterisk. Los scripts trabajan con una
autenticacin basada en ASCII (/etc/asterisk/voicemail.conf).
Para la descargar el programa y ms informacin, visitar http://sip-syndication.com
Putty
Putty es un software gratuito SSH,
Telnet, rlogin y ciente TCP raw.
Originalmente estaba disponible
nicamente para Windows, pero ahora
est disponible para varias
plataformas Unix, con puertos de
trabajo en progreso (work-in-progress)
a Mac OS y Mac OS X. Otras personas
han contribuido con puertos no
oficiales para otras plataformas, como
telfonos mviles potenciados por
Symbian. Su versin beta es escrita y
mantenida primordialmente por
Simn Tatham, es de cdigo abierto y
est licenciado bajo una licencia del
MIT.
www.asterio.com.ar
96
Asterisk Desconsolado
WinSCP
WinSCP es una aplicacin de Software Libre. WinSCP es un cliente SFTP grfico para
Windows que emplea SSH. El anterior protocolo SCP tambin puede ser empleado. Su funcin
principal es facilitar la transferencia segura de archivos entre dos sistemas informticos, el local
y uno remoto que ofrezca servicios SSH.
Puede descargarse desde http://winscp.net
97
www.asterio.com.ar
Glosario
Glosario
En esta seccin usted encontrar los trminos comnmente utilizados para explicar la
configuracin y funcionamiento de su sistema Asterisk. Algunos de estos trminos no son de
uso comn para las personas que no estn tan familiarizadas con la administracin de sistemas
de comunicaciones, por esto es que aqu se le brindan las aclaraciones para comprender
completamente el funcionamiento y operacin de sus sistema Asterisk, as como para poder
comprender este manual y aplicarlo para la operacin del sistema.
VoIP: Es la sigla para Voice Over Internet Protocol. Es lo que lleva llamadas
telefnicas a travs de redes de datos como redes corporativas la Internet.
Asterisk PBX: Un software gratuito que funciona para Linux y Unix. Conecta
llamadas a travs del protocolo de voz sobre IP (VoIP) y sistemas telefnicos
tradicionales (PSTN).
Bri: Tasa bsica de ISDN. Es un mtodo comn para conectar pequeas partes del
sistema VoIP con instalaciones PBX a la red de telefona tradicional (PSTN), y
tambin es una plataforma para el sistema de respuesta de recepcionista digital
(IVR). Una lnea Bri carga dos llamadas simultneamente.
98
Asterisk Desconsolado
99
IVR: Es la sigla para Interactive Voice Responce. En este manual est descrito
como sistema de respuesta de recepcionista digital. Es el sistema que reproduce
mensajes a los llamantes, les permite acceder a mens de voz aplicaciones
mediante la navegacin por el teclado del telfono.
AGI: Es la sigla para Asterisk Gateway Interface. Es el puerto del que se sirve
Asterisk para conectarse con otras aplicaciones.
DTMF: Multifrecuencia de doble tono. Estos tonos se usan en telefona para marcar
un nmero telefnico.
www.asterio.com.ar
Eplogo
Eplogo
Este manual se escribi teniendo en cuenta las necesidades de un administrador y usuario
del sistema de comunicaciones Asterisk. Est pensado para la correcta implementacin del
sistema y su uso ms efectivo.
La bibliografa consultada proviene de distintos foros de programacin, el libro Asterisk
The future of telephony editado por OReilly media y avalado por Mark Spencer y toda la
comunidad de desarrolladores de Asterisk en el mundo, representada por el proyecto de
documentacin de Asterisk a quienes le estamos agradecidos, por hacer de la comunicacin una
actividad entre personas y sin intermediarios corporativos y annimos.
Los autores de este volumen son Eduardo Federico Viegas y Facundo Hernn Correa,
integrantes de Asterio (http://www.asterio.com.ar) , una organizacin que ofrece soluciones
para Asterisk en Argentina. Esperamos que les pueda servir de apoyo para continuar con el
cambio en los sistemas de comunicaciones y as tambin, como con el desarrollo para continuar
el firme avance que est teniendo la separacin de los sistemas que prestan servicios de
comunicacin de las empresas que no prestan ayuda al desarrollo de las mismas
comunicaciones.-
www.asterio.com.ar
100