Documentos de Académico
Documentos de Profesional
Documentos de Cultura
• Ante cualquier reutilización o distribución, usted debe dejar claro a los otros los
términos de la licencia de esta obra.
• Nada en esta licencia menoscaba o restringe los derechos morales del autor.
1 www.asterio.com.ar
Introducción
Índice
Introducción ......................................................................................... 4
Configuración........................................................................................ 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
Misceláneos ........................................................................................ 88
Tycho ............................................................................................................................................95
Putty..............................................................................................................................................96
WinSCP ........................................................................................................................................97
Glosario............................................................................................... 98
3 www.asterio.com.ar
Introducción
Introducción
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 código 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 más variadas características, con los costos más 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 país a costos locales, un sistema de
recepcionista virtual con menú interactivo, hasta notificaciones de correo de voz personalizadas
ó transferencias personalizadas; asegurándose 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 compañía. Comúnmente puede tener desde dos a diez mil extensiones y una conexión al
sistema telefónico tradicional (PSTN) para llamadas hacia y desde el exterior de la compañía.
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 tecnología con disponibilidad, y
como en el caso de Linux, en un futuro inmediato será difícil encontrar un emprendimiento que
no tenga alguna versión de Asterisk® funcionando de alguna manera en algún lugar de la red,
manejando una necesidad como sólo Asterisk® puede hacerlo.
Este nivel de aceptación sucederá mucho más rápido que el caso de Linux, por las
siguientes razones:
5 www.asterio.com.ar
Introducción
www.asterio.com.ar 6
Asterisk® Desconsolado
Configuración
En este capítulo se tratan todos los módulos de FreePBX que sirven a la completa
configuración de Asterisk®.
Para acceder a FreePBX, abra un navegador Web y escriba la dirección IP que haya
configurado durante la instalación seguida por /admin.
7 www.asterio.com.ar
Configuración
Dashboard de FreePBX.
www.asterio.com.ar 8
Asterisk® Desconsolado
Muchos de los términos utilizados en los módulos son expuestos también en inglés dada la
familiaridad que existe con ellos entre los usuarios que ya hayan administrado una PBX
tradicional anteriormente.
Extensiones extensions
Información.
Esta área es para handsets, softphones, sistemas de pager o cualquier otra cosa que pueda
ser considerada una extensión del sistema clásico PBX.
Prefacio.
Definir y editar extensiones es probablemente la tarea más comúnmente realizada por un
administrador de PBX, como tal, usted estará muy familiarizado con esta página. Actualmente
existen cuatro tipos de dispositivos de soporte – SIP, IAX2, ZAP y personalizado (custom).
Desde esta página, también se configura la casilla de mensajes (voicemail) asociada a la
extensión creada.
9 www.asterio.com.ar
Configuración
• IAX2 es el “Inter Asterisk Protocol”, un nuevo protocolo manejado por sólo unos
pocos dispositivos. Teléfonos de base PA1688, el IAX2 y ATA
Por ejemplo, para la ruta de la extensión 211 a 1-800-555-1212, usted puede crear una
extensión personalizada (custom) 211y en el casillero de marcado (dial) usted ingresa
“Local/18005551212@outbound-allroutes”.
www.asterio.com.ar 10
Asterisk® Desconsolado
Extensión.
El valor ingresado en este campo debe ser
único. Este es el número que puede ser
marcado desde otra extensión cualquiera, ó
directamente desde la recepcionista digital
(IVR), si está activado este módulo. Este
número puede tener cualquier largo, pero
convencionalmente es utilizado un número de
tres ó cuatro dígitos.
Nombre asociado.
Esto es el texto del identificador de
llamada que se presenta a los que son llamados.
Debería ser cualquier línea ISO8859-1(ó ASCII).
Pero aceptará UTF-8. Nótese que algunos
teléfonos tendrán problemas con nombres de
varios bytes, por ejemplo los UTF-8,
posiblemente colapsando los teléfonos. Si
utiliza nombres de varios bytes, experimente
cautelosamente.
SIP Alias
Direct DID
Aquí se coloca el número directo (PSTN o
VoIP) tal como es recibido por la central, al que
se quiere asociar con este interno. Por ejemplo, Parámetros a configurar en el caso de haber seleccionado un
dispositivo SIP.
si tenemos una línea con el número 11-5555-
1234 y las llamadas a este que suenen
directamente en este interno, debemos colocar 1155551234.
11 www.asterio.com.ar
Configuración
Music on Hold.
Esta opción especifica que categoría de música usará este interno cuando necesite enviar
música en espera a la parte llamante. Las categorías se configuran previamente en el módulo
“Music on Hold”
Outbound CID
Debe ingresarse un valor con el formato “Nombre” <#########>. Este valor sobrescribirá
el Caller ID de la línea 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
opción default toma el valor ingresado en el módulo “Configuraciones Generales”.
Call Waiting
Permite activar o desactivar la función de llamada en espera para el interno que se está
creando. Esta función 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 identificación de llamada cuando se utilice una ruta saliente marcada como “Llamadas de
emergencia”.
Contraseña (secret).
Esta es la contraseña (password) utilizada por el dispositivo telefónico para autentificarse
al servidor de Asterisk cuando se crea una extensión SIP o IAX2. Esto es generalmente
configurado por el administrador antes de dar el teléfono al usuario, y comúnmente no
conocida por el usuario. Si el usuario esta utilizando un softphone, entonces necesita saber esta
contraseña para configurar el programa.
www.asterio.com.ar 12
Asterisk® Desconsolado
Aplicar privacidad.
Si la persona que llama no tiene identificador de llamada (número privado), se le pedirá
que ingrese los 10 números de su número telefónico.
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 español, it para italiano, etc.
Grabación entrante.
Opciones para grabar las llamadas recibidas en la extensión. Existen tres opciones:
• Siempre
• Nunca
• A pedido (el usuario puede presionar ‘*’1 para activarlo durante cualquier llamada)
Grabación saliente.
Funciona de la misma manera que el anterior, pero con llamadas salientes.
13 www.asterio.com.ar
Configuración
Dirección 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 número que llamó antes de reproducir el mensaje, e inmediatamente después
anuncia la fecha y hora (envelope) en la que fue grabado el mensaje.
www.asterio.com.ar 14
Asterisk® Desconsolado
Feature codes
Información.
Este módulo permite personalizar los números
que se deben marcar para acceder a las funciones de
Asterisk. También pueden deshabilitarse funciones,
como por ejemplo, aquellas que puedan
comprometer la privacidad.
La descripción detallada de estas funciones Configuración de los códigos de acceso a las funciones de
puede encontrarse en el capítulo funciones. Asterisk®.
Configuraciones
generales general settings
Opciones de marcado.
o Opciones de marcado
Esta opción habilita las diferentes opciones que el usuario podrá utilizar para las llamadas
que reciba.
Las opciones más comunes son “Tr”, que significa “La persona que está recibiendo la
llamada puede transferirla usando #” y “Generar tonos de llamado cuando una extensión esta
llamando”. Otras opciones utilizables son:
• h: Permite a la parte llamada cortar mediante el envío del dígito ‘*’ DTMF.
15 www.asterio.com.ar
Configuración
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
módulo “features codes”) se le solicitará ingresar las tres primeras letras del nombre o apellido
de acuerdo a lo que se seleccione en esta opción.
o Operator Extensión
Este campo viene completado con el número del operador del sistema (recepcionista).
Puede ser un número de interno, el de una cola o el de un grupo de internos.
Máquina 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 país donde se encuentra.
Security Settings
17 www.asterio.com.ar
Configuración
www.asterio.com.ar 18
Asterisk® Desconsolado
o PIN set.
Esta opción le permite seleccionar una de las configuraciones ya realizadas en el menú
“PIN set”. De esta manera es más simple administrar las contraseñas. Si utiliza esta opción, deje
en blanco en campo de “contraseña de ruta”.
Cualquier llamada que sea reconocida por este patrón 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 Música en espera.
Es posible seleccionar la categoría de música que se desea reproducir al momento en que se
active la música en espera en una llamada que haya sido generada a través de esta ruta. El
objetivo de esta función sería dar la posibilidad de reproducir mensajes publicitarios en el
idioma del país (o grupo de paises) al que se está llamando.
19 www.asterio.com.ar
Configuración
o Patrones de marcado.
Un patrón de discado es una serie única de dígitos que seleccionará esta troncal. Ingrese un
patrón de discado por línea.
Reglas:
1237-9 Equivale a cualquier dígito entre corchetes (en este ejemplo: 1, 2, 3, 7, 8 y 9).
| Separa los prefijos de marcado del número a marcar. Por ejemplo, 9|NXXXXXX
equivaldrá cuando alguien marque 95551234 pero sólo enviará 5551234 a la troncal.
9|911 Sólo usa esta ruta si el usuario ha marcado “9911” pero quita el primer nueve
antes de enviarlo a la troncal.
0|. Cualquier número que comience con cero, utiliza esta ruta.
o Secuencia de troncales.
Cuando esta ruta es reconocida por el patrón de discado anteriormente mencionado, la
central intenta realizar la llamada usando las troncales en el orden en que sean seleccionadas en
este punto. Obsérvese que si usted tiene una troncal protegida por una contraseña, y el usuario
ingresa mal la contraseña, no intentará continuar a la siguiente troncal. Asegúrese de haber
seleccionado “agregar” (add) después 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 algún dispositivo que responda al número que se marcó (por
ejemplo, otro Asterisk o la PSTN). Existen cinco tipos de Troncales:
21 www.asterio.com.ar
Configuración
ENUM
o Canales máximos.
Esto limita el número máximo de canales (llamadas simultáneas) que pueden ser usados
por esta troncal, llamadas entrantes y salientes. Déjelo en blanco para no especificar el máximo.
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),
debería configurar estas dos reglas:
011+N
www.asterio.com.ar 22
Asterisk® Desconsolado
1|.
La primera, agrega el prefijo 011 a todos los número pasados por una “Ruta saliente” (que
debe quitar el “00” antes de pasar el número a la trocal) que inicie con un número 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 cómo la central busca al servidor del VSP contratado. Los valores
posibles son dynamic, hostname o dirección ip.
insecure Especifca como manejar la conexión con el otro punto. Los valores
posibles son: very, yes, no, invite, port.
23 www.asterio.com.ar
Configuración
o Cadena de registro:
La mayoría de los VSP requieren que la central se registre con el servidor. Los parámetros y
forma de los registros es suministrado por el proveedor. En general, suelen tener un formato
similar a este:
nombre_de_usuario:contraseña@servidor
o Troncal personalizada.
Si usted está usando H323, Chan, capi ó cualquier otro tipo de troncal no estandarizada,
usted puede configurar la línea de marcado para ser usada con este tipo de troncal,
reemplazando el número 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
Configuración
• ENUM: Utilice los DNS para buscar los nombres de los llamantes. Utiliza las zonas de
búsqueda de ENUM como están configuradas en enum.conf
www.asterio.com.ar 26
Asterisk® Desconsolado
• http: ejecuta una dirección de Internet que pasa variables usando el método “GET”
pasando el número 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
Configuración
o Descripción.
Escriba aquí una descripción para la ruta
entrante que está creando. Con este nombre, se
identificaran las rutas en el menú que
aparecerá a la derecha de este módulo.
o Número de DID.
Para un SIP ó un par IAX2, este es
normalmente su número 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 número que llama no tiene Caller ID (un número privado), esta opción preguntará a la
persona que llama que introduzca los 10 dígitos de su número de teléfono. Tendrá tres intentos.
o Music on Hold?
Puede seleccionar alguna de las categorías de música de espera creadas en el módulo
“Music On Hold” de FreePBX.
o Signal RINGING
Algunos dispositivos o proveedores, requieren una señal de llamada antes de poder
contestar. Notará que esto ocurre si pasa la llamada que está entrando a un teléfono, pero si la
deriva a un IVR, la llamada no será conectada.
Opciones.
o Sonido de alerta.
La información de alerta puede ser usada para un tono de llamada distintivo con ciertos
dispositivos SIP. Los nombres estándar son “Bellcore-dr1” a “Bellcore-dr7”. Algunos teléfonos
pueden utilizar una dirección URL de un archivo WAP ó MP3.
29 www.asterio.com.ar
Configuración
Follow me
Prefacio.
La configuración de “follow me” es
como un mini grupo de extensiones, pero
esta ligada directamente a una extensión. Se
configura de la misma manera en la que se
configura un grupo de extensiones,
incluyendo la prestación 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 función de follow-me para la extensión seleccionada.
www.asterio.com.ar 30
Asterisk® Desconsolado
o Listado de extensiones.
Aquí se agregan uno por línea, los números que se quiere hacer sonar. Si se ingresa un
número externo, debe agregarse el signo # al final.
o Estrategia de ring.
Ringallv2: Llama al primer número de la lista durante el tiempo establecido en “Initial
Ring Time”. Luego, llama a los demás números 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 terminación “prim”, se comportan del siguiente
modo:
Si el primer número posee la función DND activada, se aplicará a los demás números y por
lo tanto, no sonará ninguno.
o Announcement.
El sonido seleccionado de esta lista (previamente cargado en el módulo “Grabaciones del
Sistema”) será reproducido antes de marcar los números de la lista.
31 www.asterio.com.ar
Configuración
o Sonido de alerta.
La información de alerta puede ser usada para un tono de llamada distintivo con ciertos
dispositivos SIP. Los nombres estándar son “Bellcore-dr1” a “Bellcore-dr7”. Algunos teléfonos
pueden utilizar una dirección URL de un archivo WAP ó MP3.
o Confirm Calls?
Activar esta opción si se ingresaron a la lista follow-me números que necesiten ser
confirmados. La persona llamante deberá presionar 1 para que la llamada pueda ser realizada.
Esta función 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 número de
llamadas entrantes, como es de
esperarse en un call center ó en un
contact center. Esta es una
aplicación muy completa, y como
tal, tiene muchas opciones de
configuración.
o Cola número.
Este es el número a ser marcado desde cualquier extensión para ser ubicado en una cola.
Este también es el número que se usará para seleccionar un destino. Los agentes (las personas
que reciben las llamadas) ingresan y salen de las colas marcando el número, entonces, un sólo
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 pequeño nombre para la cola. Esto es únicamente utilizado en la interfase de la web
para una simple identificación.
o Miembros estáticos.
Los miembros estáticos son extensiones que se asume que siempre estarán en la cola.
Dichos miembros no necesitan ingresarse a la cola y tampoco se les permite salir de ella.
Se debe ingresar una extensión por línea. También es posible ingresar un número externo,
de ser así, es necesario contar con una ruta de salida válida para dicho número.
33 www.asterio.com.ar
Configuración
o Máximo de llamadas.
El número máximo de llamantes que se permite que esperen en la cola. Si este número es
alcanzado, cualquier persona que llegue después 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 dónde dejó de llamar en adelante.
o Reintentar.
La cantidad de segundos de espera antes de hacer sonar todos los teléfonos nuevamente.
o Tiempo de wrap-up.
Después 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 Grabación 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 posición.
Seleccione “si” (yes) para anunciar la posición de la llamada en la cola a la parte llamante.
35 www.asterio.com.ar
Configuración
Periodic Announcements
o Repeat frequency.
Es el intervalo de tiempo en que será reproducido el IVR seleccionado en la opción 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
Configuración
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 podría llamar a su Asterisk
y hacer una llamada desde el mismo Asterisk
como si usted estuviera utilizando una
extensión conectada con el mismo Asterisk
dentro de la empresa.
o DISA name.
Un nombre familiar para identificar el destino DISA fácilmente.
o PIN.
Una contraseña que es solicitada al llamante para acceder al tono de marcado. Usted
debería siempre solicitar una contraseña con el propósito 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 máxima cantidad de tiempo permitida entre dígitos que el llamante tiene cuando está
marcando un número.
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 Número de grupo.
Este es el número que es marcado desde cualquier extensión para que todos los teléfonos
del grupo llamen.
Estrategia de ring.
Ringall: Llama a todos los canales disponibles hasta que alguno conteste.
39 www.asterio.com.ar
Configuración
o Listado de extensiones.
Lista las extensiones a llamar, una por
línea. Usted puede incluir una extensión en
un sistema remoto, ó un número externo
mediante el sufijo de un número con un
numeral (#). Ejemplo: 2448089# marcará
2448089 en la troncal apropiada.
www.asterio.com.ar 40
Asterisk® Desconsolado
Callback
Información.
Esta opción consiste en llamar a un número 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 número ingresado en “callback number”
para establecer la comunicación anteriormente intentada por el llamante.
Una vez configurado el módulo, es necesario crear una ruta de entrada para que desvíe el
número del llamante al callback configurado.
Esta función puede ser útil para el ahorro en llamadas a teléfonos móviles.
41 www.asterio.com.ar
Configuración
Para generar una grabación, 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 página 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 compañía), para ventas marque uno,
para servicios marque dos”, etc.
Editar menú.
Ejemplo de configuración de un IVR.
o Change name.
Este es el título 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 serán capaces de marcar el código de prestaciones para el
directorio desde el IVR y acceder al servicio de directorio (ver “Código 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 número de opción para el usuario. Esto puede ser
uno, ó una serie de números.
i: Esto es el destino usado cuando un llamante ingresa una opción inválida – Si usted sólo
tiene 1;2 y 3 definidos, y el llamante pulsa 4, lo llevará a este destino i. La opción predefinida
para esto, si usted no ingresa ningún destino ‘i’, es repetir el presente menú. Si llegan al destino
‘i’ más 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 teléfono DTMF. Así
como ‘i’, la opción predefinida es repetir el menú, y si ha sido repetido tres veces, la llamada es
desconectada.
Obsérvese que con FreePBX 2.1 “Destinos” son sólo mostrados si al menos hay una entrada
creada. Por ejemplo, si usted no ha creado ninguna cuenta DISA, esta opción, no aparecerá en
“Destinos”.
43 www.asterio.com.ar
Configuración
Add Conference.
Detalles de la conferencia.
o Número de la sala.
Este es un número 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 número, cuando se selecciona
una conferencia como destino.
o PIN de usuario.
Si cualquiera de estas opciones están
activadas, cualquiera que llame a la
conferencia le será requerida una contraseña
PIN. Si el “user” es dejado en blanco, el
usuario sólo debe presionar # para
ingresarse a la conferencia. El único uso de Creación de una sala de conferencias
“admin” es no abrir una conferencia hasta
que el administrador halla llegado. Si la música en espera está activada, los usuarios serán
puestos en espera con una reproducción de la música hasta ese momento.
Opciones de la sala.
o Mensaje de entrada
Este es un sonido que escucharán 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 (número 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 Música en espera
Activa ó desactiva la música en espera en esta conferencia.
o Permitir menú
Le permite al usuario ó administrador ingresar a la administración de la conferencia
presionando *. Los comandos en el modo de administración son:
1: Silenciarse.
45 www.asterio.com.ar
Configuración
Destinos.
Usted tiene una elección sobre qué
destinos alcanzar, dependiendo de si el
tiempo es reconocido ó no. Usted puede
encadenar las condiciones de tiempo para
lograr un efecto de adición ó exclusión.
o Ejemplo de exclusión.
Supongamos que usted quiere que el
IVR1 funcione de Lunes a Viernes de 9am a 5
pm, ó los Sábados de 9am a 12pm y el resto
de los días que funcione el IVR2.
o Ejemplo de adición
Dentro de 9am y 5pm de Lunes a Miércoles, elíjase IVR 2, de otra forma elíjase IVR 1.
www.asterio.com.ar 46
Asterisk® Desconsolado
Misc destinations
Prefacio.
Los destinos misceláneos le permiten usar cualquier cosa que marque desde una extensión
estándar como un destino.
Ejemplo
Si usted quiere hablar con Juan, quizás prefiera tener una opción en el IVR que sea “Si
quiere hablar con el celular de Juan puede hacerlo marcando 2” y tener un destino misceláneo
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 configuración de contraseñas es un módulo que le permite usar un rango de contraseñas
en lugar de sólo una. Esto es únicamente utilizable por las troncales, pero puede ser usado en
DISA ó en cualquier otra cosa que requiera el uso de contraseñas para la autentificación.
47 www.asterio.com.ar
Configuración
www.asterio.com.ar 48
Asterisk® Desconsolado
Restricciones de acceso.
o Rango de la extensión.
Cuando un usuario está en el sistema, ellos sólo verán el rango especificado aquí. Esto es
práctico si usted está configurando muchos ocupantes en el sistema.
49 www.asterio.com.ar
Configuración
o Administrar accesos.
Esta es una sección de múltiples 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 líneas 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. También registra los errores que pueden inducir a un
malfuncionamiento, en el caso de encontrarse con un error, es una bitácora de la funcionalidad.
www.asterio.com.ar 52
Asterisk® Desconsolado
Asterisk API.
Este módulo 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 través de un stream sobre TCP/IP. Las
conexiones de los programa cliente se realizan mediante un usuario y contraseña. La
configuración 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 estén en uso en el momento.
restart gracefully: Deja de recibir llamadas, espera que el volumen de llamadas se vacíe 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 descripción.
logger reload: Vuelve a abrir los archivos log (ver apartado “Backup and Restore”).
1 Los valores indicados entre los símbolos “< >” representan las variables con las que los
comandos trabajan. Por ejemplo cuando se lee “soft hangup <channel>” “Channel” se
reemplaza por el número del canal sobre el que se quiere trabajar.
53 www.asterio.com.ar
Herramientas
save dialplan: Sobrescribe el archivo extensions.conf con una versión tomada de la actual
configuración de su plan de marcado. No hace una copia de sus archivos modificados. Los
valores inicales de las variables globales definidas en la categoría [globals] retienen sus valores
iniciales previos; los valores corrientes de las variables globales ahora están escritas en el nuevo
extensions.conf. Al utilizar “save dialplan” tendrá como resultado la pérdida de cualquier
comentario en su actual extensions.conf.
core set verbose <level>: Configura el nivel de mensajes verbales a ser mostrados. 0
significa que ningún 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 configuración 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 geográfica del origen de este mensaje. Si alguien en
un distinto huso horario le envía un mensaje, Asterisk tiene la capacidad de transformar el
horario en relación 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 información de Asterisk, como por ejemplo: Versión de Software, uptime del
sistema, canales activos, extensiones, troncales SIP y usuarios de correo de voz (voicemail), etc.
Código de discado rápido (speed dial code): Número de acceso rápido para la extensión.
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 tamaño 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 tamaño de su backup.
Sistem Configurations: Active esta opción para resguardar sus datos de configuración 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 opción para resguardar el FOP (Flash Operator Panel)
o Correr programación.
Usted puede elegir una programación pre-configurada desde el menú de selección, ó
configurar su propia programación utilizando minutos, horas, días, meses y fines de semana
desde la casilla de selección. Las opciones pre-configuradas son: Diario (al mediodía), Semanal
(Domingo ó Sábado), Mensual (En el primero de cada mes a la medianoche) ó Anual (el en
primero de Enero a la medianoche).
PHP Info.
Muestra la información sobre el módulo de PHP instalado en el equipo.
www.asterio.com.ar 56
Asterisk® Desconsolado
Sys Info.
Muestra información completa sobre el sistema. Es importante controlar el espacio en el
disco y el uso de la memoria en forma periódica 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 información de las extensiones, colas, IVR y hasta de la configuración
del hardware.
Esta herramienta permite editar los archivos de configuración 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 configuración 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 gráfica web para administrar de forma sencilla la base de datos MySQL.
System Status.
Muestra el tiempo transcurrido desde el último inicio del sistema. Permite además 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 través del sistema, en la base de datos asteriskcdrdb, a la cual es posible acceder
utilizando phpMyAdmin (ver capítulo anterior).
59 www.asterio.com.ar
Informes
Dentro del módulo de informes se accede a un programa amigable que permite visualizar
la información 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 búsqueda.
Filtros
Los filtros se aplican a fin de acotar el resultado de una búsqueda, facilitando de esta
manera la confección de estadísticas que ayudarán a controlar el uso y costo de las
comunicaciones.
o Destination
Toma la información realizada solo al destino ingresado. Hay cuatro maneras distintas de
buscar el número ingresado:
• Exact: Devuelve los registro de la base de datos que coincidan con el número
ingresado.
• Begins with: Devuelve los registros cuyo destino comienza con el número
ingresado. Por ejemplo, para conocer el caudal de llamadas a celulares, basta
ingresar 915 seleccionando esta opción.
www.asterio.com.ar 60
Asterisk® Desconsolado
o Source
Toma la información de las comunicaciones realizadas por el número 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 relación con la duración. Se
pueden filtrar las llamadas respecto a la cantidad de minutos de comunicación para buscar
llamadas en particular.
Módulos
Esta aplicación tiene cuatro módulos distintos que organizan la información de acuerdo a
diferentes parámetros.
o Call Logs
Devuelve la información detallada de las comunicaciones efectuadas de acuerdo a los
filtros aplicados a la búsqueda, en forma de tabla. Las columnas de fecha, número marcado y
tiempo de conversación pueden ordenarse de manera ascendente ó descendente haciendo clic
en el título de la columna.
$appli_list['numero’]=array("nombre");
o Compare Calls
Devuelve un gráfico 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 línea representa un día.
61 www.asterio.com.ar
Informes
o Monthly Trafficc
Devuelve un gráfico en forma de torta que representa el tiempo de comunicación según los
filtros aplicados, en relación a los meses seleccionados.
o Daily Load
Devuelve un gráfico en forma de barras que representa la cantidad de comunicaciones
efectuadas por hora a lo largo del día 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.
Asegúrese de tener un usuario con privilegios de administrador de Asterisk. Simplemente
edite /etc/asterisk/manager.conf y agregue uno si no lo hizo aún.
• 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á diseñado para manejar comunicaciones con múltiples 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
especificación de estos parámetros:
• flash_dir: Debe ser la dirección exacta del directorio donde está ubicado el
archivo operator_panel.swf. Siguiendo estos ejemplos, debería apuntar a
/var/www/html/panel
Las versiones más novedosas de Asterisk deberían funcionar bien sin tomar
estadísticas muy seguido, ya que el administrador genera eventos
(register/unregister/lagged) por si mismo. Si usted tiene muchos SIP e IAX2,
considere configurar la toma de estadísticas a un valor más alto. (Ejemplo: 7200)
porque el Server utiliza muchos recursos para hacer esto, y los eventos son
enviados de todas maneras por Asterisk.
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, configúrelo en 3
(1+2). Si usted quiere un debug completo, configúrelo 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 número de la extensión
debe coincidir el número 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 Configuración 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 configuración 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
posición de la cabecera (header) usted seleccionará el tipo de botón. La sintaxis para los canales
SIP es SIP/username (SIP/nombre de usuario). Para ZAP es ZAP/channelnumber
(ZAP/número 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. También 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 número del botón. Los botones están dibujados desde arriba hacia abajo y de
izquierda a derecha. El número total de botones depende del tamaño y del “padding” (Esto es
el espacio vacío, 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 botón tiene
más de una posición definida, será tratado especialmente: si es un canal regular, se
69 www.asterio.com.ar
Flash Operator Panel
Panel_Context: Desde la versión .10 usted dispone de “contextos” de panel. Esto significa
que solo correrá un solo servidor, y habrán varios clientes Flash con diferentes disposiciones de
botones conectados a este servidor. Si usted omite este parámetro el contexto preconfigurado
será el aplicado. Para especificar el contexto a cargar en el Flash, usted tiene que modificar la
página que carga el archivo swf. Sólo agregue “?context=mycontext” después de cada aparición
de “operator_panel.swf”.
Target: Esto sirve para configurar el vínculo (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 botón. 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 configuración con una codificación UTF-8. Para convertir el archivo a
UTF-8 utilizando vi (El programa de Linux para editar texto) y la línea de comando, sólo haga:
Obsérvese que la etiqueta del botón 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 botón, configúrelo en cero ó simplemente borre la línea del icono para ese botón en
particular.
1 2 3 4 5 6
www.asterio.com.ar 70
Asterisk® Desconsolado
Tipos de botones.
o Conferencias.
Para hacer un botón para una sala de conferencia, el nombre del canal debe ser sólo el
número de la conferencia. Ese botón mostrará el número de personas dentro de la sala de
conferencia. Si usted tiene un número 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 botón para una cola, el nombre del canal deberá ser el nombre de la cola
prefijado con ‘QUEUE/’. El botón mostrará el número de personas esperando en la cola, y el
máximo de tiempo de espera presente. Por ejemplo, si usted tiene una cola llamada “ventas”, la
configuración del botón 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 posición 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) serán ocupados, uno por cada
persona, en las posiciones que hay para esa cola (slot 1 para la posición 1, slot 2 para la posición
2, y demás). El botón de posición en la cola muestra el número de identificación de llamadas, el
nombre y la cantidad de tiempo de espera para cada persona. Para definir los botones de
posición de cola, el nombre del canal es el mismo que el de la cola, pero usted tiene que usar
más de una posición para ese botón (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 botón 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 estáticamente, sin preocuparse por el método 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 número.
[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 botón 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 simultáneamente ó
nombres de canales dinámicamente generados. Las expresiones comunes (Regular Expressions)
www.asterio.com.ar 72
Asterisk® Desconsolado
pueden resultar adecuadas. Para utilizar una expresión común 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 botón estándar. Sólo use TECHNOLOGY/channel_name. Algunos tipos de
TECH requieren una conversión nominal especial como se ve en los ejemplos de abajo. Si un
botón utiliza solo una posición, acumulará todas las actividades de las líneas en ese botón
(existen teléfonos con la capacidad de tener más de una llamada por vez). Si usted utiliza más
de una posición, se comportarán 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 más de una posición para un botón será considerado como una
troncal. Un botón normal mostrará instancias del mismo nombre de canal en ese único botón.
En un botón de troncal, cada instancia será mostrada en el siguiente botón disponible para esa
troncal. Si usted tiene un DID desde un proveedor IAX2 ó SIP, y recibe más de una llamada de
ese usuario, usted debe definir ese botón 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, sólo ajuste el btn_heigt a un valor menor.
Usted puede cambiar este archivo con el Panel de operador Flash (op_panel.pl)
funcionando. Después de cambiar un valor, usted debe decirle al servidor que actualice la
configuración mediante el envió de una señal HUP (killall –HUP op_server.pl). Después de eso,
usted necesita recargar el display de Flash, haciendo click en el botón de “reload” ó
simplemente recargando la página.
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” proveída)
exten=>s,102,goto(s,4)
; ocupado desde marcado
exten=>s,105,Voicemail(b${MACRO_EXTEN})
exten=>s,106,Hangup
Usted también puede utilizar la aplicación 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
parámetro del botón es opcional, restringirá el ppopup a clientes Flash cargados con
“mybutton” ó restringido a ese número de botón. 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 también (pero el estado no
será guardado entre recargas)
exten=>1,1,UserEvent(FOP_ledcolor|Color: 0x0000FF^State: 0)
Encendiendo el servidor.
Asegúrese de configurar el bit ejecutable en op_server.pl, si no está configurado (chmod
a+x op_server.pl). Y verifique la ubicación 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 sólo 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 línea 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
debería verse de esta manera:
Usted puede correr el servidor desde su script rc.local para tenerlo corriendo en el startup.
También hay ejemplos de init script en el directorio init si usted prefiere utilizar su sistema init
distro. Asegúrese de encender op_server.pl después de Asterisk. Si usted reinicia Asterisk, el
op_server intentará reconectarse 60 veces con intervalos de diez segundos (diez minutos). Si
falla en la conexión después de esos intentos, se apagará.
El panel puede ser activado tanto para el FreePBX, mediante la selección de la opción 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 rápidas.
• Cuando el canal está ocupado, ó hay alguien en una conferencia ó cola, el botón
será rojo.
• Cuando pase el puntero del Mouse sobre un botón, si existe actividad en ese
botón, podrá leerla en la barra de estado, que es la barra gris sobre los botones.
• Antes de realizar alguna acción sobre un canal, usted deberá ingresar el código
de seguridad. Si el código no es reconocido, sus acciones serán ignoradas.
Usted puede tener una página web con los detalles del cliente antes de atender la llamada.
Esta prestación fue introducida en la versión 0.11 del panel de operador Flash. Para configurarla
usted deberá especificar algunas variables en la página HTML que carga el panel de operador
Flash:
• “url”: La dirección URL que usted desea traer cuando la extensión 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 botón bajo
monitoreo, ó otro usuario, etc. puede utilizarse el método 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 dirección URL está vacía, la
prestación de software de administración 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 actualización automática de páginas.
• Activación de callforward.
79 www.asterio.com.ar
Grabaciones
• Soporte de PHP5.
Configuración.
Ubíquese en /var/www/html/recordings/includes
La forma preconfigurada del IGN para el monitoreo de llamadas le permitirá ver las
llamadas de la extensión que esté ingresada en la página web.
Si usted prefiere que ciertas extensiones vean todas las llamadas en el monitor de llamadas
de ARI, configúrelo 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,
configúrelo como $callmonitor_admin_mailboxes a “todos” (all)
Buzón de voz.
En esta pantalla se muestran los últimos mensajes de voz recibidos. Para escucharlos, basta
hacer click en el vínculo escuchar como se ve en la figura. Los mensajes pueden borrarse,
moverse a otra carpeta o reenviarlos a otra extensión. También 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 extensión que
ingresó al ARI. Para las conversaciones que hayan sido grabadas (ver capítulo funciones)
muestra un vinculo en la última columna que permite escucharla.
81 www.asterio.com.ar
Grabaciones
Opciones
En esta página, 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 página principal de Trixbox y haga clic
en el vínculo que dice “Web MeetMe Control”.
Luego, coloque el número 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 extensión solo pueda escuchar la conversación pero
sin participar en ella.
83 www.asterio.com.ar
Funciones de llamada
Funciones de llamada
En este capítulo se detallan las funciones ya programadas en Asterisk. Para el acceso a ellas,
se considera que no se realizaron cambios en el módulo features codes.
Redirección de llamada.
Desvía las llamadas que entran a una extensión a otra o a un número externo.
*92: Igual que *91 pero preguntando la extensión 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 comunicación.
Una señal acústica 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 función desconecta el teléfono impidiéndole recibir llamadas.
Servicios.
*43: Prueba de eco. Esta función permite verificar el tiempo de latencia entre la extensión y
Asterisk. Es útil para verificar el retardo en las extensiones remotas (SIP o IAX2).
*60: Reproduce un mensaje que señala la hora del servidor donde corre Asterisk.
*62: Función de llamada despertador. Al marcar esta combinación, usted deberá ingresar 4
números para indicar la hora a la que desea que entre una llamada a su extensión.
Discado rápido.
El discado rápido consiste en memorizar un número de teléfono en otro de 3 cifras,
agilizando así el proceso de marcado. Existen dos tipos de discado rápido. Uno de acceso a
todos los usuarios y desde cualquier extensión. Quiere decir, que es posible configurar hasta 100
números de discado rápido para todas las extensiones de la empresa. Aquí deberían ingresarse
los números de uso común entre los empleados. Se configura de la siguiente manera:
*3nn: Reproduce un mensaje que reproduce el número asignado al discado rápido 3nn.
La otra forma, es reservada para cada extensión. Quiere decir, que cada extensión cuenta
con 100 números de marcado. Los cuales pueden ser configurados solo por la extensión que
hará uso de él. Se configura de la siguiente manera:
*5nn: Reproduce un mensaje que dice el número asignado al discado rápido 5nn.
85 www.asterio.com.ar
Funciones de llamada
En ambos casos, para ingresar a su casilla, se le solicitará ingresar su contraseña. 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 contraseña.
*: Ayuda
#: Salir
www.asterio.com.ar 86
Asterisk® Desconsolado
Colas.
XXX*: Para ingresar la extensión a la lista de agentes de una cola. Donde XXX es el número
para acceder a la cola.
Lista negra.
Esta función agrega un número a elección 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 número fue estacionada. Para tomarla, basta
marcar ese número desde cualquier extensión.
Grabaciones.
*1: Cuando es marcado graba la llamada hasta que finalice la comunicación. Para escuchar
las grabaciones se utiliza el ARI.
Para habilitar esta función, es necesario colocar una w en las opciones de marcado del
módulo “opciones generales” (ver capítulo configuración).
87 www.asterio.com.ar
Misceláneos
Misceláneos
Instalación de un softphone.
Un softphone es un programa que emula un teléfono 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 comunicación.
Existe una gran cantidad de compañías 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
Misceláneos
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
Misceláneos
Haga clic en “add” para configurar x-lite con los datos correspondientes a la extensión SIP
creada previamente en Asterisk.
www.asterio.com.ar 92
Asterisk® Desconsolado
93 www.asterio.com.ar
Misceláneos
En el caso de tener un firewall activo (en este caso el de Windows), veremos un mensaje
como este:
Si todo salió bien, deberíamos 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 mayoría de las interfases
de correo de voz basadas en formato web disponibles, Tycho es una aplicación nativa de
Java/Eclipse, y como tal, resulta en una solución más amigable con el usuario.
• Facilidad en el uso
• Facilidad en la personalización
95 www.asterio.com.ar
Misceláneos
Funcionamiento
Como ya se mencionó, Tycho es una aplicación cliente basada en Java/Eclipse, que
funciona en su computadora local y simultáneamente una serie de scripts php de Server,
llamados “VMXML”, funcionando en su servidor Asterisk bajo un servidor web Apache.
Esta serie de scripts php actúan como una disposición abstracta entre el sistema de correo
de voz de Asterisk y el correo de voz cliente de Tycho, a través de la provisión de acceso al
sistema de correo de voz de Asterisk.
Voicemail2xml
“Voicemail2xml” es un conjunto de scripts php los cuales permiten el fácil acceso y
manipulación de los archivos de correo de voz de Asterisk. Los scripts trabajan con una
autenticación 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
teléfonos móviles potenciados por
Symbian. Su versión beta es escrita y
mantenida primordialmente por
Simón Tatham, es de código abierto y
está licenciado bajo una licencia del
MIT.
www.asterio.com.ar 96
Asterisk® Desconsolado
WinSCP
WinSCP es una aplicación de Software Libre. WinSCP es un cliente SFTP gráfico para
Windows que emplea SSH. El anterior protocolo SCP también puede ser empleado. Su función
principal es facilitar la transferencia segura de archivos entre dos sistemas informáticos, el local
y uno remoto que ofrezca servicios SSH.
97 www.asterio.com.ar
Glosario
Glosario
En esta sección usted encontrará los términos comúnmente utilizados para explicar la
configuración y funcionamiento de su sistema Asterisk. Algunos de estos términos no son de
uso común para las personas que no estén tan familiarizadas con la administración de sistemas
de comunicaciones, por esto es que aquí se le brindan las aclaraciones para comprender
completamente el funcionamiento y operación de sus sistema Asterisk, así como para poder
comprender este manual y aplicarlo para la operación del sistema.
• VoIP: Es la sigla para “Voice Over Internet Protocol”. Es lo que lleva llamadas
telefónicas a través de redes de datos como redes corporativas ó la Internet.
• Asterisk PBX: Un software gratuito que funciona para Linux y Unix. Conecta
llamadas a través del protocolo de voz sobre IP (VoIP) y sistemas telefónicos
tradicionales (PSTN).
• Bri: Tasa básica de ISDN. Es un método común para conectar pequeñas partes del
sistema VoIP con instalaciones PBX a la red de telefonía tradicional (PSTN), y
también es una plataforma para el sistema de respuesta de recepcionista digital
(IVR). Una línea Bri carga dos llamadas simultáneamente.
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 menús de voz ó aplicaciones
mediante la navegación por el teclado del teléfono.
• SIP: Es la sigla para “Session Initiation Protocol”. El protocolo más popular para
VoIP, utilizado por la mayoría de los productos VoIP y VSP.
• 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 telefonía para marcar
un número telefónico.
99 www.asterio.com.ar
Epílogo
Epílogo
Este manual se escribió teniendo en cuenta las necesidades de un administrador y usuario
del sistema de comunicaciones Asterisk. Está pensado para la correcta implementación del
sistema y su uso más efectivo.
Los autores de este volumen son Eduardo Federico Viegas y Facundo Hernán Correa,
integrantes de Asterio (http://www.asterio.com.ar) , una organización 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í también, como con el desarrollo para continuar
el firme avance que está teniendo la separación de los sistemas que prestan servicios de
comunicación de las empresas que no prestan ayuda al desarrollo de las mismas
comunicaciones.-
www.asterio.com.ar 100