Escolar Documentos
Profissional Documentos
Cultura Documentos
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.
1 www.asterio.com.ar
Introduccin
ndice
Introduccin ......................................................................................... 4
Qu es PBX? .................................................................................................................................5
Configuracin........................................................................................ 7
Extensiones extensions.................................................................................................................9
Troncales trunks..........................................................................................................................21
Follow me.....................................................................................................................................30
Colas queues................................................................................................................................32
DISA..............................................................................................................................................38
Callback........................................................................................................................................41
PIN sets.........................................................................................................................................47
Herramientas ...................................................................................... 51
www.asterio.com.ar 2
Asterisk Desconsolado
Asterisk Logfiles..........................................................................................................................52
Asterisk API.................................................................................................................................53
PHP Info.......................................................................................................................................56
phpMyAdmin..............................................................................................................................58
System Status...............................................................................................................................58
Informes ............................................................................................. 59
Grabaciones ........................................................................................ 79
Funciones de llamada.......................................................................... 84
Miscelneos ........................................................................................ 88
Tycho ............................................................................................................................................95
Putty..............................................................................................................................................96
WinSCP ........................................................................................................................................97
Glosario............................................................................................... 98
3 www.asterio.com.ar
Introduccin
Introduccin
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 4
Asterisk Desconsolado
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.
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.
Los canales pueden ser SIP o IAX2 en el caso de los utilizados en comunicaciones VoIP o
ZAP, ISDN, PRI o BRI para los utilizados por el hardware que permite a Asterisk conectarse a
la PSTN.
En la historia de las comunicaciones nunca antes existi un sistema tan adaptado a las
necesidades de los negocios, a cualquier precio. Asterisk es tecnologa con disponibilidad, y
como en el caso de Linux, en un futuro inmediato ser difcil encontrar un emprendimiento que
no tenga alguna versin de Asterisk funcionando de alguna manera en algn lugar de la red,
manejando una necesidad como slo Asterisk puede hacerlo.
Este nivel de aceptacin suceder mucho ms rpido que el caso de Linux, por las
siguientes razones:
5 www.asterio.com.ar
Introduccin
www.asterio.com.ar 6
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.
7 www.asterio.com.ar
Configuracin
Dashboard de FreePBX.
www.asterio.com.ar 8
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.
9 www.asterio.com.ar
Configuracin
IAX2 es el Inter Asterisk Protocol, un nuevo protocolo manejado por slo unos
pocos dispositivos. Telfonos de base PA1688, el IAX2 y ATA
Por ejemplo, para la ruta de la extensin 211 a 1-800-555-1212, usted puede crear una
extensin personalizada (custom) 211y en el casillero de marcado (dial) usted ingresa
Local/18005551212@outbound-allroutes.
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
se quiere asociar con este interno. Por ejemplo, Parmetros a configurar en el caso de haber seleccionado un
dispositivo SIP.
si tenemos una lnea con el nmero 11-5555-
1234 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
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 Configuracin de los cdigos de acceso a las funciones de
puede encontrarse en el captulo funciones. Asterisk.
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.
Directorio de la empresa.
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.
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
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.
Cualquier llamada que sea reconocida por este patrn de discado utilizar el Caller ID
especificado en el CID de emergencia, en lugar de usar el CID de salida usual en las
extensiones.
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:
1237-9 Equivale a cualquier dgito entre corchetes (en este ejemplo: 1, 2, 3, 7, 8 y 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.
9|911 Slo usa esta ruta si el usuario ha marcado 9911 pero quita el primer nueve
antes de enviarlo a la troncal.
0|. Cualquier nmero que comience con cero, utiliza esta ruta.
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:
21 www.asterio.com.ar
Configuracin
ENUM
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.
Reglas:
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.
o Nombre de la troncal:
Aqu se coloca un nombre (que debe ser nico) para identificar la troncal. Es recomendable
utilizar el nombre del VSP.
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.
23 www.asterio.com.ar
Configuracin
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
H323/$OUTNUM$@XXX.XXX.XXX.XXX:XXXX
vpb/1-1/$OUTNUM$:
www.asterio.com.ar 24
Asterisk Desconsolado
25 www.asterio.com.ar
Configuracin
ENUM: Utilice los DNS para buscar los nombres de los llamantes. Utiliza las zonas de
bsqueda de ENUM como estn configuradas en enum.conf
www.asterio.com.ar 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
Path: Ruta del archivo que recibe las variables. Ejemplo: /cidlookup.php
27 www.asterio.com.ar
Configuracin
o Descripcin.
Escriba aqu una descripcin para la ruta
entrante que est creando. Con este nombre, se
identificaran las rutas en el men que
aparecer a la derecha de este mdulo.
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
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.
Para configurar follow me, haga clic en alguna de las extensiones ya creadas que
aparecen a la derecha de la pantalla.
o Disable
Si se marca, se deshabilitar la funcin de follow-me para la extensin seleccionada.
www.asterio.com.ar 30
Asterisk Desconsolado
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.
*-prim: Las variantes indicadas con la terminacin prim, se comportan del siguiente
modo:
Si el primer nmero posee la funcin DND activada, se aplicar a los dems nmeros y por
lo tanto, no sonar ninguno.
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.
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)
leastrecent (menos reciente): Llama al agente que atendi una llamada de esta cola por
ultima vez.
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 Frecuencia.
Qu tan seguido anunciar las posiciones de las llamadas en colas, tiempo estimado de
espera y/o men de voz para el llamante. Seleccione cero para desactivar todos los anuncios de
llamada.
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 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.
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).
o Nmero de grupo.
Este es el nmero que es marcado desde cualquier extensin para que todos los telfonos
del grupo llamen.
Estrategia de ring.
Ringall: Llama a todos los canales disponibles hasta que alguno conteste.
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
Para generar una grabacin, siga los pasos que se indican en el panel.
Si usted est subiendo un archivo .wav, necesita ser guardado como PCM Uncompressed
en mono a 8000hz y 16 bits.
IVR
Prefacio.
La pgina de la recepcionista digital (IVR)
es la interfase utilizada para configurar su auto-
respuesta 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.
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 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.
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
ingresarse a la conferencia. El nico uso de Creacin de una sala de conferencias
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.
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
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.
restart gracefully: Deja de recibir llamadas, espera que el volumen de llamadas se vace y
reinicia Asterisk.
add ignorepat <pattern> into <context>: Agrega una regal ignorada en un contexto.
help: Muestra una lista de los comandos con una breve descripcin.
logger reload: Vuelve a abrir los archivos log (ver apartado Backup and Restore).
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
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 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.
www.asterio.com.ar 54
Asterisk Desconsolado
show uptime: Devuelve el tiempo transcurrido desde el ultimo inicio del sistema.
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.
Cdigo de discado rpido (speed dial code): Nmero de acceso rpido para la extensin.
55 www.asterio.com.ar
Herramientas
Voicemail: Active esto si usted quiere incluir los mensajes de correo de voz en este backup.
Esto puede incrementar seriamente el tamao de su backup por estar cargando archivos de
audio potencialmente largos.
Sistem recordings: Active esto si usted quiere resguardar sus grabaciones del sistema
personalizadas que haya creado para su recepcionista virtual colas. Nuevamente, esto puede
incrementar notablemente el tamao de su backup.
Sistem Configurations: Active esta opcin para resguardar sus datos de configuracin de
Asterisk y FreePBX, incluyendo el MySQL y las bases de datos de Asterisk. Nosotros
recomendamos que esto est activo en todos los backups.
Operator panel: Active esta opcin para resguardar el FOP (Flash Operator Panel)
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.
/etc/asterisk: Contiene los archivos de configuracin del hardware y del plan de marcado.
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.
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).
59 www.asterio.com.ar
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.
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.
$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
Flash Operator Panel
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
Flash Operator Panel
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.
67 www.asterio.com.ar
Flash Operator Panel
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
Flash Operator Panel
Panel_Context: Desde la versin .10 usted dispone de contextos de panel. Esto significa
que solo correr un solo servidor, y habrn varios clientes Flash con diferentes disposiciones de
botones conectados a este servidor. Si usted omite este parmetro el contexto preconfigurado
ser el aplicado. Para especificar el contexto a cargar en el Flash, usted tiene que modificar la
pgina que carga el archivo swf. Slo agregue ?context=mycontext despus de cada aparicin
de operator_panel.swf.
Target: Esto sirve para configurar el vnculo (hyperlink) al objetivo (target). Si es omitido,
se utilizar la ventana presente para mostrar la URL. Usted puede utilizar los objetivos (target)
estandarizados HTML, como los _parent, _new, etc.
Label: Es la etiqueta del botn. Usted tiene que encerrarlo con comillas si est pensando en
usar espacios.
Caracteres internacionales.
Si usted quiere utilizar caracteres especiales en las etiquetas de los botones, tiene que
guardar el archivo de configuracin con una codificacin UTF-8. Para convertir el archivo a
UTF-8 utilizando vi (El programa de Linux para editar texto) y la lnea de comando, slo haga:
Obsrvese que la etiqueta del botn es utilizada como el texto del identificador de llamadas
cuando se originan llamadas dentro del panel de operador Flash. Si usted utiliza caracteres
especiales, el texto del identificador de llamadas no funcionar correctamente.
Icon: Es el icono, existen seis tipos de conos disponibles. Si usted no quiere mostrar un
icono en un botn, configrelo en cero simplemente borre la lnea del icono para ese botn en
particular.
1 2 3 4 5 6
www.asterio.com.ar 70
Asterisk Desconsolado
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
[900]
Position=2-5
Label=Meetme User
Extension=1
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
Flash Operator Panel
[QUEUE/support]
Position=3-10
Label=Support Queue
Extension=-1
Icon=5
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
[CLID/5555555]
Position=13
Label=5555 Jhon
Extension=5555555
Context=from-internal
Icon=2
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
Flash Operator Panel
prefiera. De esta manera usted puede transferir llamadas individuales del mismo proveedor.
Ejemplo:
[IAX2/iaxtel]
Position=10-12
Label=Iaxtel
Extension=-1
Icon=3
[SIP/myprovider]
Position=23-30
Label=SIP TRUNK
Extension=-1
Icon=4
Los nombres de las variables son claros en s mismos. Por ejemplo, si usted quiere reducir
el alto de los botones, slo ajuste el btn_heigt a un valor menor.
Usted puede cambiar este archivo con el Panel de operador Flash (op_panel.pl)
funcionando. Despus de cambiar un valor, usted debe decirle al servidor que actualice la
configuracin mediante el envi de una seal HUP (killall HUP op_server.pl). Despus de eso,
usted necesita recargar el display de Flash, haciendo click en el botn de reload
simplemente recargando la pgina.
www.asterio.com.ar 74
Asterisk Desconsolado
[macro-stdexten]
exten=>s,1,DBget(temp=clid/${ARG1})
exten=>s,2,SetCIDName(${temp})
exten=>s,3,DBdel(clid/${ARG1})
exten=>s,4,Dial(${ARG1},30,TrH)
exten=>s,5,Voicemail(u${MACRO_EXTEN})
exten=>s,6,Hangup
; llega aqu si dbget falla (no hubo clid info proveda)
exten=>s,102,goto(s,4)
; ocupado desde marcado
exten=>s,105,Voicemail(b${MACRO_EXTEN})
exten=>s,106,Hangup
Usted tambin puede utilizar la aplicacin de Asterisk UserEvent para disparar algunos
comportamientos especiales acciones desde su plan de marcado.
PopUps: Usted puede disparar una pantalla popup desde el plan de marcado (dialplan). El
parmetro del botn es opcional, restringir el ppopup a clientes Flash cargados con
mybutton restringido a ese nmero de botn. Ejemplo:
exten=>1,1,UserEvent(FOP_Popup|URL:p.php?e=${EXTEN}^Target:
top^Button:1)
Cambiar el color del led: Usted puede cambiar el color del led tambin (pero el estado no
ser guardado entre recargas)
exten=>1,1,UserEvent(FOP_ledcolor|Color: 0x0000FF^State: 0)
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
Flash Operator Panel
./op_server.pl
El servidor no se desliga de la consola. Si usted quiere que corra por el background adjunte
-d en la lnea de comando. Si el nivel de debug es distinto a cero, la salida ser logueada en
stdout. Para averiguar si el servidor funciona bien, configure el nivel de debug en uno, la salida
debera verse de esta manera:
Usted puede correr el servidor desde su script rc.local para tenerlo corriendo en el startup.
Tambin hay ejemplos de init script en el directorio init si usted prefiere utilizar su sistema init
distro. Asegrese de encender op_server.pl despus de Asterisk. Si usted reinicia Asterisk, el
op_server intentar reconectarse 60 veces con intervalos de diez segundos (diez minutos). Si
falla en la conexin despus de esos intentos, se apagar.
El panel puede ser activado tanto para el FreePBX, mediante la seleccin de la opcin de
panel en la esquina derecha superior de la pantalla FreePBX, desde la pantalla de
bienvenida de TRIXBOX.
Acciones
Acciones que puede desarrollar desde el Panel de operador Flash.
Desconectar un canal.
www.asterio.com.ar 76
Asterisk Desconsolado
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.
Usted puede tener una pgina web con los detalles del cliente antes de atender la llamada.
Esta prestacin fue introducida en la versin 0.11 del panel de operador Flash. Para configurarla
usted deber especificar algunas variables en la pgina HTML que carga el panel de operador
Flash:
url: La direccin URL que usted desea traer cuando la extensin especificada
arriba sea llamada.
77 www.asterio.com.ar
Flash Operator Panel
Usted tiene que agregar las variables cuando carga el archivo .swf. Abra el ndice HTML
(index.html) provisto y busque por las instancias del panel de operador Flash
(operator_panel.swf) y adjunte las variables como:
operator_panel.swf?mybutton=4&url=customer.php&target=bottom
Usted puede utilizar un marco invisible (0 de ancho y sin bordes) para cargar el archivo
.swf y no tapar la pantalla con el panel en si mismo, si lo prefiere. Para tener otro botn bajo
monitoreo, otro usuario, etc. puede utilizarse el mtodo que prefiera: php, modperl, asp, etc.
para modificar el marco que carga el archivo .swf y ajustar las variables de la forma de su
preferencia. Si usted no especifica la variable mybutton, la direccin URL est vaca, la
prestacin de software de administracin de relaciones con el cliente ser desactivada.
<?PHP
if(isset($_GET['clid'])) {
echo "The caller id is ".$_GET['clid'];
}
?>
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:
AJAX permite la actualizacin automtica de pginas.
Activacin de callforward.
79 www.asterio.com.ar
Grabaciones
Soporte de PHP5.
Configuracin.
Ubquese en /var/www/html/recordings/includes
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
Para acceder a esta interfase, simplemente, abra la pgina principal de Trixbox y haga clic
en el vnculo que dice Web MeetMe Control.
Luego, coloque el nmero de la sala de conferencia que desee administrar y haga clic en
connect. De esta manera, ver una lista de las extensiones conectadas a dicha sala.
Haciendo clic en MUTE, har que la extensin solo pueda escuchar la conversacin pero
sin participar en ella.
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.
*92: Igual que *91 pero preguntando la extensin sobre la que se quiere hacer el cambio.
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.
No molestar (DND).
Esta funcin desconecta el telfono impidindole recibir llamadas.
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.
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:
*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:
*5nn: Reproduce un mensaje que dice el nmero asignado al discado rpido 5nn.
85 www.asterio.com.ar
Funciones de llamada
En ambos casos, para ingresar a su casilla, se le solicitar ingresar su contrasea. Una vez
ingresado podr navegar dentro de estas opciones.
3: Opciones avanzadas
1: Contestar el mensaje.
4: Llamada saliente.
5: Dejar mensaje.
7: Borrar el mensaje.
2: Cambiar de carpeta.
3: Opciones avanzadas.
0: Opciones de la casilla
3: Grabar su nombre.
4: Cambiar su contrasea.
*: Ayuda
#: Salir
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.
Lista negra.
Esta funcin agrega un nmero a eleccin o el de la ltima llamada recibida a una lista para
rechazarlos en el futuro.
#XXX*: Transfiere la llamada directamente al correo de voz (voicemail) del interno XXX.
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.
www.asterio.com.ar 88
Asterisk Desconsolado
89 www.asterio.com.ar
Miscelneos
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:
Si todo sali bien, deberamos ver la palabra ready como muestra la siguiente figura:
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.
Facilidad en el uso
Facilidad en la personalizacin
95 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.
Esta serie de scripts php actan como una disposicin abstracta entre el sistema de correo
de voz de Asterisk y el correo de voz cliente de Tycho, a travs de la provisin de acceso al
sistema de correo de voz de Asterisk.
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).
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.
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.
www.asterio.com.ar 98
Asterisk Desconsolado
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.
99 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.
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