Manual para administradores y usuarios de Trixbox,
el Asterisk sin consola. Queda prohibido cualquier uso o explotacin por cualquier medio, sin el consentimiento previo y por escrito de Asterio o sus autores, de cualquier contenido incluido en Asterisk desconsolado. El diseo y contenido de Asterisk desconsolado se encuentra registrado en la Direccin Nacional del Derecho de Autor con lo establecido por la ley11.723 de propiedad intelectual y por la ley 22.362, quedando prohibido: modificar, copiar, distribuir, transmitir, desplegar, publicar, editar, vender, o de cualquier forma explotar el diseo y contenido de Asterisk desconsolado. .
1
ndice Introduccin..................................................................................5 Qu es PBX?.............................................................................. 6 Asterisk: El PBX profesional. ......................................................... 6 Instalacin ....................................................................................7 Puesta en marcha. ....................................................................... 7 Cambiar la direccin ip ................................................................. 8 Cambiar contraseas.................................................................... 8 Configuracin..............................................................................10 Extensiones extensions ...............................................................12 Informacin. .............................................................................12 Prefacio....................................................................................12 Aadir una extensin...................................................................13 Nmero de extensin...................................................................14 Contrasea (secret). ...................................................................14 Nombre completo. ......................................................................14 Grabacin entrante. ....................................................................14 Grabacin saliente. .....................................................................14 Buzn de voz (voicemail) y directorio...............................................14 Contrasea del correo de voz (voicemail password).............................15 Direccin de e-mail. ....................................................................15 Direccin de e-mail de pager. ........................................................15 Reproducir CID. .........................................................................15 Reproducir fecha y hora (envelope).................................................15 Borrar buzn de voz (voicemail). ....................................................15 Feature codes.............................................................................16 Informacin. .............................................................................16 Configuraciones generales - general settings .................................16 Opciones de marcado. .................................................................16 Correo de voz............................................................................17 Directorio de la empresa...............................................................17 Mquina de Fax..........................................................................17 International Settings..................................................................18 Security Settings........................................................................18 Rutas salientes - outbound routes.................................................19 Prefacio....................................................................................19 Aadir ruta de salida (Add route)....................................................19 Troncales trunks.........................................................................21 Configuraciones generales de troncales. ...........................................22 Configuracin troncales ZAP:.........................................................23 Configuracin para troncales SIP e IAX2:..........................................23 Lista negra Blacklist....................................................................26 Fuentes de bsqueda de nombres de llamados Caller Name Lookup Sources. ....................................................................................26 Rutas entrantes - inbound rout es..................................................28 Prefacio....................................................................................28
2
Aadir una ruta entrante. .............................................................28 Configuracin del fax...................................................................28 Privacidad.................................................................................29 Opciones. .................................................................................29 Configurar destino (Set destination). ...............................................29 Follow me ..................................................................................30 Prefacio....................................................................................30 Edit Follow Me. ..........................................................................30 Destino si nadie atiende. ..............................................................31 Colas queues ..............................................................................31 Prefacio....................................................................................31 Aadir cola. ..............................................................................31 Opciones del grupo. ....................................................................33 Anuncios a los llamantes. .............................................................34 Destino en caso de no ser atendido. ................................................34 DISA.........................................................................................35 Prefacio....................................................................................35 Aadir DISA..............................................................................35 Grupos de extensiones - ring groups .............................................36 Prefacio....................................................................................36 Aadir grupo de extensiones (add ring group)....................................36 Destino si nadie atiende. ..............................................................37 Callback.....................................................................................38 Informacin. .............................................................................38 Grabaciones de sistema - system recordings ..................................39 Informacin. .............................................................................39 IVR - Digital Receptionist.............................................................40 Prefacio....................................................................................40 Editar men. .............................................................................40 Opciones de su IVR.....................................................................40 Salas de conferencia - conferences................................................41 Prefacio....................................................................................41 Add Conference..........................................................................41 Opciones de la sala. ....................................................................42 Horarios - time conditions............................................................43 Informacin. .............................................................................43 Aadir sistema horario.................................................................43 Destinos...................................................................................43 Misc destinations ........................................................................44 Prefacio....................................................................................44 PIN sets ....................................................................................44 Gestin de usuarios - administrators ............................................45 Restricciones de acceso................................................................45 Msica en espera - music on hold..................................................45 Informacin. .............................................................................45 Subiendo un archivo....................................................................45 Herramientas ..............................................................................46 PHP Info....................................................................................47 .
3
Directorio telefnico. Asterisk Phonebook......................................47 Prefacio: ..................................................................................47 Asterisk Logfiles. ........................................................................48 Sys Info.....................................................................................48 Java SSH....................................................................................49 Asterisk CLI. ..............................................................................49 Asterisk Information. ..................................................................51 Edit Configuration. ......................................................................51 phpMyAdmin. .............................................................................51 System Status. ...........................................................................51 Backup & Restore. ......................................................................51 Module Admin.............................................................................52 Informes......................................................................................53 Filtros......................................................................................54 Mdulos ...................................................................................55 Flash Operator Panel ..................................................................58 Configuracin del panel de operador Flash ........................................59 Configuracin del cliente del FOP. ...................................................63 Encendiendo el servidor. ..............................................................71 Acciones ..................................................................................72 Referencias rpidas.....................................................................72 Integracin con software de administracin de relaciones con el cliente. ...73 Grabaciones.................................................................................74 Prestaciones:.............................................................................75 Configuracin. ...........................................................................75 Buzn de voz.............................................................................75 Registro de llamadas. ..................................................................76 Opciones..................................................................................77 Web MeetMe Control...................................................................79 Funciones de llamada.................................................................81 Redireccin de llamada. ...............................................................81 Llamada en espera......................................................................81 No molestar (DND). ....................................................................82 Servicios. .................................................................................82 Discado rpido...........................................................................82 Mensajes de voz (voicemail)..........................................................82 Colas.......................................................................................83 Lista negra................................................................................84 Transferir una llamada.................................................................84 Estacionamiento de llamada. .........................................................84 Grabaciones. .............................................................................84 Miscelneos.................................................................................85
4
Instalacin de un softphone. ........................................................85 Tycho ........................................................................................92 Las prestaciones que ofrece Tycho son:............................................92 Funcionamiento .........................................................................92 Gua de instalacin para VMXML.....................................................93 Voicemail2xml ...........................................................................93 Putty.........................................................................................93 WinSCP......................................................................................94 Glosario .......................................................................................95 Eplogo.........................................................................................97
. Introducci n
5
Introduccin Cuando en los requerimientos de comunicaciones en su empresa se ponen en juego la administracin de un volumen de amplio espectro de variedad y cantidad de llamadas, la disponibilidad de administrar correctamente las comunicaciones se convierte en una prioridad. Desde la calidad de las llamadas, su distribucin en los distintos sectores, los registros y costos Asterisk es el sistema que le permitir poder tener el mayor nivel de control y prestaciones. Lo que convierte a Asterisk en el sistema de comunicaciones que le permite lograr este control y este nivel de prestaciones es la caracterstica de ser un sistema de cdigo abierto. El cdigo abierto tiene la potencialidad de ser adaptable a cualquier necesidad. Con este sistema usted puede lograr que todas las medidas que requieran ser aplicadas lo sean de manera efectiva y a su medida, sin costos adici onales ni de mantenimiento. Cada particularidad puede ser atendida sin restricciones de compatibilidad costo. Contando con este sistema usted podr conseguir llevar adelante las cientos de comunicaci ones de las ms variadas caractersticas con los costos ms bajos que pueda conseguir en el mercado mundial. Desde llamadas internacionales IP con una calidad de sonido impecable, conferencias, monitoreo de llamadas, ingreso a la red celular de cualquier pas a costos locales, un sistema de recepcionista virtual con men interactivo, hasta notificaciones de correo de voz personalizadas transferencias personalizadas; asegurndose de no perder ninguna llamada importante estar al corriente de cualquier eventualidad. La caracterstica nica de Asterisk de ser de cdigo abierto, le permite adaptarlo a cualquier sistema que ya est utilizando su empresa, ya sea una base de datos telfonos virtuales, sin que su fabricante, modelo compatibilidad sean un inconveniente. Usted podr integrar estos sistemas a su sistema de comunicaciones Asterisk de forma efectiva y funcional. El presente manual es una gua para lograr esto. Una gua de usuario para poder configurar este sistema y adaptarlo a sus necesidades una vez instalado.
Qu es PBX?
6
Con este manual podr hacer funcionar su sistema Asterisk de la manera en que crea ms conveniente. 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 al llegar al fin del manual. 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. Asterisk: El PBX profesional. Cmo funci ona Asterisk? Esencialmente, Asterisk es un software de conectividad entre las distintas tecnologas telefnicas o canales y las aplicaciones vinculadas a la telefona, como por ejemplo, las conferencias, transferencia de llamadas, IVR, etc. 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 que slo Asterisk puede manejar. Este nivel de aceptacin suceder mucho ms rpido que el caso de Linux, por las siguientes razones: Linux ya inici el camino que lleva a la aceptacin del software de cdigo abierto, por esto Asterisk puede seguir por este camino. La industria de telecomunicaciones est estancada, sin liderazgo provisto por los principales protagonistas de esta industria. En comparacin, Asterisk es una visin con una proyeccin enorme y excitante. Los usuarios finales estn cansados de problemas de compatibilidad, funcionalidades limitadas y una infraestructura de atencin al cliente insufrible. Asterisk responde a las dos primeras necesidades, y con respecto al tercero, la comunidad ha mostrado una pasin por el despus. 1. Instalaci n
7
1 Instalacin La instalacin de este equipo debe tratarse de la misma manera y con los mismos cuidados que la depositada a la hora de instalar cualquier servidor. Si su equipo cuenta con mdulos para manejar lneas analgicas, debe tenerse en cuenta que estos disipan gran cantidad de calor. Es recomendable que los procedimientos que siguen abajo sean realizados por una persona que ya est familiarizada con la administracin de sistemas en Linux. Igualmente los pasos a seguir son simples y la terminologa utilizada no escapa a la de uso frecuente entre administradores de sistemas. Puesta en marcha. Para que este sistema pueda funcionar dentro de su red local, es necesario configurar ciertos parmetros iniciales referentes a la comunicacin y seguridad del equipo. Conecte un teclado, un monitor y un cable de corriente como lo hara con una PC. Conecte el equipo al switch de la red de su oficina y encienda el equipo. Una vez que el equipo muestre solo el texto login as escriba root y presione enter. A este punto, le ser solicitada la contrasea, entonces escriba password.
Cambiar la direccin ip
8
Cambiar la direccin ip Tomaremos como ejemplo una oficina que haya adoptado una topologa de red del tipo 192.168.10.X con una mscara de subred 255.255.255.0 y quiere asignarse a Asterisk la ip 192.168.10.4, para ello bastar entonces escribir la siguiente lnea y presionar enter. ifconfig eth0 192.168.10.4 netmask 255.255.255.0 Y para asignar la puerta de enlace a 192.168.10.1 basta correr la siguiente lnea. route add default gw 192.168.10.1 Cambiar contraseas. Existe una serie de comandos para cambiar las contraseas del sistema y la de las aplicaciones Web que se corren en l. Al ejecutar estos comandos, ver un mensaje como este: ------------------------------------------- Set password for AMP web GUI and maint GUI User: maint ------------------------------------------- New password: Re-type new password: Updating password for user maint passwd: Cambia la contrasea del sistema. passwd-maint: Cambia la contrasea que utilizar para ingresar a freepbx. passwd-amp: Es un usuario con menos privilegios que maint. La diferencia est en que amp no puede acceder a la seccin de mantenimiento. passwd-meetme: Cambia la contrasea para entrar al meetme desde http://192.168.10.4/meetme (siguiendo con el ejemplo anterior). Una vez hecho todo esto, usted ya est en condiciones de acceder a su sistema desde cualquier equipo de su red local escribiendo la ip (en este caso la 192.168.10.4) en un navegador web. Si todo sali bien, ver una pantalla como esta: 1. Instalaci n
9
Si usted es nuevo en Linux en Asterisk, aqu le presentamos una serie de comandos que pueden llegar a ser tiles. df-h Espacio disponible en el disco rgido de su sistema. ssterisk-r: Corre la lnea de comando de interfase de Asterisk (CLI) despus del ingreso como raz. quit: Sale delicadamente de Astersik CLI. amportal restart: Reinicia Asterisk y FOP /etc/webmin/start: Inicia el webmin, la navaja suiza de Linux. shutdown h now: Cierra el sistema inmediatamente. shutdown r now: Reinicia el equipo instantneamente. vi fielname: Edita cualquier archivo en su sistema. cd dirname: Cambia a otro directorio bajo el presente directorio. cd /dirname: Cambia a otro directorio bajo el directorio raz. ls: La equivalencia el linux a Dir para ir al listado de directorios. cd /var/lib/asterisk/agi-bin: El hogar de los scripts para las aplicaciones Asterisk cd /var/lib/asterisk/sounds Hogar de Alison y todas las voces que hacen los anuncios en el sistema de Asterisk cd /etc/asterisk: Hogar de todos los archivos de configuracin de Asterisk, Trixbox y freePBX.
Cambiar contraseas.
10
3 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.
3. Confi guraci n
11
Luego haga click en System Administration y escriba maint en nombre de usuario y la contrasea que haya elegido al correr el comando passwd-maint durante los primeros pasos de la instalacin. Finalmente, haga click en FreePBX.
Extensiones extensions
12
Seguidamente se explicar cada mdulo que compone a freePBX. No existe un orden preestablecido en el que deban configurarse, ya que depender de las necesidades de cada empresa, pero se intent ordenarlos en forma tal de comprender fcilmente la interaccin entre ellos. En general, la configuracin de un solo mdulo no tiene efectos en la configuracin del sistema por si solo, en la mayor parte de los casos, necesita complementarse con otros. Por ejemplo, si se configuran troncales para recibir y/o hacer llamadas, no podrn utilizarse sin configurar rutas salientes y/o entrantes. En el siguiente grfico se muestra un ejemplo de configuracin donde puede apreciarse la coparticipacin entre los mdulos de freePBX. 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 extensi ons 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.
3. Confi guraci n
13
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). Esta pgina tambin configura cmo el correo de voz (voicemail) que est asociada a la extensin creada. Aadir una extensin. Tipo de dispositivo. Elija entre SIP, ZAP, IAX2 personalizado (custom) SIP es Protocol o de Inicializacin de Sesiones, para telfonos IP o softphones. IAX2 es el Inter Asterisk Protocol, un nuevo protocol o manejado por slo unos pocos dispositivos. Telfonos de base PA1688, el IAX2 y ATA ZAP es un hardware conectado a su central Asterisk. Ej.: un TDM400, TE11P. Se utiliza para manejar telfonos analgicos. Personalizada (custom) es un adaptador para cualquier dispositivo no estandarizado, ej.: H323. Tambin puede ser usado para trazar un mapa de una extensin a un nmero externo. 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.
Extensiones extensions
14
Nmero de extensin. Esto 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. 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. Nombre completo. Esto es el texto del identificador de llamadas 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. 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. Buzn de voz (voicemail) y directorio.
Parmetros a configurar en el caso de haber seleccionado un dispositivo SIP. 3. Confi guraci n
15
Al seleccionar habilitado se mostrarn las opciones para configurar el buzn de voz para la extensin que se est creando. Contrasea del correo de voz (voicemail password). Esta es la contrasea para acceder al sistema de correo de voz (voicemail). Puede ser cambiada por el usuario cuando ingresa en su buzn de voz marcando *98. Para hacer esto, luego de ingresar, se debe presionar cero y luego cinco. Direccin de e-mail. Las direcciones a las que el correo de voz (voicemail) enviar las notificaciones cuando haya un nuevo correo almacenado. Direccin de e-mail de pager. Esta es la direccin de e-mail a la que se enviar una pequea notificacin sobre el mensaje en la casilla del buzn de voz (voicemail), adaptable para un servicio de e-mail a pager. 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. Reproducir fecha y hora (envelope). Esta opcin controla si el sistema reproducir no la fecha y hora (envelope) del mensaje antes de reproducir el mensaje. Esta configuracin no tiene efecto sobre la operacin de la opcin de envelope en el men advance del buzn de voz (voicemail). Borrar buzn de voz (voicemail). Si est seleccionado en yes el mensaje ser borrado de la casilla de correo de voz (voicemail) despus de que se haya enviado por e-mail. Esta funcin provee la funcionalidad que le permite al usuario recibir su correo de voz (voicemail) nicamente por e-mail, en lugar de recuperar el mensaje desde la web la extensin. Precaucin: Usted debe tener el la configuracin de e-mail en yes si no quiere que el sistema le enve una notificacin que diga Usted tiene un correo de voz e inmediatamente despus borre el buzn de voz. Asegrese de haber revisado voicemail-to-e-mail antes de activar este comando.
Configuracin del voicemail.
Feature codes
16
Feature codes Informacin. Este mdulo permite personalizar los nmeros que se deben marcar para acceder a las funciones de Asterisk. La descripcin detallada de estas funciones puede encontrarse en el captulo funciones. Configuraciones generales - general setti ngs Opciones de marcado. 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: A(x) Reproducir un anuncio a la parte llamada utilizando x como el archivo. C No guarda registro de las llamadas en la base de datos. D([llamado][:llamante]) Enviar las lneas DTMF especificadas despus de que la parte llamada haya contestado, pero antes la llamada es puenteada. La denominada lnea DTMF es enviada al llamado, y la denominada lnea DTMF es enviada a la parte llamante. Ambos parmetros pueden ser utilizados solos. h Permite a la parte llamada cortar mediante el envo del dgito * DTMF. H Permite a la parte llamada cortar presionando el dgito * DTMF. r Indica llamado a la parte llamada. No transmite audio a la parte llamada hasta que el canal del llamado haya contestado. t Permite a la parte llamada transferir a la parte llamante mediante el envo de la secuencia DTMF definida en la configuracin de prestaciones. T Permite a la parte llamante transferir la parte llamada mediante el envo de la secuencia DTMF definida en la configuracin de prestaciones. w Permite a la parte llamada iniciar la grabacin de la llamada mediante el envo de la secuencia DTMF definida para la grabacin por un botn en la configuracin de prestaciones. W Permite a la parte llamante iniciar la grabacin de la llamada mediante el envi de la secuencia DTMF definida para la grabacin por un botn en la configuracin de prestaciones. 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 3. Confi guraci n
17
Asterisk Outbound Dial command options. Se configura de la misma manera que el punto anterior, pero para las llamadas salientes. Correo de voz. Segundos que los telfonos llamarn antes de enviar el llamado al correo de voz. Esto es razonablemente explicativo en s mismo, con la excepcin de que esta cantidad es tambin utilizada para determinar la cantidad de tiempo en que cada telfono sonar en un grupo de llamada en un grupo de nmeros asociados en la memoria del grupo de llamada. Prefijo de extensin para acceder directamente al correo de voz. Anteponiendo este prefijo a la extensin, no llamar pero transfiere directamente la llamada al correo de voz (voicemail). Direct Dial to Voicemail message type Use esta opcin para cambiar el mensaje que se reproducir cuando el llamante entre a la casilla de correo de voz. Use gain when recording the voicemail message (optional) Use esta opcin si desea grabar los mensajes de voz con un volumen determinado. Directorio de la empresa. Hallar usuarios en el Directorio de la empresa por... Con esta opcin, se cambia la forma en la que Asterisk busca en el directorio de la empresa. Cuando un usuario entra al directorio marcando *411 (o el cdigo que se haya establecido en el 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. Reproducir nmero de extensin al llamante antes de transferir la llamada. Activando esta opcin, se reproduce el mensaje "Por favor espere mientras le transfiero a la extensin xxx". Esto permite que el llamante conozca el nmero de extensin y lo use en el futuro. Nota: El directorio de la compaa es alcanzado mediante el marcado de *411 que el usuario marque # (si est activo) mientras est en el IVR. Mquina de Fax. Extensin de maquina de fax para recibir faxes. Seleccione sistema para que el sistema reciba y enve por correo electrnico los faxes. La opcin deshabilitado hara que las llamadas entrantes sean atendidas ms rpidamente. Direccin de correo electrnico a la cual sern enviados los faxes. Direccin de correo electrnico usada si fue elegida la opcin sistema para la recepcin de faxes. Direccin de correo electrnico de donde los faxes parecen llegar.
Configuraciones generales - general settings
18
Direccin de correo que aparecer como remitente de los fax recibidos si es seleccionada la opcin "sistema". International Settings 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 Permitir el ingreso de llamadas SIP annimas? (Allow Anonymous Inbound SIP Calls) Configurar esto en S (Yes) permitir que cualquier persona pueda llamar dentro de su servidor Asterisk utilizando el protocolo SIP. Esto slo debera ser utilizado si usted comprende completamente el impacto de permitir llamadas annimas dentro de su servidor. 3. Confi guraci n
19
Rutas salientes - outbound routes Prefacio. Las llamadas salientes son enviadas por troncales de la manera en que estn configuradas en la pgina de rutas salientes. Esto est diseado para ser tan flexible como sea posible, y permite mapeos de bajo costo. Aadir ruta de salida (Add route) Nombre de la ruta (Route name)
Mdulo de configuraciones generales.
Rutas salientes - outbound routes
20
Esto es simplemente un nombre descriptivo para la troncal, que ser expuesto en su derecha de la pantalla. Contrasea de ruta (Route password). Una ruta puede preguntar a los usuarios por una contrasea antes de permitirles hacer la llamada. Esto es til para restringir llamadas a destinos internacionales o 0600. 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. Llamadas de emergencia (Emergency Dailling). Configurar esto significa que esta ruta es utilizada para llamadas de emergencia. Si usted desea tener una diferente identificacin de llamada (CallerID) para enviar por esta llamada (ejemplo: cuando usted marca 000/911/999) active esta opcin. 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. Patrones de marcado. Un patrn de discado es una serie nica de dgitos que seleccionar esta troncal. Ingrese un patrn de discado por lnea. Reglas: X Equivale a cualquier dgito de 0 a 9. Z Equivale a cualquier dgito de 1 a 9. N - Equivale a cualquier dgito de 2 a 9. 1237-9 - Equivale a cualquier dgito letras entre parntesis (en este ejemplo, son 1,2,3,7,8,9). . Comodn, equivale a uno varios caracteres. | - Separa los prefijos de marcado del nmero (por ejemplo: 9|NXXXXXX equivaldr cuando alguien marque 95551234 pero slo enviar 5551234 a la troncal) Ejemplos: 000 Slo usa esta ruta si el usuario ha marcado 000 exactamente. 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. 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 3. Confi guraci n
21
seleccionado agregar (add) despus de haber agregado la troncal, y antes de haber seleccionado enviar cambios (submit). Troncales trunks Las Troncales son lo que se utiliza para llevar una varias llamadas a un VSP (VOICE SERVICE PROVIDER) a algn dispositivo que responda al nmero que se marc (por ejemplo, otro Asterisk o la PSTN). Existen cinco tipos de Troncales: ZAP (lneas analgicas) IAX2 (Inter Asterisk) SIP (Session Initiati on Protocol)
Una ruta de salida para llamadas internacionales.
Troncales trunks
22
ENUM Personalizada (Custom trunk) Todas las troncales son configuradas de la misma forma: Configuraciones generales de troncales. Identificacin de llamada saliente (Outbound CallerID) Configurar y activar esta opcin deshabilitar la identificacin de llamadas de todos los clientes a los que se les hagan llamadas desde esta troncal. El formato es caller name <########> 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 de marcado saliente. Las reglas de marcado son muy importantes, y simples de aprender. Le indica al servidor cmo las llamadas van a ser marcadas en esta troncal. Puede ser utilizado para agregar quitar prefijos. Los nmeros que no tengan una equivalencia con ningn patrn definido aqu sern marcados como estn. Obsrvese que un patrn sin un + | (para agregar remover un prefijo) es intil. Reglas: X equivale a cualquier dgito de 0 a 9 Z - equivale a cualquier dgito de 1 a 9 N - equivale a cualquier dgito de 2 a 9 [1237-9] - equivale a cualquier dgito letra entre parntesis (en este ejemplo 1, 2, 3, 7, 8, 9) . equivale a uno ms caracteres (no permitido antes de un | +) | - Quita un prefijo de discado del nmero (por ejemplo: 613|NXXXXXX equivaldr cuando alguien marque 61335551234, pero slo ingresar en la troncal 5551234) + - Suma un prefijo de discado al nmero marcado (por ejemplo: 1613+NXXXXXX equivaldr cuando alguien marca 5551234 e ingresar a la troncal como 16135551234) Ejemplos: 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 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. 3. Confi guraci n
23
La segunda, quita el 1 (cdigo internacional de Estados Unidos y Canad) del nmero pasado por la ruta saliente. Asistente de reglas de marcado. Esta es una herramienta que facilita la creacin de reglas de marcado. Basta elegir una de las opciones y seguir las instrucciones en pantalla. Cuando el asistente finaliza, agrega la regla en el cuadro de texto de reglas de marcado. Prefijo de marcado saliente. Es usado para aadir un prefijo a la cadena de marcado de todas las llamadas salientes. Configuracin troncales ZAP: Identificador ZAP (nombre de la troncal) Los canales ZAP son identificados ya sea por un nmero de grupo o por un nmero de canal (el cual es definido en el archivo /etc/asterisk/zapata.conf). Configuracin para troncales SIP e IAX2: Nombre de la troncal: Aqu se coloca un nombre (que debe ser nico) para identificar la troncal. Es recomendable utilizar el nombre del VSP. Detalles del trocal de salida: Aqu se colocan los parmetros que permiten autenticar a la central contra el VSP. allow: Codecs aceptados en orden de preferencia. auth: Nombre de usuario para autenticarse contra el VSP. context: Si type est fijado en user, es el contexto para las llamadas entrantes. Si est fijado en peer, es el contexto para las llamadas salientes. Si type=friend, es el contexto para llamadas entrantes y salientes. host: Es cmo la central busca al servidor del VSP contratado. Los valores posibles son dynamic, hostname o direccin ip. insecure: Especifca como manejar la conexin con el otro punto. Los valores posibles son: very, yes, no, invite, port. port: Puerto de comunicaciones del cliente. secret: Si Asterisk est actuando como un cliente de un servidor SIP remoto, en secret colocamos la contrasea que usar para autenticarse. type: Relacin de la central con el servidor o cliente remoto. Los valores posibles son: user, peer o friend. username: Nombre de usuario para autenticarse con el servidor remoto. Cadena de registro:
Troncales trunks
24
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 Contexto del troncal de entrada Es normalmente el nombre de la cuenta o el nmero asignado por el VSP. Detalles del troncal de entrada: Se usan las mismas variables descriptas en los detalles del trocal de salida. Troncal personalizada. Si usted est usando H323, Chan, capi cualquier otro tipo de troncal no estandarizada, usted puede configurar la lnea de marcado para ser usada con este tipo de troncal, reemplazando el nmero a ser marcado con $OUTNUM$, por ejemplo: CAPI/XXXXXXXX/$OUTNUM$/b Usted puede identificar grupos CAPI controles individuales usando gX ContrX H323/$OUTNUM$@XXX.XXX.XXX.XXX:XXXX vpb/1-1/$OUTNUM$: 3. Confi guraci n
25
Configuracin de una troncal IAX2.
Lista negra Blacklist
26
Lista negra Bl ackli st En la seccin de configuracin usted puede ingresar un nmero a la lista de nmeros bloqueados en la lista negra reemplazarlo. Simplemente ingrselo en la casilla y seleccione submit changes. Fuentes de bsqueda de nombres de llamados Call er Name Lookup Sources. Agregar una fuente. Este mdulo le permite identificar el nombre del llamante a travs del nmero de telfono. Este tipo de bsqueda le permite especificar una fuente para resolver identificaciones numricas de las llamadas entrantes, entonces usted puede vincular una ruta entrante especfica a una fuente CID particular. De esta manera usted podr tener reportes CDR ms detallados con informacin tomada directamente de su CRM. Usted tambin puede instalar el mdulo de directorio telefnico (phonebook) para tener un nmero asociacin a un nombre. Descripcin de fuente (source description): Ingrese una descripcin para esta fuente. Tipo de fuente (source type): Ingrese el tipo de fuente, usted puede elegir entre: Interna: Utilice la base de datos de Asterisk como su fuente de bsqueda, y utilice el directorio telefnico para cargar los datos. ENUM: Utilice los DNS para buscar los nombres de los llamantes. Utiliza las zonas de bsqueda de ENUM como estn configuradas en enum.conf 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.
3. Confi guraci n
27
Cache results: Decide si guardar no los resultados en la base de datos de Asterisk; sobrescribir los valores presentes al momento de guardar. No afecta el comportamiento de la fuente interna http Host: Nombre de Host direccin IP. Port: Puerto de escucha http. Username: Nombre de usuario para la autenticacin http. Pasword: Contrasea para utilizar en la autenticacin http. Path: Ruta del archivo que recibe las variables. Ej.: /cidlookup.php Query: Cadena de la consulta donde [NUMBER] es reemplazado por el nmero del llamate. Por ejemplo: number=[NUMBER]&source=crm.
Rutas entrantes - inbound routes
28
Rutas entrantes - i nbound routes Prefacio. La pgina de Rutas entrantes (inbound routes) le permite configurar que destino Asterisk usa para llamadas entrantes desde troncales. Cuando una llamada es recibida por Asterisk desde una troncal, se identifican el DID (nmero marcado por el llamante) y el CID (nmero desde el cual el llamante realiza la llamada - callerID) y la llamada es derivada de acuerdo a su configuracin. Aadir una ruta entrante. 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. Nmero de Caller ID. Este es el nmero de Identificador de llamadas (caller ID) enviado a su mquina. Esto no es algo en lo que deba confiarse, ya que es fcilmente falsificable. (para llamadas IP lneas telefnicas) Dejndolo en blanco, nuevamente, reconocer todas. Usted puede dejar estos ltimos dos en blanco y reconocer todas las llamadas de cualquier origen. Zaptel channel. Toma las llamadas que entran por el canal ZAP aqu especificado. zapata.conf debera tener context=from-zaptel en lugar de context=from-pstn para usar esta prestacin. Configuracin del fax. Extensin del fax. Seleccione freePBX default para mantener la misma configuracin establecida en el mdulo configuraci ones generales. Email del fax.
Llamadas entrantes alnmero 0400 desviadas a la condicin horaria lunch. 3. Confi guraci n
29
Se usar la direccin de mail ingresada si se selecciona system en extensin del fax. Si deja este campo en blanco, freePBX usar la configuracin establecida en configuraciones generales. Fax detection type: Seleccionando Zaptel o NVFax la llamada ser respondida inmediatamente y reproducid el tono de llamada pasados los segundos que se fijen en el siguiente punto. Para troncales SIP o IAX2, use la opcin NVFax. Pausa despus de responder. Esta cantidad es la cantidad de segundos de espera luego de la respuesta inmediata. El motivo principal de esto es escuchar el tono de fax antes de que prosiga la llamada. Privacidad. 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. Opciones. 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. Configurar destino (Set destination). Esta opcin es la que desva la llamada entrante a uno de los puntos de los mdulos ya configurados. (Grupos de extensiones, Destinos miscelneos, horarios, bsico, DISA, callback, colas, IVR, salas de conferencia, aplicaciones personalizadas, etc.)
Follow me
30
Follow me Prefacio. La configuracin de follow me es como un mini grupo de extensiones, pero esta ligada directamente a una extensin. Se configura de la misma manera en la que se configura un grupo de extensiones, incluyendo la prestacin de anunciar a la persona que llama que est siendo transferida a otra parte. El plan de marcado ha sido estructurado de tal forma que de cualquier lugar desde el cual se pueda llamar a una extensin, el grupo de llamado de rastreo ser activado si es definido de esa manera. Esto significa que desde una llamada entrante por el IVR desde afuera internamente, cuando usted marque una extensin se llegar al grupo de llamado en lugar de la extensin. Este comportamiento es activado simplemente incluyendo el contexto ext-findmefoll ow delante del contexto ext-local en cualquier lugar en que la extensin es marcada. Existen otros usos para la funcin de follow me. Como algo simple, puede ingresar en la extensin del rastreo una opcin para ir al correo de voz si no es respondida la llamada. La diferencia es que as se puede variar el tiempo de llamado, introducir un anuncio, ir a otro correo de voz si el destino no es alcanzado, puede agregar mltiples nmeros y estrategias de llamado, para cuando esa extensin sea solicitada. El lugar donde la funcin de rastreo no es prioritaria es cuando la extensin local es seleccionada como un destino explcito desde varias pantallas. En ese caso, el destino est siendo enviado a ext-local y no ser interceptada por el contexto ext-findmefoll ow. Para configurar follow me, haga clic en alguna de las extensiones ya creadas que aparecen a la derecha de la pantalla. Edit Follow Me. Estrategia de ring. Ver estrategia de ring en aadir grupo de extensiones.
Configuracin de follow-me para la extensin 416. 3. Confi guraci n
31
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. Listado de extensiones. Aqu se agregan uno por lnea, los nmeros que se quiere hacer sonar. Si se agrega un nmero externo, debe agregarse el signo # al final. Nombre del prefijo CID.
Tiempo de llamada. Ver Tiempo de llamada en aadir grupo de extensiones. Announcement. Mensaje que se reproducir al llamante cuando entre en el follow me. Destino si nadie atiende. Ver destino si nadie atiende del mdulo grupos de extensiones. Colas queues Prefacio. Las colas le permiten administrar un gran nmero de llamadas entrantes, como es de esperarse en un call center en un contact center. Esta es una aplicacin muy completa, y como tal, tiene muchas opciones de configuracin. Aadir cola. 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) Nombre de la cola.
Mdulo para aadir una cola.
Colas queues
32
Un pequeo nombre para la cola. Esto es nicamente utilizado en la interfase de la web para una simple identificacin. Contrasea para colas. Si usted est preocupado por la seguridad, puede poner una contrasea en la cola para detener a cualquiera que quiera ingresar. Luego de que el agente intente ingresar, a l ella le ser requerida una contrasea. Prefijo de nombre CID. Como un agente puede estar ingresado en varias colas simultneamente, puede ser til tener un prefijo en el identificador de llamadas (CallerID) para ser visto en el telfono del agente, as l ella sabrn desde qu cola es la llamada que viene. 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. 3. Confi guraci n
33
Opciones del grupo. Anuncios para miembros. Este es un anuncio que es reproducido al agente antes de conectar la llamada. Un ejemplo sera: Esta llamada es de la cola de soporte tcnico. Esto es til cuando el agente no dispone de identificacin de llamadas en el telfono, no mira el prefijo de nombre CID. Estas grabaciones son administradas desde el sistema de grabaciones del sistema. Categora de msica en espera. Esta es la categora de la msica ( publicidad) reproducida al llamante mientras espera por un agente disponible. Las categoras son administradas desde la configuracin de msica en espera. Tiempo mximo de espera. La cantidad mxima de segundos que el llamado puede esperar antes de ser enviado a destino en caso de no ser atendido. 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. Unirse si est vaca. Si usted desea que los llamantes lleguen a colas que no tienen agentes, deje esta opcin en si (yes). Esto no est recomendado. Abandonar cuando se vace. Si quiere mover los llamantes de las colas que no tienen agentes, deje esto en si (yes). Si tiene agentes que ingresan y salen del sistema constantemente, usted debera dejar esto en no. Estrategia de ring. Existen seis patrones de llamado para elegir. ringall (sonar todos): Llamar a todos los agentes hasta que uno responda (preestablecida) Round Robin: Toma turnos llamando a cada agente disponible. leastrecent (menos reciente): Llama al agente que atendi una llamada de esta cola por ultima vez. fewestcalls (menor cantidad de llamadas): Llama al agente que complet la menor cantidad de llamadas de esta cola.
Las opciones del grupo.
Colas queues
34
random (al azar): Llama a cualquier agente de la cola indistintamente. rrmemory (Round Robin con memoria): toma turnos llamando a cada agente disponible, recordando desde dnde dej de llamar en adelante. Timeout del miembro. La cantidad de segundos antes de considerar que la llamada no ser contestada por el miembro. Reintentar. La cantidad de segundos de espera antes de hacer sonar todos los telfonos nuevamente. 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. Grabacin de llamada. Las llamadas entrantes a los agentes son grabadas. Son grabadas en /var/spool/asterisk/monitor. Anuncios a los llamantes. 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. Anunciar posicin. Seleccione si (yes) para anunciar la posicin de la llamada en la cola. Anunciar tiempo de espera. Puede anunciar el tiempo de espera estimado a los llamantes. Men de voz. Despus de anunciar la posicin y el tiempo estimado de espera, usted puede ofrecer a los llamantes un men de voz digital. Ejemplo: Si usted quiere dejar un nombre y un nmero para ser llamado luego, por favor presione * ahora. Esto no afectar su posicin en la cola. Este men de voz debe contener nicamente opciones de marcado de un solo dgito. 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. Destino en caso de no ser atendido. Esto es un destino estandarizado para cuando se sobrecarga la cola se supera el tiempo mximo de espera. 3. Confi guraci n
35
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. Aadir DISA DISA name. Un nombre familiar para identificar el destino DISA fcilmente. 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.
Configuracin del destino en caso de no ser atendido. La apariencia depende de los mdulos que se hayan configurado.
Simple configuracin de una cuenta DISA.
Grupos de extensiones - ring groups
36
Tiempo fuera (Response timeout). Esto es la mxima cantidad de tiempo de espera que Asterisk aguardar antes de desconectar la llamada si el usuario ha marcado una extensin invlida incompleta. Digit timeout. Es la mxima cantidad de tiempo permitida entre dgitos que el llamante tiene cuando est marcando un nmero. Requerir confirmacin (Require confirmation). Antes de ingresar la contrasea, se anunciar Press 1 cada tres segundos hasta que cualquier dgito (cualquiera de ellos, no tiene que ser 1) sea presionado. Entonces, seguir solicitando una contrasea. Esto es generalmente til cuando se llama desde un dispositivo (ejemplo: X100P, TDM400 un VSP pobremente configurado) que no le informa cuando la llamada es en realidad respondida. Identificacin de llamadas (Caller ID) Usted puede cambiar el nmero de identificacin de la llamada saliente por el de DISA con el formato Usuario <nmero>. Este campo es opcional. 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). Grupos de extensiones - ri ng groups Prefacio. Esto define una extensin virtual que llama a un grupo de telfonos simultneamente, detenindose cuando uno de ellos es contestado. Esto es bsicamente una versin simplificada de las colas para aquellos que no necesitan la funcionalidad extra de ellas. Aadir grupo de extensiones (add ring group). Nmero de grupo. Este es el nmero que es marcado desde cualquier extensin para que todos los telfonos del grupo llamen. Descripcin del grupo (group description) Una descripcin que ayude a identificar el grupo. Estrategia de ring. Ringall: Llama a todos los canales disponibles hasta que alguno conteste. Hunt: toma turnos llamando a cada extensin disponible. Memoryhunt: Llama a la primera extensin, luego a la primera y a la segunda, luego a la primera y a la segunda y a la tercera, y as sucesivamente. 3. Confi guraci n
37
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. Nombre de prefijo CID. Usted tiene la opcin de colocar un prefijo al nombre del identificador de llamadas cuando llamen las extensiones en este grupo. Ejemplo: Si usted prefija con Ventas: , una llamada de Juan Perez se mostrar como Ventas: Juan Perez en la extensin llamada. Tiempo de llamada (mximo 60 segundos). Cunto tiempo (en segundos) el grupo llamar antes de fallar y tomar la opcin destino si nadie atiende. Esto no est relacionado con la estrategia de llamado hunt. Destino si nadie atiende. Esto le da una serie de opciones a tomar cuando la llamada excede el tiempo de llamado especificado en tiempo de llamada. Las opciones pueden ser agregadas quitadas de aqu dependiendo de los mdulos que estn instalados y configurados. Vea Destinos para ms informacin.
Configuracin de un grupo de extensiones.
Callback
38
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.
Un callback que luego de llamar al nmero indicado, ejecuta la autenticacin de ingreso para una cuenta DISA. 3. Confi guraci n
39
Grabaciones de sistema - system recordings Informacin. Las grabaciones del sistema son utilizadas para los grupos de llamados y conferencias, para hacer anuncios. 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 - Digital Receptionist
40
IVR - Di gi tal Recepti oni st 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. Cuando usted selecciona IVR, la primera pgina es una pequea serie de instrucciones sobre como manejarlo. Usted puede, si bien, editar el IVR existente, crear uno nuevo presionando en Aadir IVR(Add IVR). Editar men. Change name. Este es el ttulo descriptivo que aparece a la derecha, y en el men de Destinos. Timeout. Esto es la cantidad de tiempo que el sistema espera antes de enviar la llamada al destino t. 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 Enable direct dial. Si usted activa esto, los usuarios adems de poder discar las opciones del IVR, sern capaces de discar directamente un nmero de extensin. 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.
Ejemplo de configuracin de un IVR. 3. Confi guraci n
41
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 ah. Por ejemplo, usted tiene el mdulo DISA activado, pero ninguna entrada DISA, eso no va a aparecer en la lista. El resto de la pgina es bastante clara. Use Incrementar opciones (Increase Options) o Disminuir opciones (Decrease Options) para alterar el nmero de opciones disponibles. Esto no va a permitirle descender a menos del nmero de opciones actualmente disponibles. Para borrar una opcin, simplemente deje la seccin en blanco. Cuando termine, seleccione Guardar (Save). Salas de conferencia - conferences Prefacio. Las conferencias son una facilidad preestablecida que esta disponible como un destino. Add Conference. Detalles de la conferencia. Nmero de la sala. Este es un nmero que los usuarios locales pueden marcar para incluirse en la conferencia. Nombre de la sala Esto es usado como un identificador, junto con el nmero, cuando se selecciona una conferencia como destino. 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 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. PIN del moderador.
Salas de conferencia - conferences
42
Este campo es opcional excepto en el caso en que est activa la opcin esperar administrador, en cuyo caso, se solicitar ingresar este PIN. Opciones de la sala. Mensaje de entrada Este es un sonido que escucharn los conferencistas al ingresar Esperar administrador. Cuando existe un PIN de administrador, la conferencia no comenzar hasta que el administrador ingrese. Vea el punto PIN del moderador.. Modo silencio. Generalmente un bing es reproducido cuando un usuario ingresa sale de la conferencia. Usted puede desactivarlo seleccionando si (Yes) aqu. Cuenta de usuarios Cuando alguien ingrese, la conferencia dir they are (nmero de conferencistas) people in this conference. 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. Msica en espera Activa desactiva la msica en espera en esta conferencia. Permitir men Le permite al usuario administrador ingresar a la administracin de la conferencia presionando *. Los comandos en el modo de administracin son: 1: Silenciarse. 4 6: Aumentar disminuir, respectivamente, el volumen de la conferencia. 7 9: Aumentar disminuir, respectivamente, el volumen de su voz. 2: Traba destraba la conferencia. 3: Expulsa la ltima persona que se uni a la conferencia. 3. Confi guraci n
43
Horarios - ti me conditi ons Informacin. Las condiciones de tiempo son mdulos que parecen destinos cuando estn instalados. Le permite a usted condicionar las llamadas basndose en el horario, fecha, semana, da de semana, da del mes, mes. Hasta ahora es razonablemente bsico y no funciona con adiciones exclusi ones, pero usted puede encadenar las condiciones de tiempo para hacer exactamente esto. Aadir sistema horario. Nombre del horario. Un nombre corto que le permite identificar la condicin de tiempo en un destino. Patrn del horario. Seleccione de los mens desplegables el rango temporal que desea utilizar. Obsrvese que - significa cualquier 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. 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. Timecond1 Match Mon-Fri, 9am-5pm True: Goto IVR1 False: Goto Timecond2 Timecond2: Match Sat, 9am-12pm True: Goto IVR1 False: Goto IVR2
Configuracin de una condi cin horaria.
Misc destinations
44
Ejemplo de adicin Dentro de 9am y 5pm de Lunes a Mircoles, eljase IVR 2, de otra forma eljase IVR 1. Timecond1: Match 9am-5pm True: Goto timecond2 False: Goto IVR1 Timecond2: Match Monday True: Goto IVR2 False: Goto tiemcond3 Timecond 3: Match Wensday True: Goto IVR2 False: Goto IVR1 Misc destinations Prefacio. Los destinos miscelneos le permiten usar cualquier cosa que marque desde una extensin estndar como un destino. Ejemplo Si usted quiere hablar con Juan, quizs prefiera tener una opcin en el IVR que sea Si quiere hablar con el celular de Juan puede hacerlo marcando 2 y tener un destino miscelneo de: Celular de Juan 91554545454 (Observe el 9 delante, como si estuviera haciendo una llamada externa) Entonces, en el men del IVR, usted selecciona Celular de Juan como un destino, y se conectar la llamada. PIN sets La configuracin de contraseas es un mdulo que le permite usar un rango de contraseas en lugar de slo una. Esto es nicamente utilizable por las troncales, pero puede ser usado en DISA en cualquier otra cosa que requiera el uso de contraseas para la autentificacin.
Configuracin de un destino a partir de la funcin de voicemail. 3. Confi guraci n
45
Gestin de usuarios - admini strators Este mdulo le permite crear usuarios que podrn ingresar al FreePBX para modificar ciertas configuraciones a razn de los privilegios que se le hayan otorgado. Restricciones de acceso. 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. 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. Msica en espera - musi c on hol d Informacin. Aqu usted puede configurar los archivos de msica en espera que sern reproducidos. Usted puede configurar varias clases de msica en espera, que son usadas en distintas colas. La idea detrs de esto es que su msica en espera preestablecida es msica standard, y sus distintas colas pueden tener diferentes sonidos mientras los llamantes aguardan en lnea. 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).
Creacin de un usuario con acceso a todas las secciones.
Msica en espera - music on hold
46
4 Herramientas 4. Herrami entas
47
PHP Info. Muestra la informacin sobre el mdulo de PHP instalado en el equipo. Directorio telefnico. Asterisk Phonebook Prefacio:
Asterisk Logfiles.
48
Con esta herramienta usted conseguir establecer una base de datos de fcil acceso y uso que le permite localizar efectivamente los nombres y nmeros establecidos para el discado rpido. Nmero (number): Nmero completo para llamar a la extensin. Nombre (name): Nombre que identifique la persona en el discado rpido. Cdigo de discado rpido (speed dial code): Nmero de acceso rpido para la extensin. Al seleccionar Submit changes usted ingresar las variables a la base de datos. Si lo desea puede utilizar los archivos preexistentes en el Outlook utilizando la opcin CSV y examinando los archivos. Al finalizar haga clik en Upload y subir los archivos a Asterisk. 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. 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.
4. Herrami entas
49
Java SSH. Muestra la consola del Asterisk en un navegador web en forma segura. 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. Comandos generales. sip shows peers: Esto muestra todos los dispositivos SIP, y su estado, de acuerdo a Asterisk. show channels: Muestra todos los canales que estn en uso en el momento. soft hangup <channel> 1 : Corta el canal especificado. El corte se producir cuando el controlador vuelva a interactuar sobre el canal. restart gracefully: Deja de recibir llamadas, espera que el volumen de llamadas se vace y reinicia Asterisk. !<command>: Ejecuta el comando indicado. abort halt: Cancela el apagado del equipo. add extension <exten>,<priority>,<app>,<app-data> into <context>: Agrega una nueva extensin dentro de un contexto. add ignorepat <pattern> into <context>: Agrega una regal ignorada en un contexto. debug channel <channel>: Realiza un debug sobre el canal especificado. dont include <context> in <context>: Quita un contexto incluido de otro contexto. help: Muestra una lista de los comandos con una breve descripcin. include <context> in <context>: Incluye un contexto en otro contexto. load: Carga un modulo dinmico por nombre. logger reload: Vuelve a abrir los archivos log (ver apartado Backup and Restore). logger rotate: Rota y vuelve a abrir los archivos log. no debug channel <channel>: Deshabilita el depurador sobre el canal especificado. pri debug span <span>: Habilita el depurador sobre el span indicado. remove extension exten@context [priority]: Remueve una extensin del contexto especificado. Si se indica la prioridad, solo ella es eliminada de la extensin. remove ignorepat <pattern> from <context>: Remueve una extensin ignorada de un contexto especfico.
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.
Asterisk CLI.
50
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. set verbose <level>: Configura el nivel de mensajes verbales a ser mostrados. 0 significa que ningn mensaje debe ser mostrado. En el inicio es el equivalente a -v[v[v...]]. show agents: Muestra el estado de los agentes configurados en el archivos agents.conf de la carpeta /etc/asterisk. show applications: Muestra la lista completa de las aplicaciones. show application <applicati on>: Describe a la aplicacin especificada. show channel: Muestra informacin sobre el canal especificado. show channels: Muestra informacin sobre los canales activos. show codecs: Muestra informacin sobre los codecs disponibles. meetme: Devuelve una lista de las conferencias en uso. show dialplan: Muestra el plan de marcado (dialplan). show hints: Muestra la lista completa de extensiones indicando en que estado se encuentran. show manager commands: Muestra una lista de los comandos de Asterisk. show manager connect: Expone la lista de los usuarios administradores conectados. show parkedcalls: devuelve una lista de las llamadas estacionadas. show queues: Devuelve la lista de las colas con un detalle de la configuracin de cada una. show voicemail users: Muestra una lista de las casillas de correo de voz definidas. show voicemail zones: Muestra la lista de la zona de los formatos de mensaje. El formato de los mensajes est relacionado con la zona geogrfica del origen de este mensaje. Si alguien en un distinto huso horario le enva un mensaje, Asterisk tiene la capacidad de transformar el horario en relacin a la diferencia de husos horarios. Comandos referidos al mantenimiento del servidor. restart now: reinicia Asterisk inmediatamente. restart when convenient: Reinicia Asterisk cuando se vacia el volumen de llamadas. reload: Recarga toda la configuracin de Asterisk. extensions reload: Recarga solo la configuracin de las extensiones. show uptime: Devuelve el tiempo transcurrido desde el ultimo inicio del sistema. show version: Devuelve informacin sobre la versin instalada de Asterisk. 4. Herrami entas
51
Asterisk Information. 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. Edit Configuration. La forma en que Asterisk deba trabajar est regulada por una serie de archivos de texto. Estos archivos guardan la informacin de las extensiones, colas, IVR y hasta de la configuracin del hardware. Esta herramienta permite editar los archivos de configuracin ubicados en cuatro carpetas sin la necesidad de utilizar programas como el putty (ver apartado) o el vi desde la consola. Estas carpetas son: /etc/asterisk: Contiene los archivos de configuracin del hardware y del plan de marcado. /var/www/html/panel: Contiene los archivos para manejar el FOP. /etc: Contiene los archivos de la configuracin del sistema en general. /tftpboot: No contiene archivos por el momento. 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 el contenido de la base de datos. Sitio oficial: http://www.phpmyadmin.net System Status. Muestra el tiempo transcurrido desde el ltimo inicio del sistema. Permite adems reiniciar el sistema (reboot) o apagarlo (shutdown). Backup & Restore. Usted puede configurar una programacin regular para backup para asegurarse de tener una copia de su configuracin de su Asterisk y FreePBX, correo de voz, y grabaciones en CD de sus grabaciones. Usted tambin puede restaurar un estado previo al backup en el caso de perdida de datos una masiva falla de configuracin. Los backups son almacenados en /var/lib/asterisk/backups. Usted debera hacer de los backups off-line algo importante. Agregar una programacin para Backups
Module Admin.
52
Schedule name: Le da a este backup un nombre amigable (ejemplo: diario Correo de voz) para identificar correctamente que es lo que est en ese backup. Esto har de las futuras restauraciones algo ms fcil. 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. CDR: Active esta opcin para resguardar el registro de las llamadas. Operator panel: Active esta opcin para resguardar el FOP (Flash Operator Panel) 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). Restaurar desde el Backup. Esto enlistar todos los backups que estn presentes en su sistema (ubicados en /var/lib/asterisk/backups). Seleccione en el backup que quiera restaurar. Module Admin. Esto administra los mdulos que se usarn para configurar el Asterisk. Permite activar, desactivar y actualizar mdulos con las ltimas versiones disponibles en el sitio oficial de FreePBX. 5. Informes
53
5 Informes Asterisk guarda un registro llamado CDR (Call Detail Record) de todas las comunicaci ones efectuadas a travs del sistema, en la base de datos asteriskcdrdb, a la cual es posible acceder utilizando phpMyAdmin (ver captulo anterior). La tabla cdr cuenta con los siguientes campos: src: Fecha y hora del momento en que se estableci la comunicacin.
Module Admin.
54
dst: Nmero de destino. dcontext: Contexto de destino. clid: Caller ID de la parte llamante. channel: Canal utilizado por el llamante. dstchannel: Canal utilizado para llevar al nmero de destino. lastapp: ltima aplicacin ejecutada. lastdata: ltimo dato pasado por la aplicacin. duration: Duracin en segundos de la comunicacin. billsec: Tiempo de conversacin en segundos. dispositi on: Es el resultado de la comunicacin. Puede tomar los valores ANSWERED, NO ANSWER, BUSY FAILED. uniqueid: Nmero nico de identificacin del canal. 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 comunicaci ones. Selection of the month Este filtro permite seleccionar la informacin a travs de un rango mensual. Es necesario marcar los botones de radio from y to. Selection of the day De la misma manera que en el anterior, toma la informacin de las comunicaciones realizadas entre los das seleccionados. Es necesario marcar los botones de radio from y to. Destination Toma la informacin realizada solo al destino ingresado. Hay cuatro maneras distintas de buscar el nmero ingresado:
5. Informes
55
Exact: Devuelve los registro de la base de datos que coincidan con el nmero ingresado. Begins with: Devuelve los registros cuyo destino comienza con el nmero ingresado. Por ejemplo, para conocer el caudal de llamadas a celulares, basta ingresar 915 seleccionando esta opcin. Contains: Realiza la bsqueda en la base de datos, devolviendo los registros cuyo nmero de destino contenga el nmero ingresado. Ends with: Realiza la bsqueda en la base de datos, devolviendo los registros cuyo nmero de destino finalice igual al nmero ingresado. Source Toma la informacin de las comunicaciones realizadas por el nmero ingresado. Ya sea interno no. Channel Devuelve solo las llamadas efectuadas desde y hacia el canal especificado. 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. Call Logs Devuelve la informacin detallada de las comunicaciones efectuadas de acuerdo a los filtros aplicados a la bsqueda, en forma de tabla. Las columnas de fecha, nmero marcado y tiempo de conversacin pueden ordenarse de manera ascendente descendente haciendo clic en el ttulo de la columna. La columna APP ofrece la posibilidad de visualizar el nombre de usuario del nmero de destino. Para configurarla, es necesario editar el archivo defines.php ubicado en la carpeta /var/www/html/admin/cdr/lib y copiar la lnea de cdigo que se muestra a continuacin las veces que sea necesario. $appli_list['numero]=array("nombre"); 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.
Module Admin.
56
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. Daily Load Devuelve un grfico en forma de barras que representa la cantidad de comunicaciones efectuadas por hora a lo largo del da seleccionado.
Llamadas realizadas a celular en los ltimos 6 meses. 5. Informes
57
Module Admin.
58
6 Flash Operator Panel El panel de operador es una aplicacin para Asterisk PBX, funciona en un explorador de Internet. Es capaz de mostrar informacin sobre el funcionamiento de su PBX en tiempo real y hacer operaciones sobre las comunicaciones.
6. Flash Operator Panel
59
Esta es la informacin mostrada por el Panel de operador Flash. Las extensiones que estn ocupadas, llamando disponibles. Quin est hablando y con quin (CLID, contexto, prioridad). El registro de estado y disponibilidad en SIP e IAX2. Estado de las salas de conferencia (cantidad de participantes). Estado de las colas (cantidad de usuarios en espera). Indicador de mensajes en espera y conteo de mensajes. Canales estacionados Agentes presentes en el sistema. Configuracin del panel de operador Flash El archivo de configuracin del panel de operador Flash es el op_server.cfg, donde usted definir aspectos bsicos y avanzados de su configuracin, as como credenciales de ingreso, contraseas de seguridad, extensiones, contextos, directorios, etc. El archivo de configuracin para el cliente Flash es el op_style.cfg donde se podrn definir los aspectos visuales, como el tamao de los botones, posiciones de los conos, tamao, colores, etc. 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. Configurando el servidor del panel de operador Flash. Abra el archivo op_server.cfg ubicado en la carpeta /var/www/html/panel y edtelo a los parmetros apropiados para su configuracin. manager_host: Es el nombre de host la direccin IP de su Asterisk.
Module Admin.
60
manager_user: Es el usuario definido como administrador en manager.conf (siguiendo este ejemplo de configuracin, debera quedar como myuser). manager_secret: La contrasea para el usuario myuser definido como administrador en manager.conf. 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). Usted puede monitorear muchos servidores Asterisk: Repita las secuencias de manager_host, manager_user, manager_secret y event_mask tantas veces como servidores quiera monitorear, sin dejar ningn otro parmetro en medio. El primero en aparecer ser considerado el nmero uno, y de all en adelante sern numerados secuencialmente. Entonces usted podr especificar qu servidor pertenece a tal cual botn con los parmetros definidos en la definicin del botn, en op_buttons.cfg 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 especificaci n de estos parmetros: astmanproxy_server: Usted tiene que especificar la direccin IP de todos los asterisk manager listados en astmanproxy config en el mismo orden, cada uno en su propia lnea de astmanproxy_server. listen_addr (opcional): Especifica que direccin IP usted quiere ligar a op_server.pl. Si usted deja esta opcin comentada, tratar de ligar todas las direcciones IP. listen_port: Es el puerto con el que el servidor aceptar conexiones entrantes desde clientes Flash. El servidor y el Flash se comunican usando TCP a este puerto. Default: 4445 web_hostname (opcional): Debe ser el mismo hostname que utiliza para acceder al servidor web. Ejemplo: si usted accede al servidor web utilizando http://www.myserver.com entonces el web_hostname debe ser www.myserver.com. Si usted dispone una direccin de IP en lugar de un nombre, usted debera escribir esa direccin de IP. No incluya http:// al principio. Los clientes Flash solamente funcionarn si la direccin del web_hostname es la misma URL a la que el explorador web esta apuntada. Usted puede usar esto como una medida de seguridad extra. Si usted quiere acceder al cliente de Flash desde diferentes direcciones (como una red local y una direccin IP externa) usted deber dejar este campo comentado, anteponiendo un ; delante de web_hostname. security_code: Es la contrasea que utilizar para autorizar comandos entrantes desde Flash (transferencias, desconexiones, generaciones, etc.). Si usted quiere llevar adelante cualquier accin desde el Flash, deber ingresar esta contrasea en la casilla apropiada en el Flash. Slo escrbala ah y haga clic en ok. 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 6. Flash Operator Panel
61
poll_interval: Es la frecuencia en segundos con la que el servidor tomar las estadsticas para el estado de SIP e IAX2. Default: 240. Las versiones ms novedosas de Asterisk deberan funcionar bien sin tomar estadsticas 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 estadsticas a un valor ms alto. (Ejemplo: 7200) porque el Server utiliza muchos recursos para hacer esto, y los eventos son enviados de todas maneras por Asterisk. poll_voicemail: Si usted verifica el correo de voz (voicemail) desde una interfase web, el administrador no notificar cuando un correo de voz es borrado. Usted puede activar esta opcin y el correo de voz ser verificado en cada intervalo de toma de estadstica. auth_md5: Coloque 1 si usted quiere autenticar al administrador de Asterisk usando MD5 hashing. No hay motivos para deshabilitarlo. kill_zombies: Estando activo (1) el servidor intentar desconectar los canales zombies si suceden. Esta opcin no debera ser usada, esta desactivada de manera preconfigurada (o). debug: Establece el parmetro de debug en el servidor. El log est escrito a stdout. Es un parmetro de mapa de bits. o 1: Muestra los eventos provenientes de Asterisk o 2: Muestra los comandos enviados a Asterisk o 4: Muestra los comandos provenientes de Flash o 8: Muestra los comandos enviados a Flash o 16,32,64: debug para el servidor El nivel preconfigurado es cero (sin debug). Si usted quiere ver los eventos provenientes de Asterisk y los comandos enviados a l, configrelo en 3 (1+2). Si usted quiere un debug completo, configrelo en 255. Usted puede sobrescribir esta configuracin desde el comando con la lnea X. auto_conference_extension: Es el nmero de extensin a marcar para seleccionar una sala de conferencia vaca sin contrasea. Vase abajo para un ejemplo completo. Esto es requerido para ingresar en una conferencia llamada en proceso. Default: 900 (no para versiones 0.15). queue_hide: Si est configurado, los botones de posicin de las colas no sern expuestos si no estn en uso, por lo tanto, slo ver el nmero de personas esperando en una cola. Vase Tipos de botones para ms informacin. clid_format: Un patrn para dar formato al nmero de identificacin de llamadas (caller ID). Cada X ser reemplazada por un nmero. Default: (XXX) XXX-XXXX. clid_privacy: Si est configurado como 1, el panel no expondr el nmero de identificacin de llamadas (caller ID) el nmero llamado en los botnes. show_ip: Si est configurado como 1 expondr la direccin IP para las extensiones o troncales SIP e IAX2.
Module Admin.
62
reverse_transfer: En la forma preconfigurada, cuando usted arrastra y suelta botones para hacer transferencias, el punto de vista es desde el FreePBX, no desde el usuario. As que, si usted est hablando mediante un SIP/extensin y arrastra el botn para ese canal, usted transferir ese leg (usted), no el de la persona con la que est hablando. Si usted quiere transferir el otro leg (la persona con la que est hablando, es la perspectiva del telfono, en lugar de la de Asterisk) configure esta opcin en 1. transfer_timeout: 0, No timeout|300,5 minutes|600,10 minutes enable_restart: Si se configura en 1, el botn de recarga (reload) en el cliente Flash (en su forma original, solo recarga el cliente Flash) har un reseteo de Asterisk. Si usted quiere que Asterisk se resetee, asegrese de correrlo con safe_asterisk algn mecanismo que relance Asterisk cuando termine. Esto es un verdadero reseteo, no una recarga. rename_label_wildcard: Si usted tiene un botn REGEXP con un comodn, usted puede poner esta opcin en 1, y la etiqueta de ese botn cambiar al nombre del canal que est utilizando ese slot. Un canal con un comodn es cualquier canal que contiene un asterisco (*) dentro. No todos los REGEXP tienen comodines. rename_label_callbacklogin: Si est configurado en 1, cambiar la etiqueta del botn al nmero del agente para ese botn cuando utilice el agentcallbacklogin de Asterisk. Si usted ingresa en el sistema a travs de una extensin que est definida en la seccin de Extensiones y parmetros de Contexto para ese botn, entonces la etiqueta cambiar a Agent/XXXX en el momento del ingreso. Si no tiene un botn que equivalga en Extensiones y parmetros de Contexto, no funcionar. rename_to_angent_name: Si est configurado como 1 el renombre mencionado arriba ser hecho con el nombre definido en agents.conf en lugar de Agent/XXXX. rename_queue_member: Coloque un 1 si usted agrega canales como miembros de una cola mediante el AddQueueMember (marcando el nmero de una cola seguido por *), sin ir por agents.conf change_led_agent: Si est configurado en 1, el led para el botn que representa un agente ingresado en el sistema cambiar de color por el color definido en op_style.cfg como ledcolor_agent (default: amarillo). De esta manera usted podr ver de un simple vistazo si el agente est ingresado en el sistema no. barge_muted: Si est configurado en 1 y usted arrastra un botn sin utilizar a cualquier leg de una llamada activa, los tres (llamante, llamado y usted) sern ubicados en una sala de conferencia y el canal arrastrado (usted) ser enmudecido automticamente, por lo tanto las personas que estaban en la conversacin no escucharn a la tercera persona (usted). Usted puede enmudecer desenmudecer a cualquiera de los participantes en la sala de conferencia mediante un click en la flecha de cada botn. barge_rooms: Son los nmeros de las salas de conferencias configuradas en su Asterisk. conference_context: Es el contexto donde usted ha definido todas sus salas de conferencias. Default: conferences. 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 6. Flash Operator Panel
63
/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 conf=>901 conf=>902 voicemail_extension: Es la extensin y el contexto en su extensions.conf para alcanzar la aplicacin del correo de voz (voicemailmain application). Por ejemplo, si usted tiene la extensin 1234 definida en el contexto prestaciones para alcanzar el inicio del correo de voz (voicemailmain), configure este parmentro en 1234@ prestaciones. Entonces, cuando usted haga doble click en el icono MWI de un botn, marcar al correo de voz (voicemail) directamente. Usted puede definir diferentes contraseas de seguridad, contextos, salas de ingresos de conferencias, directorios Flash y nombres de web host en un contexto diferente para cada uno. Solo comience una nueva definicin de contexto entre parntesis y coloque los nuevos valores bajo esa lnea. De esta manera usted puede tener diferentes pginas web para funcionar con diferentes contextos para el PBX que funciona como anfitrin (hosted PBX). Configuracin del cliente del FOP. El despliegue de la imagen es configurable (tamao de los botones, iconos, etc.) Usted puede tener ms de cien botones activos por pantalla. Tambin funciona bajo distintos contextos, usted puede tener un servidor funcionando y muchos otros diferentes clientes en pantalla (para hosted PBX, diferentes departamentos, etc.). 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
Module Admin.
64
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. Posicin (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 transformar un botn de troncal. Si es un botn especial cambiar el comportamiento/tipo (behaviour/type). Vea tipos de botones para ver ms detalles. 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. URL: Si est configurado, la etiqueta del botn se transformar en un vnculo (hyperlinks) que vincular a esta URL cuando es seleccionado. 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. No_Rectangle: Si esta configurado como verdadero (true), el rectngulo no ser dibujado, slo lo sern los elementos (etiqueta, iconos, identificador de llamadas, temporizador, etc.). Usted puede utilizar sus backgrounds personalizados para dibujar sus propios botones. 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: vi-c :wq! ++enc=utf8 op_buttons.cfg 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. Los servidores de la versin 0.20 pueden monitorear varios servidores de Asterisk. Si el canal para el botn pertenece a otro servidor en lugar del primero, especifique su nmero. Extension: Es el nmero de la extensin. Debe estar definido en su plan de marcado (dialplan) para alcanzar ese canal. Si no hay extensin para ese botn (Ejemplo: una lnea externa) deber configurarlo en -1, de esta manera el servidor desestimar intentos de transferir a ese canal. Context: Si la extensin no es alcanzable desde el contexto predefinido en su plan de marcado (dialplan), usted tambin debera especificar su contexto. Si usted tiene un nmero de 6. Flash Operator Panel
65
extensin 100 dentro de un contexto from-sip, entonces usted debera escribir 100 para la extensin y from-sip para el contexto. 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 Mailbox: Es el buzn de correo de voz (voicemail) a monitorear. Si usted tiene cuentas de correo de voz para las extensiones, deber especificar el usuario de correo de voz y el contexto. Si usted deja este campo libre, el servidor no verificar el buzn de voz para esa extensin. Tipos de botones. 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. Ejemplo: [900] Position=1 Label=Meetme Room 900 Extension=900 Context=conferences Icon=6 Salas de conferencia (participantes). Slo especifique ms de una posicin para el botn y mostrar los participantes de la sala de conferencia individualmente mientras ingresan dejan la conferencia. Usted puede enmudecer y desenmudecer cada uno mediante un click en el led. [900] Position=2-5 Label=Meetme User Extension=1 Icon=6 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:
Module Admin.
66
[QUEUE/ventas] Position=2 Label=Ventas Queue Extension=3 Context=queues Icon=5 Colas (posi ciones). 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: [QUEUE/support] Position=3-10 Label=Support Queue Extension=-1 Icon=5 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 Agentes Sirve para monitorear un agente en particular mediante su nmero. [AGENT/1002] Position=12 Label=Agent 1002 6. Flash Operator Panel
67
Extension=1002 Context=Agents Icon=3 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 Botones de identificacin de llamadas. Hay ocasiones en las que tiene que monitorear un canal por su identificacin de llamadas. Para esos casos, usted puede intentar monitorear mediante el botn CLID. Ejemplo: [CLID/5555555] Position=13 Label=5555 Jhon Extension=5555555 Context=from-internal Icon=2 Botones REGEXP Existen ocasiones en las que se deben monitorear varios canales simultneamente nombres de canales dinmicamente generados. Las expresiones comunes (Regular Expressions) 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
Module Admin.
68
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. 6. Flash Operator Panel
69
Position=4 Label=External CAPI Context=in-extern Icon=4 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 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 Cambiando la disposicin de botones. Para editar la disposicin visual, edite el archivo op_style.cfg. Usted puede cambiar el tamao de los botones y los colores e incluso el emplazamiento de los conos junto al tamao de los mismos, entre otras cosas. NO modifique los nombres de las variables, slo el valor despus del signo igual y NO utilice espacios. Con los ajustes apropiados, usted puede tener ms de cien botones en la pantalla. 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.
Module Admin.
70
Usted puede cambiar la disposicin de la barra de herramientas (toolbar) cambiando el nmero que est despus de las variables show_x. Cada uno representa un posible elemento en la barra de herramientas. show_ security_code: Casilla de ingreso del cdigo de seguridad. show_clid_info: Informacin adicional en la casilla del CLID. show_btn_help: Botn de ayuda. show_btn_debug: Botn de debug. show_btn_reload: Botn de recarga. show_status: Botn de estado. El valor cero deshabilita el elemento. Un nmero representa el orden en el que ser mostrado en la barra de herramientas, el nmero uno comienza en la parte ms izquierda de de la barra de herramientas. En la configuracin de ejemplo, todos los elementos de la barra de herramientas estn mostrados en orden correlativo. Ejemplo: Si usted no quiere que se vea un botn de debug, configure el show_btn_debug en cero. Usted puede traducir el texto de la barra de herramientas en sus correspondientes variables. Prestaciones del plan de marcado (dialplan). Si usted quiere configurar el texto del identificador de llamadas (caller ID) de la aplicacin Flash cuando transfiere una llamada, usted deber modificar su plan de marcado (dialplan) su macro estndar de extensin, a algo similar a esto: [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 Ejemplo de macro para extensin estndar para la configuracin de identificador de llamadas si la informacin fuera provista por el Panel de operador Flash. El panel establece una entrada de base de datos para el nombre del canal con el texto del identificador de llamadas. Si la variable no existe en la base de datos (si no es establecida por el Panel de operador Flash) la lnea 1 salta a la prioridad n+101, para realizar un marcado normal sin configurar el nombre del identificador de llamadas. 6. Flash Operator Panel
71
Si usted no quiere involucrar al identificador de llamadas, asegrese de dejar el show_clid_info en cero en el archivo op_style.cfg y salte este paso. 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) El color puede ser cualquier valor hexadecimal. El estado es: 0 para estado disponible (canal desocupado) 1 para estado ocupado (canal en uso) 2 para estado del agente ( canal desocupado y agente presente) 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: ./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: <-Asterisk Call Manager/1.0 <-Response: Success <-Message: Authentication accepted <- 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. Se puede integrar con software de administracin de relaciones con el cliente (CRM Customer Relationship Manager) mediante una pgina web (y pasando el CLID) cuando un botn especfico est llamando.
Module Admin.
72
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. Utilizar el arrastre desde el Mouse para transferir una llamada. Utilizar el arrastre desde el Mouse para iniciar una llamada. Utilizar el arrastre desde el Mouse para ingresar en una llamada en curso. Configurar el identificador de llamadas (caller ID) mientras transfiere inicia una llamada. Desplegar una pgina web con los detalles del cliente. Marcar mediante un click un nmero telefnico desde una pgina web. Enmudecer y desenmudecer participantes en las salas de conferencia. Desconectar una llamada. Usted puede desconectar una llamada haciendo doble click en el botn rojo. Transferir una llamada. Simplemente arrastre el pequeo telfono hasta la nueva extensin y transferir la llamada. Iniciar una llamada. Usted puede arrastrar y soltar el pequeo telfono en otra extensin. Llamar su telfono, cuando usted atienda, llamar la otra extensin. Una vez que la otra extensin atienda, la llamada est en curso. Ingresar o crear una conferencia. En el caso de que hay una llamada en curso y usted quiere ingresar. Todo lo que tiene que hacer es tomar su icono de telfono en el panel de operador de Flash y dejarlo sobre la conversacin, entonces ser conectado. Para hacer esto usted tiene que configurar su estrategia de marcado (dialplan) correctamente y haber definido el contexto correctamente de antemano. Si no lo hace, tendr canales desconectados y el cierre de Asterisk. Esto sucede cuando usted redirige una llamada dentro del administrador de Asterisk con un contexto incorrecto. Referencias rpidas. Cuando el canal est ocupado, hay alguien en una conferencia cola, el botn ser rojo. Cuando el canal est disponible, el botn ser verde. Cuando el canal pertenece a una cola, el botn es amarillo. Cuando el canal est siendo llamado, el botn titilar. 6. Flash Operator Panel
73
Cuando todos los botones titilen, es porque la aplicacin Flash perdi la conexin con el servidor de operaciones (op_server). 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. Integracin con software de administracin de relaciones con el cliente. Usted puede utilizar el Panel de operador Flash en un ambiente de trabajo como el de un call center, integrado con un software de administracin de relaciones con el cliente basado en un navegador web. Esta prestacin del panel de operador Flash le permite cargar una pgina web en relacin con la identificacin de la llamada (caller ID) simplemente con una llamada entrante. 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: mybutton: El nmero de botn de la extensin que usted desea monitorear. url: La direccin URL que usted desea traer cuando la extensin especificada arriba sea llamada. target: El marco de la ventana donde la URL ser cargada (si lo deja en blanco, utilizar _self). Cuando llegue una llamada al botn monitoreado (mybutton), se abrir en un navegador web la pgina indicada en URL. Enviar la variable CLID (Caller ID) a esa direccin URL, as usted podr realizar la bsqueda del registro del cliente. 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. Un ejemplo sera (para customer.php): <?PHP if(isset($_GET['clid'])) { echo "The caller id is ".$_GET['clid']; } ?>
Module Admin.
74
7 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.
7. Grabaci ones
75
Prestaciones: AJAX permite la actualizacin automtica de pginas. Permite el acceso a las grabaciones del correo de voz (voicemail). Permite el acceso a las grabaciones del monitoreo de llamadas. Permite el acceso a la base de datos para el registro de llamadas realizadas. Plataforma de bsqueda para todas las llamadas y grabaciones. Plataforma de configuraciones de usuarios simples. i18n Configuracin de idioma. Activacin de callforward. Contrasea para correo de voz (voicemail). Activacin del servicio de notificacin de correo de voz (voicemail) a pager e- mail. Formato de grabacin para correo de voz (voicemail). Configuracin de grabacin de llamadas para monitoreo. Prestacin de ayuda para telefona. Autenticacin de ingreso de la contrasea del correo de voz (voicemail password) por Asterisk. Autenticacin de ingreso para contrasea de SIP (SIP password) Soporte de PHP5. Configuracin. Ubquese en /var/www/html/recordings/includes Abra el archivo main.conf.php Para utilizar el ARI para la autenticacin de la base de datos configrelo como $standalone[use]=true y configure nombre de usuario y contrasea. Si nicamente desea utilizar el monitoreo de llamadas, configrelo como $ari_no_login=1 La forma preconfigurada del IGN para el monitoreo de llamadas le permitir ver las llamadas de la extensin que est ingresada en la pgina web. Si usted prefiere que ciertas extensiones vean todas las llamadas en el monitor de llamadas de ARI, configrelo como $callmonitor_admin_mailboxes y un signo igual y separando con comas para limitar la lista de extensiones. Si usted prefiere que todos los usuarios vean todas las llamadas monitoreadas en el ARI, configrelo como $callmonitor_admin_mailboxes a todos (all) Buzn de voz.
Module Admin.
76
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. 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.
7. Grabaci ones
77
Opciones En esta pgina, cada usuario puede cambiar las propiedades de su correo de voz.
Module Admin.
78
9. Web MeetMe Control
79
9 Web MeetMe Control Esta aplicacin le permitir controlar las salas de conferencia previamente configuradas con FreePBX. 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. El botn KICK, sirve en cambio para quitar a la extensin de la sala.
Module Admin.
80
8. Funciones de llamada
81
8 Funciones de llamada En este captulo se detallan las funciones ya programadas en Asterisk. Para el acceso a ellas, se considera que no se realizaron cambios en el mdulo features codes. Redireccin de llamada. Desva las llamadas que entran a una extensin a otra o a un nmero externo. *72: Activa la redireccin incondicional. *73: Desactiva la reaccin incondicional. *74: Desactiva la redireccin preguntando antes el nmero de la extensin. En los casos anteriores, los cambios se efectan sobre la extensin que se utiliz para ajustar el desvo. *90: Activa la redireccin cuando la extensin est en uso. *91: Desactiva la redireccin cuando la extensin est en uso. *92: Igual que *91 pero preguntando la extensin sobre la que se quiere hacer el cambio. *52: Activa la redireccin de llamada cuando la extensin no responde o no est disponible. *53: Desactiva la redireccin de llamada cuando la extensin no responde o no est disponible. 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.
Module Admin.
82
*70: Activa la llamada en espera. *71: Desactiva la llamada en espera. No molestar (DND). Esta funcin desconecta el telfono impidindole recibir llamadas. *78: Activa DND *79: Desactiva DND. Servicios. *43: Prueba de eco. Esta funcin permite verificar el tiempo de latencia entre la extensin y Asterisk. Es til para verificar el retardo en las extensiones remotas (SIP o IAX2). *60: Reproduce un mensaje que seala la hora del servidor donde corre Asterisk. *62: Funcin de llamada despertador. Al marcar esta combinacin, usted deber ingresar 4 nmeros para indicar la hora a la que desea que entre una llamada a su extensin. *65: Reproduce un mensaje que indica el nmero de extensin. *69: Indica el nmero telefnico de la ltima llamada recibida y permite comunicarse directamente con l. Discado rpido. El discado rpido consiste en memorizar un nmero de telfono en otro de 3 cifras, agilizando as el proceso de marcado. Existen dos tipos de discado rpido. Uno de acceso a todos los usuarios y desde cualquier extensin. Quiere decir, que es posible configurar hasta 100 nmeros de discado rpido para todas las extensiones de la empresa. Aqu deberan ingresarse los nmeros de uso comn entre los empleados. Se configura de la siguiente manera: 300 3nn 9XXXXXXXX: Ajusta el discado rpido 3nn al nmero 9XXXXXXXX. 3nn: Discado rpido del nmero ingresado a 3nn. *3nn: Reproduce un mensaje que reproduce el nmero asignado al discado rpido 3nn. La otra forma, es reservada para cada extensin. Quiere decir, que cada extensin cuenta con 100 nmeros de marcado. Los cuales pueden ser configurados solo por la extensin que har uso de l. Se configura de la siguiente manera: 500 5nn 9XXXXXXXX: Ajusta el discado rpido 5nn al nmero 9XXXXXXXX. 5nn: Discado rpido del nmero ingresado a 5nn. *5nn: Reproduce un mensaje que dice el nmero asignado al discado rpido 5nn. Mensajes de voz (voicemail). *97: Para escuchar los mensajes de voz de la extensin en la que se marc el nmero. *98: Para escuchar los mensajes desde cualquier extensin. 8. Funciones de llamada
83
En ambos casos, para ingresar a su casilla, se le solicitar ingresar su contrasea. Una vez ingresado podr navegar dentro de estas opciones. 1: Escuchar mensajes nuevos o viejos. 3: Opciones avanzadas 1: Contestar el mensaje. 2: Llamar al nmero que dej el mensaje (callback). 3: Escuchar informacin del mensaje 4: Llamada saliente. 5: Dejar mensaje. *: Volver al men principal. 4: Escuchar el mensaje anterior 5: Repetir el mensaje actual. 6: Escuchar el siguiente mensaje. 7: Borrar el mensaje. 8: Reenviar el mensaje a otra casilla. 9: Guardar el mensaje en una carpeta. *: Ayuda. Si es presionado mientras se escucha un mensaje, lo rebobina. #: Salir. Si es presionado mientras se escucha un mensaje, adelanta. 2: Cambiar de carpeta. 3: Opciones avanzadas. 0: Opciones de la casilla 1: Grabar su mensaje cuando no est disponible. 2: Grabar su mensaje cuando est ocupado. 3: Grabar su nombre. 4: Cambiar su contrasea. *: Volver al men principal. *: Ayuda #: Salir Colas. XXX*: Para ingresar la extensin a la lista de agentes de una cola. Donde XXX es el nmero para acceder a la cola. XXX**: Retira la extensin marcada de la lista de agentes de la cola XXX.
Module Admin.
84
Lista negra. Esta funcin agrega un nmero a eleccin o el de la ltima llamada recibida a una lista para rechazarlos en el futuro. *30: Agrega un nmero en forma manual a la lista negra. *31: Borra de la lista negra un numero a eleccin. *32: Agrega a la lista el nmero de la ltima llamada recibida. Transferir una llamada. #XXX: Transfiere la llamada a la extensin XXX. #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 opci ones generales (ver captulo configuracin). 9. Mi scel neos
85
9 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 protocol os 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. 1. Del sitio oficial (http://www.counterpath.com), puede descargarse la ltima versin de x-lite. En este caso trabajaremos con la versin 3.0. 2. Una vez descargado el archivo basta ejecutarlo y seguir estos pasos: a. Hacer click en next.
Instalacin de un softphone.
86
b. Seleccionar I accept the agreement y hacer click en next. c. Elegir la carpeta donde se quiera instalar x-lite y hacer clic en next.
9. Mi scel neos
87
d. Hacer clic en next. e. Esperar que el instalador copie los archivos necesarios.
Instalacin de un softphone.
88
f. Hacer clic en finsh para reiniciar el equipo. 3. Cuando el equipo termina de reiniciarse, ver un mensaje como el que se muestra abajo. Haga clic en s.
9. Mi scel neos
89
4. Haga clic en add para configurar x-lite con los datos correspondientes a la extensin SIP creada previamente en Asterisk. 5. Complete los campos de la siguiente manera y haga clic en aceptar: a. Display name: El nombre que enva como CLID b. User name: El nmero de la extensin que configur previamente en Asterisk. c. Password: El mismo valor ingresado en el campo secret cuando configur la extensin. d. Authorization user name: El mismo valor ingresado en user name. e. Domain: La direccin IP de su sistema, en este caso colocamos la IP privada. En el caso que el usuario est fuera de la oficina, este campo debera ser completado con la IP pblica otorgada por el ISP de su oficina.
Instalacin de un softphone.
90
6. Volvemos automticamente a la pantalla anterior donde vemos la extensin que acabamos de configurar. Con la versin paga del x-lite podemos manejar varias extensiones a la vez. Hacemos click en close.
9. Mi scel neos
91
7. En el caso de tener un firewall activo (en este caso el de Windows), veremos un mensaje como este: Entonces, hacemos click en desbloquear para permitir la comunicacin entre el x-lite y nuestro sistema. 8. Si todo sali bien, deberamos ver la palabra ready como muestra la siguiente figura:
Tycho
92
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. Las prestaciones que ofrece Tycho son: Interfase de usuario de e-mail Facilidad en el uso Administracin de casillas de correo de voz y extensiones Funcionamiento bajo Linux, MacOS X, Windows, Solaris, AIX, y HP-UX Facilidad en la personalizacin Uso no comercial gratuito Funcionamiento
9. Mi scel neos
93
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. Gua de instalacin para VMXML Esto es una forma muy bsica de la documentacin sobre los scripts servers vmxml. 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). Para la descargar el programa y ms informacin, visitar http://sip-syndication.com Putty Putty es un software gratuito SSH, Telnet, rlogin y ciente TCP raw. Originalmente estaba disponible nicamente para Windows, pero ahora est disponible para varias plataformas Unix, con puertos de trabajo en progreso (work-in-progress) a Mac OS y Mac OS X. Otras personas han contribuido con puertos no oficiales para otras plataformas, como telfonos mviles potenciados por Symbian. Su versin beta es escrita y mantenida primordialmente por Simn Tatham, es de cdigo abierto y est licenciado bajo una licencia del MIT.
Configuracin de Putty para conectarse a la ip 192.168.0.14 por SSH.
WinSCP
94
WinSCP WinSCP es una aplicacin de Software Libre. WinSCP es un cliente SFTP grfico para Windows que emplea SSH. El anterior protocol o SCP tambin puede ser empleado. Su funcin principal es facilitar la transferencia segura de archivos entre dos sistemas informticos, el local y uno remoto que ofrezca servicios SSH. Puede descargarse desde http://winscp.net
10. Gl osari o
95
10 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. ISDN: Es la sigla para Integrated Services Digital Network. Es la forma ms comn de conectar sistemas PBX con el sistema de telefona tradicional (PSTN) y entre s. Tiene dos formas principales, que son PRI y BRI. Tambin es una forma popular de conectar sistemas de VoIP a la red de telefona tradicional (PSTN) si no tiene proveedores VoIP disponibles prefiere utilizar los servicios de compaas telefnicas. ISTP: Es la sigla que agrupa Internet Telphony Service Provider. Se denomina de esta manera al servicio de telefona a travs de Internet.
WinSCP
96
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. 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. PRI: Tasa primaria de ISDN. Un mtodo comn de conexin para medianos y grandes sistemas VoIP y PBX a sistemas de telefona tradicional (PSTN) entre s mismos. Una lnea PRI carga hasta veintitrs llamadas simultneamente en Amrica del norte y treinta llamadas en otros pases. PSTN: Es la sigla para Public Switched Telephone Network, que es el servicio de telefona tradicional provisto por las compaas telefnicas. SIP: Es la sigla para Session Initiation Protocol. El protocolo ms popular para VoIP, utilizado por la mayora de los productos VoIP y VSP. IAX: Es el protocol o de conexin entre sistemas Asterisk. NAT: Es el protocolo de traducci n de direcciones de red, la sigla significa Network Address Translation Protocol. AGI: Es la sigla para Asterisk Gateway Interface. Es el puerto del que se sirve Asterisk para conectarse con otras aplicaciones. CDR: Es la sigla que agrupa Call Detail Record. Es la bitcora de las comunicaci ones. CRM: Es la sigla con la que se designa al software utilizado para la administracin de los contactos que una empresa guarda con sus clientes. Customer Relationship Manager. DID: Es la sigla para Direct Inward Dialing. Es el nmero marcado por un llamante para entrar en el sistema telefnico. FXO: Es la manera de designar el punto final de conexin de la llamada. El FXO es el elemento que recibe la llamada (un telfono o una central conectada a la PSTN). La sigla es para Foreing eXchange Office. FXS: Es el que enva la llamada al FXO. La sigla designa Foreing eXchange Station. Script: Es un conjunto de instrucciones, sentencias de control, variables y dems elementos de programacin generalmente almacenadas en un archivo de texto (pueden considerarse como un archivo de instrucciones o como un programa). Softphone: Un Softphone (en ingls combinacin de Software y de Telephone) es un software que hace una simulacin de telfono convencional por computadora. Osea permite usar la computadora para hacer llamadas a otros softphones o a otros telfonos convencionales usando un VSP. DTMF: Multifrecuencia de doble tono. Estos tonos se usan en telefona para marcar un nmero telefnico. 11. Ep logo
97
11 Eplogo Este manual se escribi teniendo en cuenta las necesidades de un administrador y usuario del sistema de comunicaciones Asterisk. Est pensado para la correcta implementacin del sistema y su uso ms efectivo. La bibliografa consultada proviene de distintos foros de programacin, el libro Asterisk The future of telephony editado por OReilly media y avalado por Mark Spencer y toda la comunidad de desarrolladores de Asterisk en el mundo, representada por el proyecto de documentaci n de Asterisk a quienes le estamos agradecidos, por hacer de la comunicacin una actividad entre personas y sin intermediarios corporativos y annimos. Los autores de este volumen son Eduardo Federico Viegas y Facundo Hernn Correa, integrantes de Asterio (http://www.asterio.com.ar) , una compaa 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.-