DialPlan en Asterisk según horarios
vía faungg Algo que me han preguntado bastante y que han estado visitando el blog en busca de ello es configurar Asterisk y prepararlo para realizar cierta acción dependiendo de la hora o fecha que entre la llamada, para esto tenemos que tener ciertos conocimientos del manejo de extensiones ya que es ahí en el /etc/asterisk/extensions.conf dónde configuramos todos estos parámetros. Los comandos que vamos a utilizar son : Goto y GotoIfTime , que nos daran la posibilidad de saltar en los extension según la necesidad u horario. Ahora un ejemplo más detallado que deja completamente claro el uso de estos 2 comandos en el exten. Ejemplo: [llamadas] exten => 555,1,Goto(horarios,s,1) // acá recibimos una llamada a la extensión 555 y la envíamos al contexto horarios [horarios] exten => s,1,GotoIfTime(09:00-12:00|mon-fri|1-31|jan-dec?lineas,333,1) // Acá vemos si estamos en horario de mañana de lunes a viernes de 1 a 31 todos los meses del año y si cumple la regla envía la llamada al contexto lineas. // Los atributos de cada regla pueden cambiar a gusto o remplazar por * para que sean todos los días o meses.
[lineas] exten => 333,1,Dial(SIP/333,30,Tt) // Hacemos el Dial al anexo 333, pasa a este contexto sólo cuando cumple la regla de horarios
Espero que haya quedado claro el tema de cómo usar el GotoIfTime, se puede usar para programar IVR y mensajes fuera de horario, quedo atentos a sus comentarios por cualquier consulta.
Asterisk: Funcionalidades básicas y avanzadas El sistema asterisk incorpora todas la funcionalidades que pueden esperarse en una centralita convencional y asimismo muchísimas funcionalidades avanzadas que tendrían un elevado coste en sistemas tradicionales propietarios. A continuación enumeramos sólo lás más importantes:
Funciones básicas:
Transferencias Transferencias (directa o consultiva): Permite transferir una llamada en curso a otra
extensión. Existen dos formas: o Transferencia atendida: consultando consultando al nuevo destino si quiere que le pasen la llamada, o Transferencia directa: pasando la llamada sin consultar al destinatario.
En versiones anteriores a la 1.8, al transferir una llamada se perdía el CLID (el número del usuario llamante). Esto no ocurre con la versión 1.8, que mantiene por tanto el CLID. tras una transferencia.
Desvíos: Permiten la transferencia automática de una llamada entrante hacia un
número determinado (interno o externo) cuando se cumplen determinadas condiciones: por ejemplo si el número esta ocupado, si no contesta, etc. Capturas (de grupo o de extensión): La captura permite coger una llamada que se esta recibiendo en una extensión desde otra distinta. o Captura de extensión: por defecto se hace con el codigo *8 + la extensión. o Captura de grupo: se predefinen unos deteminados grupos de extensiones de modo que al marcar un coódigo de asterisk - por defecto el *8 - se coge cualquier llamada que esté recibiendo el grupo en el que estamos. Conferencia múltiple: En función del modelo de terminal se podrá establecer una comunicación comunicación entre múltiples usuarios de la centralita.
Llamada directa a extensión : Si además del número de cabecera disponemos de
diferentes números públicos (DDIs), podremos enrutar directamente la llamada entrante a uno de estos DDIs, a una extensión de la centralita. Ring groups: grupos de llamadas . Una llamada entrante podrá ser dirigida diri gida directamente a un ring group, que es un grupo de extensiones que sonaran de acuerdo a una determinada estrategia previamente establecida. Si la llamada no se descuelga no podrá ser tratada posteriormente y se perderá. DND (Do not disturbe): Opción de no molestar, que podrá ser configurado en Asterisk mediante un código o directamente en el terminal.
Funciones avanzadas:
Correo Vocal ( Voicemail ) integrado con correo electrónico. En caso de que el usuario
no pueda atender una llamada, se puede programar que se transfiera a un sistema de buzón de voz. En caso de que se deje un mensaje, se enviará un correo electrónico avisando del mismo al usuario destinatario. Operadora Automática (IVR IVR)): Una operadora automática o IVR es una aplicación de telefonía que permite interactuar con el usuario que realiza la llamada, de forma que éste pueda pulsar opciones previamente anunciadas y acceder de forma automática a los destinos programados. Música en espera con archivos WAV : Asterisk nos permite introducir categorías de música en espera basadas en archivos .wav y mp3. De este modo podremos poner diferentes melodías para ser reproducidas r eproducidas como música en espera. Colas de Llamadas (ACD ACD)) : Un sistema de colas o ACD es una aplicación que distribuye las llamadas entrantes a un grupo específico de agentes de acuerdo a una determinada estrategia. Si la llamada no puede ser descolgada, descolgada, no se pierde y puede ser transferida tr ansferida a otro destino. Salas de Audio-Conferencias : Una sala de audioconferencias audioconferencias es un sistema que permite conectar a multiples usuarios en una misma conversación telefonica. Los usuarios pueden acceder a la sala desde una extensión interna, o bien desde el exterior (a traves de un número directo o bien a traves de un IVR). Es un sistema muy útil para hacer reuniones internas (por ejemplo seguimiento de ventas) o bien con clietnes o proveedores. No hay una capacidad máxima de salas por lo que podremos definir tantas como nos hagan falta (la limitación principal serán los recursos del servidor). Las salas tampoco tienen una capacidad máxima de llamadas por lo que principalmente la limitación vendrá dada por el número de líneas que la empresa disponga para salir a la PSTN. Gestión de llamadas entrantes según horario o fecha (Time Conditions) . Con la incorporación de el gestor web FreePBX en su versión 2.5 o superior, es muy sencillo definir un horario y calendario laboral que nos permita hacer un tratamiento diferenciado de las llamadas entrantes segun el mismo. Por ejemplo, si estamos en horario laboral y no es fetivo, la llamada se envia a la extensión 100 (de operadora). En caso contrario, se puede enviar a una locución que advierta de que son horas no laborables, o bien es un día festivo. Extensiones DISA: Es posible configurar opciones de post marcación para determinadas llamadas entrantes, de forma que una vez hemos comunicado con la centralita, podamos llamar a un nuevo destino de forma sencilla y automatizada. Callback : llamada automática de respuesta a una llamada perdida. Cuando redirigimos una llamada al módulo de Callback el sistema lo que hará será colgar y originar una
llamada hacia el número que nos ha llamado, de este modo se pueden centralizar costes de llamada. La llamada saldrá siguiendo las normas de routing saliente de llamadas. Retrollamada : funcionalidad disponible en la versión 1.8. Si se hace una llamada a una extension y esta no contesta (por estar ocupado o ausente), se puede activar l a función Asterisk de retrollamada. En cuanto el usuario llamado cuelgue, se avisa al que activo la función de retrollamada para que este pueda llamar de nuevo a la extensión incial. Informes detallados de llamadas (CDR) : Detalle de llamadas realizadas/recibidas realizadas/recibidas por
extensión, para imputación de costes departamentales, por cliente o incluso para facturación.
Integración CTI: Integración de la telefonía con sistemas informatizados informatizados de gestión
comercial o de atención a cliente (CRM). Estos sistemas permiten por ejemplo ejecutar una llamada desde el PC o bien recibir información sobre una llamada entrante en la pantalla.
Asterisk: Principales ventajas Funcionalidad Asterisk dispone de todas las funcionalidades de las grandes centralitas propietarias Asterisk dispone (Cisco, Avaya, Alcatel, Siemens, etc). Desde las más básicas (desvios, capturas, transferencias, multi-conferencias, …) hasta las más avanzadas (Buzones de voz, IVR, CTI, ACD…).
Escalabilidad El sistema puede dar servicio desde 10 usuarios en una sede de una pequeña empresa, hasta 10.000 de una multinacional repartidos en múltiples sedes.
Competitividad en coste No solo por ser un sistema de código abierto (Open Source) sino gracias a su arquitectura hardware: utiliza plataforma servidor estándar (de propósito no específico) y tarjetas PCI para los interfaces de telefonía, que por la competencia del mercado se han ido abaratando progresivamente.
Interoperatibilidad y Flexibilidad Asterisk ha incorporado la mayoría de estándares de telefonía del mercado, tanto los Asterisk ha tradicionales (TDM) con el soporte de puertos de interfaz analógicos (FXS y FXO) y RDSI (básicos y primarios), como los de telefonía IP (SIP SIP,, H.323, MGCP, SCCP/Skinny). Eso le permite conectarse a las redes públicas de telefonía tradicional e integrarse fácilmente con centralitas tradicionales (no IP) y otras centralitas IP. IP.
Asterisk: Capacidades de líneas y extensiones El sistema Asterisk es sumamente flexible y soporta todos los sistema de conectividad interna o externa tanto tradicionales (PSTN, RDSI o analógicos) como los más actuales (SIP e incluso Skype). A continuación enumeramos los tipos de puerto disponibles y sus capacidades:
Líneas de enlace o Trunks Son las que permiten conectar la centralita con la red pública de telefonia. Existen las siguientes opciones:
Enlaces RDSI: interfaces BRI o PRI. Existen configuraciones con 2, 4, 6, 8, 10 o 12 BRI o 1, 2, 4, 8 o 16 PRI. Todos ellos se suministran con cancelación de eco por Hardware. Enlaces Analógicos (FXO): configuraciones para 1/2/4/8 enlaces, con cancelación eco por Hw. Enlaces directos GSM, vía Gateways voip-GSM. Son equipos IP que incoporan bahias para colocar las tarjetas SIM, y llevan directamente tecnologia 2G/3G para conexión con las redes de operador de movil. Enlaces VoIP: SIP, IAX y Skype. Para optimizar las conexiones SIP es recomendable incorporar tarjetas de transcodificación para poder comprimir las sesiones RTP. El codec que se utiliza normalmente normalmente es el G729.
Extensiones Son las conexiones internas que utilizan los usuarios o terminales de nuestra compañia. Existen las siguientes opciones:
Extensiones SIP o IAX.
Extensiones analógicas (FXS): configuraciones de 1/2/4/8…24 extensiones para conectar teléfonos analógicos o terminales de fax. Extensiones inalambricas WIFI. Con soporte de diferentes terminales. Extensiones inalambricas DECT-GAP estándar. estándar. Requiere de la instalación de antenas DECT IP (nosotros utilizamos la tecnología Polycom-Kirk).
Versiones ersion es de Asterisk Existen varias versiones soportadas de Asterisk, cada una de las cuales se distinguen por las funcionalidades incluidas. Cada vez que se lanza una versión, se soporta durante un periodo de tiempo determinado. Durante este período de soporte inicial, habrá minor releases que incluyen cambios para corregir los errores que vayan siendo reportados. En algún momento, la versión se hace obsoleta y sólo se mantiene con las correcciones para problemas de seguridad. Por último, la versión llegará a su final de la vida (EOL), donde ya no recibirá cambios de ningún tipo. El tipo de versión (Release type) define durante cuánto tiempo va a ser soportada. Una versión LTS (de largo plazo, Long Term Support ) será totalmente vigente durante 4 años, con un año adicional de mantenimiento de parches de seguridad. Las versiones estándar están soportadas por un período de tiempo más corto, que será por lo menos un año más un año adicional de mantenimiento de parches de seguridad. Debido a ésto, nosotros siempre hemos optado por instalar versiones tipo LTS (1.4 y 1.8, hasta la fecha) en nuestras soluciones.
La siguiente tabla muestra las líneas de tiempo para todas las versiones de Asterisk, incluyendo aquellas que han llegado al final de la vida.
Release Series Release Type Release Date Security Fix Only EOL 1.2.X
2005-11-21
2007-08-07
2010-11-21
1.4.X
LTS
2006-12-23
2011-04-21
2012-04-21
1.6.0.X
Standard
2008-10-01
2010-05-01
2010-10-01
1.6.1.X
Standard
2009-04-27
2010-05-01
2011-04-27
1.6.2.X
Standard
2009-12-18
2011-04-21
2012-04-21
1.8.X
LTS
2010-10-21
2014-10-21
2015-10-21
10.X
Standard
2011-12-15
2012-12-15
2013-12-15
A continuación se incluye tambien una planificación de las futuras versiones de Asterisk que se iran lanzando:
Servicios de Mantenimiento Asterisk
Quarea da servicio de mantenimiento de sistemas Asterisk para toda España en modalidad de cobertura en horario de atencion estandar (laboral de lunes a viernes de 9 a 15h y de 15:30 a 18:30 horas) o bien o bien en horario extendido (lunes a sábado no festivos de 9 a 22 horas). En nuestro
servicio definimos diferentes componentes opcionales segun cuales sean los requisitos de servicio del cliente:
Soporte básico y mantenimiento software Mantenimiento Hardware Administracion Intervenciones fuera horas
Soporte Básico y Mantenimiento software del sistema Este es el componente básico e imprescindible para la contratación del mantenimiento en cualquier sistema. Incluye las siguientes prestaciones de servicio:
o o
o
Soporte telefónico para atención a incidencias y consultas. Acceso remoto para realizar las las intervenciones Control de inventario: control de la configuración hardware y software del equipo. Copia configuración inicial del sistema. Mantenimiento Software de los sistemas open source (código abierto, GPL): Válido para sistemas Asterisk-FreePBX, Hylafax, Openfire u OpenSIPS. Reposición elementos software en caso de fallo. Incluye sistema operativo. Actualización de versiones de software del tipo minor release, e instalación de parches, para corrección de problemas de estabilidad o seguridad. Objetivo de resolución de incidencias software: al siguiente día laborable.
Mantenimiento Hardware sistemas Este componente es opcional, y debera especificarse en la oferta comercial. En función del tipo de equipo a gestionar o mantener, existen diferentes condiciones de servicio y precios. Las condiciones se detallan en la siguiente tabla:
Intervención in-situ
Tiempo objetivo de respuesta 4 horas
Tiempo objetivo de resolución 24 horas
Intervención in-situ
4 horas
24 horas
24 horas
72 horas
4 horas
48 horas
Depende servicio
Depende servicio
4 horas
48 horas
Tipo Equipo
Desplazamiento/Portes
Servidor Avanvox Tarjetas Interfaz TDM/Voip Terminales: Teléfonos IP y adaptadores (ATA) Conmutador LAN (Switch) Routers Antenas DECT u otros equipos
Envió a cargo del cliente, con sustitución. Intervención in-situ opcional Intervención in-situ opcional Intervención in-situ opcional
Administración del equipo: En el mantenimiento de ciertos sistemas como los Asterisk se incluye una pequeña bolsa de horas para cambios de configuración. Las Las características del servicio son:
Atención a cambios de configuración configuración del sistema (Peticiones de Servicio). Servicio). Un ejemplo podrían ser cambios en el enrutado de las llamadas entrantes, o la definición de nuevos días festivos para tratamiento fuera horas. Mantenimiento de la parametrización inicial del sistema: corrección de errores de manipulación del sistema por parte del cliente. Existe un límite de máximo de horas de servicio según el sistema, que se indicará en la oferta. Tiempo de respuesta, 5 días
Intervenciones Fuera Horas En las instalaciones críticas para el Cliente y que por tanto no admiten cortes de servicio en el horario de atención a cliente de Quarea, se ofrece opcionalmente al cliente la contratación de un paquete de horas anuales para intervenciones fuera horas que exigen para el sistema. Las condiciones son las siguientes:
Sirven para intervenciones planificadas con una antelación mínima de una semana. Se contabilizaran en fracciones mínimas de una hora. Actuaciones/Intervenciones Actuaciones/I ntervenciones
Las intervenciones se realizarán preferentemente de forma remota (por telecontrol). En caso de que no sea posible la intervención remota, se enviará a un técnico in situ. Se incluyen gastos desplazamiento siempre y cuando la intervención se realice en Cataluña. Para intervenciones fuera de estas provincias los gastos de desplazamiento se repercutirán al CLIENTE. Notificación de incidencias: Para cursar las incidencias de servicio, se puede hacer por medio de correo electrónico o por teléfono únicamente en los siguientes puntos de contacto: Atenció
[email protected]
902 520 520.
Servicios Instalación Asterisk Asterisk
Instalación Sistemas Asterisk Quarea está especializada en la instalación y mantenimiento de centralitas telefónicas Asterisk , con cerca de 300 clientes satisfechos. Tenemos clientes en casi todas las provincias españolas (Albacete, Alicante, Almeria, Badajoz, Baleares, Barcelona, Cantabria, Castellón, Girona, Granada, La Coruña, Las Palmas, Lleida, Madrid, Málaga, Navarra, Orense, Palencia, Santa Cruz de Tenerife, Sevilla, Soria, Tarragona, Valencia, Valladolid y Vizcaya) y varios en el extranjero (Francia, Alemania, Portugal, Colombia, EEUU, Canada, Brasil, etc).
Nuestro equipo de ingenieros intentarán responder a sus necesidades y resolver sus problemas con la máxima celeridad.
Asterisk @ 10000 Horas ●
Mejorando la curva de aprendizaje de Asterisk
Posts tagged ·
dialplan ·... 16/11/2011 19:48
Asterisk Advanced. Day 3 2 comments by SirLouen in Asterisk Asterisk,,Basicos Basicos,,DialPlan DialPlan,,Introduccion Introduccion,,Telefonia Analogica
Hoy voy a hacer una prueba, escribir un articulo durante la clase a modo “Inline”. Seguramente salga un articulo demasiado extenso pero al menos, lo máximo completo. - Teoría de Macros en el DialPlan
En primer lugar un tema que no hemos visto hasta la fecha y es crucial para configuraciones de dialplan repetitivas, las Macros. Dos conceptos basicos Las macros se componen del contexto del Macro [macro-
] Solo tienen una extension, la “s” exten => s,1,Answer() same => n,Hangup
Por otro lado, las Macros se ejecutan desde el Plan de Marcacion, como una aplicación cualquiera con el formato Macro(, , , etc) Luego dentro del contexto Macro para poder utilizar esos argumentos llamados se utilizan las variables especificas de las macros ${ARG1}, ${ARG2}, etc Ejemplo: [extensiones] exten => 100,1,Macro(prueba,SIP/mitelefono, 30) [macro-prueba] exten => s,1,Dial(${ARG1},${ARG2})
Aparte disponemos de variables especificas de las Macro. ${MACRO_CONTEXT}, ${MACRO_EXTEN} y ${MACRO_PRIORITY}. Sirven para saber dentro de la macro, que contexto, que extensión y que prioridad llamó a la Macro. Un ejemplo, si utilizamos un Buzon de Voz, que coincide con el numero de extension pues podriamos utilizar ${MACRO_EXTEN}: [extensiones] exten => 100,1,Macro(prueba,SIP/mitelefono, 30) [macro-prueba] exten => s,1,Dial(${ARG1},${ARG2}) exten => n,VoiceMail(${MACRO_EXTEN}) A partir de aquí ya podemos dar “rienda suelta” a la imaginacion y poder simplificar nuestro trabajo de escritura de tareas repetitivas. - Asterisk Realtime
Ya conocemos esto de artículos anteriores, como como el uso del Web-MeetMe (configuraciones de salas de conferencia directamente desde la Web, a través de bases de datos en “tiempo real” (realtime). Pero ahora una visión un poco mas práctica de como se trabaja con Realtime, ya que realmente el Web-Meetme siguiendo los pasos venia prácticamente preparado paso por paso y no podíamos entender que estaba haciendo realmente a nivel interno. La utilidad de Realtime sobre configuraciones en ficheros de texto, es simplemente el hecho de poder introducir modificaciones constantes de una forma ultra-rapida (mediante un interfaz web por ejemplo que acceda a la base de datos). Un ejemplo tipico: en la web vemos el listado de usuarios, con un boton para borrarlos cuando los damos de baja, y luego un mini formulario en el que ponemos el usuario y la contraseña y damos de alta una extensión inmediatamente. No habria que estar accediendo al servidor, accediendo al fichero de texto, editándolo, guardando, recargando el modulo, etc… En configuraciones estáticas (situaciones en las que rara vez se cambia una extension por ejemplo), es poco practico por que puede salir mas caro el collar que el perro. Pero si un dia nos da por diseñar una interfaz web sencilla, y una base de datos (fichero .sql) que precargue nuestros valores default, podriamos implementar esto en tiempo record y podríamos tenerlo siempre presente en todas nuestras instalaciones (quizá algún día lo plantee esto como un articulo, muchos temas ya tengo pendientes conforme avanzamos en el mundo de Asterisk). Un primer inconveniente que encontramos, es que Asterisk pretende centralizar todas las conexiones a bases de datos a traves de una capa de abstraccion como ODBC, es decir que los conectores directos nativos como MySQL y PostgreSQL tienden a su desaparicion. Para los no demasiado experimentados en el mundo ODBC esto podria ser un inconveniente a corto plazo.
Si recuerdan, el Web-Meetme lo hacia todo a traves de ODBC asi que este problema lo salvan (lo que no salvan que Meetme tiende a desaparcer tambien en favor de ConfBridge (nueva aplicación para conferencias sin necesidad de timing, tambien hablaremos de ella en un futuro). Ahora sobre la configuración los ficheros involucrados En primer lugar /etc/asterisk/extconfig.conf necesitamos añadir una linea del tipo => ,, En el caso ejemplo del Web-Meetme era: meetme => odbc,meetme, booking El segundo fichero es el /etc/asterisk/res_config.conf [nombrebasededatos] enabled => yes // Esta activada la conexion dsn => el Data Source Name del driver ODBC pre-connect => yes // La conexión se ejecuta al arrancar Asterisk username => usuario de la base de datos // En caso que conectemos por Puerto a la base de Datos, como en bases remotas password => password de la base de datos // Lo mismo que lo anterior En el ejemplo que estamos siguiendo: [meetme] dsn => meetme (este es el contexto que creamos antes en el sistema) username => asterisk (supuestamente va a ser nuestro usuario para asuntos de Asterisk y servidor de base de datos) password => asterisk (o la que le pusiéramos) pre-connect => yes enabled => yes Ahora la configuracion del driver odbc en el sistema, /etc/odbc.ini [meetme] Description = ODBC para MySQL // Una descripcion cualquiera Driver = MySQL // El driver ODBC que utilizamos, en este caso para MySQL por el tema ese que va a tender a desaparecer que comentábamos antes Server = localhost // Servidor donde esta la base de datos Database = meetme // Nombre de la base de datos con la que trabajaremos Port = 3306 // Puerto de la base de datos User = asterisk // En caso que conectemos por puerto en vez de por Socket Password = asterisk // En caso que conectemos por Socket Socket = /var/run/mysqld/m = /var/run/mysqld/mysqld.sock ysqld.sock // // Por aquí conectamos por Socket Y finalmente /etc/odbcinst.ini [MySQL] Description = MySQL ODBC MyODBC Driver
Driver = /usr/lib/odbc/libmyodbc.so // librería ODBC del Driver MySQL Setup = /usr/lib/odbc/libodbcmyS.so // librería ODBC de Configuración MySQL Solo quedaria configurar la tabla y base de datos y ya preparado. Algunas consideraciones adicionales: para reducir el numero de peticiones a cache, el fichero de configuracion del modulo que estamos convirtiendo en “RealTime” introducimos la siguiente variable: rtcachefriends=yes De aquí pueden surgir multiples ideas prácticas que me gustaria probar personalmente y dedicar un articulo especifico con mis resultados, como por ejemplo, crear una funcion en func_odbc.conf para consultar algo especifico de una base de datos externa para tratarlo a traves del DialPlan, como por ejemplo consultar el telefono de un Cliente. - CDR y CEL
Esta parte trata sobre como se gestiona CDR (Registro de Detalles de Llamada) y la nueva implementación mas detallada del registro CEL, en el que es posible ver a nivel de flujo de llamada de DialPlan, no solo a nivel de canal. La verdad es que es meramente informativa con informacion sobre los campos que se utilizan, y algunas aplicaciones de dialplan para edicion, pero realmente merece un articulo bastante amplio para poder entrar en detalle incluso algun mecanismo para extraer informacion como vimos en el articulo de CDR-Stats, una gran aplicación para poder visualizar los datos de forma bastante generica (y recuerdo que quede en montar un software para analizar llamadas pero mas en detalle para un proposito en concreto). - El mundo de las Tarjetas Analogicas
Ya dedique varios articulos a este tema cuando empece a trabajar con la tarjeta TDM410P como el siguiente y la segunda parte del mismo. mismo. Algunos conceptos novedosos y no vistos hasta la fecha: Sobre la tecnologia Analogica, existen tres posibles de sistemas de señalizacion, (en el fichero chan_dahdi.conf) ground start (en desuso), loop start (tambien en desuso) y kewl start (sistema mas utilizado en la actualidad, 99% de los casos). Otra novedad que trae la version 1.8 es la posibilidad de crear contextos en el chan_dahdi.conf y tener por ejemplo un contexto generico [channels] donde especificar ciertos argumentos especificos de la tecnologia analogica (que eran los que soliamos definir antes del channel => cuando utilizabamos un modulo FXO Ejemplo: [channnels] usecallerid = yes transfer = yes …
[telefono-analogico] callerid = “Telefono Analogico” <1001> context= extensiones signaling = fxo_ks dahdichan = [linea-analogica] callerid=asreceived context = llamadas_entrantes signaling = fks_ks dahdichan = Pero luego, en el Dialplan tenemos que seguir definiendo en canal a la vieja usanza (DAHDI/1, DAHDI/2, etc…) Dato importante de las lineas extrantes analogicas, es que hay que mandarlas a un contexto en el DialPlan (por ejemplo, llamadas_entrantes) y dentro de ese contexto, poner la extension “s” “s ” (start) ya que es imposible imposib le reconocer hacia donde pretende ir esa llamada por las limitaciones de la “analogia”. Mañana parece que seguiremos con el tema de las conexiones de Tarjeteria, pero esta vez con una nueva que no hemos visto hasta la fecha, una tarjeta de Primarios. Espero vuestros comentarios sobre como quedo esta “modalidad” de blogging inline. Para mi particularmente resulto mas comoda porque en los huecos libres podia ir escribiendo, y no tener que hacer todo el texto ya a deshoras y ademas tambien ha servido un poco con “apuntes personales” de lo visto para revisiones futuras (como realmente es el blog entero para mi personalmente). tags: asterisk asterisk,, asterisk ad, ad, cdr cdr,, cel cel,, dahdi dahdi,, dialplan dialplan,, digium digium,, fxo fxo,, FXS FXS,, ground start, start, kewl start, start, loop start, start, macros macros,, realtime realtime,, tarjeta analogica, analogica, tarjetas analogicas, analogicas, vanced 2 comments! 30/01/2011 14:40
Conquistando el Dialplan II: Configuración DID para Operadores IP 2 comments by SirLouen in Aplicaciones Aplicaciones,,Asterisk Asterisk,,DialPlan
Para todos aquellos que utilizamos operadores SIP tenemos la gran posibilidad de adquirir múltiples canales entrantes a muy bajo coste. A día de hoy la verdad que las llamadas salientes salen realmente caras, sobre todo si nos vemos en entornos empresariales. Ya hace tiempo os comente múltiples alternativas que había barajado en su día, con operadores como Netelip, Voztelecom, Telsome. A día de hoy, 2 céntimos el minuto para llamadas nacionales: Es muy caro. Tenemos alternativas internacionales como CheapVoip, pero aquí entra en juego el tema de las latencias. Además estas no nos ofrecen líneas de entrada y/o DID por tanto no podemos adquirir un sistema integral de llamadas tanto de entrada como de salida.
Aquellas empresas que si ofrecen canales de entrada, “se aprovechan” a un alto coste para la salida. Podemos combinar ambas soluciones, y de hecho, debemos, pero ya en estos casos las líneas de entrada empiezan a compensar cada vez menos.
Aun así, para configuraciones de pocas líneas de entrada (menos de 10) y relativamente pocos DID, (menos de 50), siguen siendo soluciones factibles. Por ejemplo una de las soluciones más óptimas en el mercado español, VozTelecom, con líneas de calidad muy muy alta a nivel de latencia, jitter, etc., ofrece por 8 euros, 2 canales de entrada, y 1 DID, 4 euros el DID adicional geográfico. Encima, los temas técnicos los libramos, y no tenemos que contratar mantenimientos adicionales para preservar la calidad del servicio Si optamos la opción de Telefónica, tenemos una línea RDSI por 29 euros al mes, más el mantenimiento, habría que sumarle, mínimo, 4 euros para preservar una calidad aceptable de respuesta. Esto hace 33 euros. Luego los DID son relativamente baratos, en torno a los 2 euros. Si no queremos optar por la opción del primario, 4 RDSI haciendo un grupo ISPBX (para saltos automáticos y demás), sumaria un total de 132 euros. En caso de VozTelecom hablaríamos de 32 euros. Luego si queremos 30 DID, serian 60 euros más para Telefónica 192 euros, y 120 euros para Voz Telecom: 152 euros. Solo 45 euros, estamos en el umbral. Aunque obviamente la solución con líneas RDSI es muy superior a la solución VOIP, porque además que podríamos “aislar” el sistema PBX a un nivel puramente local, si requerir de Internet, la calidad siempre suele ser superior a nivel de voz. Solo con un Gateway Epygi como el que vimos antes, tendríamos resuelta la papeleta. Vamos a poner el caso concreto, de que elijamos la solución VoIP. Ahí vamos con la configuración: En caso del Epygi, realmente no necesitamos un comando “register” en el fichero sip.conf para registrarnos contra el troncal. Pero en caso del operador SIP, si haría falta falta, como vimos con anterioridad. Esto nos “obliga” a ir hacia la extensión del Dialplan dentro del contexto que seleccionemos específicamente.
Y desde esa extensión, tendremos que realizar la configuración para seleccionar el DID que “recibamos” según los mensajes SIP que se intercambian durante la comunicación. Esto ocurre con la mayoría de los operadores IP, aunque algunos ejercen de troncal de forma equivalente al Epygi, que no necesitaremos realizar selección alguna: En el extensions.conf imaginando que si pusimos contexto destino, en la configuración del operador SIP, pero no pusimos extensión destino en el comando Register (último parámetro /ddi como vimos antes): exten => s,1,NoOp() exten => s,n,Set(cNum=${SIP_HEADER(TO):5:9}) exten => s,n,GotoIf($["${cNum}" = "987654321"]?1,1) exten => s,n,GotoIf($["${cNum}" = "912345678"]?2,1) exten => s,n,GotoIf($["${cNum}" = "988776655"]?3,1) exten => s,n,Hangup()
Con la variable general SIP_HEADER, seleccionamos la cabecera del mensaje SIP, y nos vamos a la posición 5 longitud 9 (el número de teléfono) para guardarlo en una variable local que le llamamos cNum. Aquí en 99% de los casos se encuentra el DID. – r) De todas formas haciendo debug en la consola (# asterisk – r) podemos ver exactamente qué valor está recibiendo esta variable, cNum Esta sintaxis es nueva para nosotros. La aplicación GotoIf es condicional. Con el formato GotoIf($[condición], se cumple, no se cumple), En este caso concreto, si se cumple, saltamos al contexto 1, 2 o 3 según lo que se cumpla, y si no se cumple, pasamos a la siguiente prioridad. La consulta de variables en Asterisk tiene el formato ${variable} en cambio la “escritura” de las mismas con la aplicación Set, se realiza sin nada, variable=. Esto es un poco técnico, aun con ciertos conocimientos de programación, esto se aprende en cuestión de segundos. Así en vez de ir discriminando con extensiones con el número DID como hacíamos con el Epygi, lo haremos con este sistema por condicionales. Lo que no tengo muy claro todavía es porque algunos operadores mandan bien (y sin entender a qué me refiero con “mandar bien” el DID para asignarlo directamente como extensión), y para otros, hay que hacer operaciones como estas para salir al paso. Si lo averiguo, actualizare este mensaje. Para finalizar con todo esto, voy a aprovechar, para hacer un apunte fuera del contexto. El tema es que Asterisk, por ventaja, o desgracia, favorece mucho a los informáticos, y acerca un mundo anteriormente exclusivo a ciertos técnicos especializados, o especialistas de las telecomunicaciones, al mundo de los informáticos. Por esto si realmente no tenemos nociones extensivas tanto de Linux como de programación, nos vamos a ver con un sistema bastante simple, (aun aceptable comparativamente con otras soluciones PBX), pero no vamos a poder sacar toda la potencia de su interior al máximo. No voy a pararme demasiado en temas de programación, variables, condicionales, bucles, aunque si explicando el formato, porque doy por supuesto que más o menos entendemos de que estoy hablando, y más considerando que desde hoy, la curva de aprendizaje va mejorando para el público entendido en esta materia, pero va a empeorar drásticamente para los que carezcan de estos conocimientos. tags: asterisk asterisk,, cheapvoip cheapvoip,, dialplan dialplan,, did did,, epygi epygi,, gateway gateway,, ispbx ispbx,, jitter jitter,, netelip netelip,, operador ip, ip, operador sip, sip, telefónica telefónica,, telsome telsome,, voip voip,, voztelecom 2 comments! 13:16
Conquistando el Dialplan I. Aplicaciones Asterisk: Voicemail no comments by SirLouen in Aplicaciones Aplicaciones,,Asterisk Asterisk,,DialPlan
Como ya sabemos, el Dialplan, plan de marcación, es el esqueleto en esencia de Asterisk. A partir de este se abre el sin fin de posibilidades que nos ofrece este sistema.
Solo el que conoce lo que ofrece el Dialplan al 100%, es aquel que realmente conoce Asterisk de verdad. Por ello, las series de documentación sobre Dialplan serán mensajes mas cortitos pero no por ello menos interesantes y que ayudaran a organizar mejor la información. Realmente ya vimos parte del potencial del Dialplan, con la creación de una operadora automática de coste cero, cero, ahora vamos a ver las funciones de Buzón de Voz para nuestras extensiones. Aquí básicamente hay dos actores principales. La Aplicación Voicemail, y el fichero voicemail.conf El fichero voicemail.conf puede llegar a ser todo lo complejo que deseemos en función de nuestras necesidades, pero voy a comentar un caso práctico en el que podemos ver diversa funcionalidad que podemos llegar alcanzar. Como la mayoría de los ficheros de Asterisk, se divide en contextos, como casi siempre, general, suele ser el genérico que afecta a todos los contextos por igual. [general] format=wav //Formato de las grabaciones grabacion es para el buzon de voz. Se admiten admite n otros formatos como gsm. [email protected] //Direccion del remitente de los envios attach=yes // Para enviar el fichero adjunto ad junto en los emails con el audio aud io delete=yes // Para permitir la opción de borrado bo rrado del mensaje de voz local l ocal en el servidor una vez enviado por correo eletronico maxmsg=100 // Maximo numero de mensajes permitidos pe rmitidos en la bandeja local loc al por buzon maxsecs=180 // Maximos segundos por mensaje me nsaje minsecs=2 // Minimos segundos por mensaje mens aje para desechar los mensajes mens ajes vacios o casi vacios skipms=3000 // Opciones del mensaje de audio, aud io, para indexarlo cara a desplazamientos d esplazamientos X ms adelante adelant e o detrás cuando sea reproducido en el pc del destinatario maxsilence=10 // Silencio máximo permitido, esto es e s importante cara a poder desconectar des conectar la llamada en caso de silencio antes de cumplir el máximo posible caso 180 segundos (en nuestro ejemplo) silencethreshold=128 // Este es el umbral de audio para el que qu e consideramos que qu e es un silencio, de aquí podemos ir mas abajo o mas arriba en función de nuestra necesidad, no hay un valor “ideal” maxlogins=3 // Intentos de acceso a voicemail, vo icemail, en caso de sobrepasarlos, sobrepas arlos, Asterisk desconectara descon ectara al usuario de su cuenta SIP/IAX emailsubject=Nuevo Mensaje de ${VM_CALLERID} emailbody=Buenos días ${VM_NAME},\n\nHemos recibido un mensaje en su buzon
de voz… // Esto seria el asunto y el cuerpo cu erpo del mensaje email. Aquí se pueden pued en aprovechar variables para poder formatear el correo y mostrar datos quizá interesantes para el destinatario. Algunas de estas variables de ejemplo: ${VM_CALLERID}: El numero identificador del llamante (el número de teléfono) ${VM_NAME}: El nombre del dueño del buzon (lo definiremos más adelante) ${VM_DUR}: Duracion del mensaje ${VM_DATE}: Fecha y hora de recogida del mensaje Mas variables pueden encontrarse aquí : en su correspondiente sección (tampoco son muchas más) emaildateformat=%A, %B %d, %Y at %r // Formato de la fecha para el email. Para la variable v ariable VM_DATE. Consultar el manual de date para mas información (# man date )
Con esto tenemos más que suficiente para componer mensajes para el buzon de voz y enviarlos por email. Ahora vienen los contextos. Como siempre, si es [default] es el genérico, y luego los contextos específicos. En principio vamos a poner uno genérico y uno especifico. [default] 1234 => 5678,Buzon de Ejemplo,[email protected] - En primer lugar, el número del buzón, luego lo utilizaremos en el Dialplan para la aplicación Voicemail así referirnos a este buzón - En segundo lugar, la contraseña para acceder al buzón. Tendremos que crear una “extensión” en el Dialplan para que el usuario pueda acceder a su buzón de forma interna. Esto solo es útil si no marcamos la opción de borrado de mensajes del buzón al ser enviados por email - En tercer lugar, nombre del buzón que luego utilizaremos en variables como VM_NAME - En cuarto lugar, Email del destinatario de los mensajes de este buzón Este es un ejemplo muy sencillo, pero a esto podríamos aplicarle un poco mas de complejidad al asunto [extensiones] 1000 => 9878,Mr. Lenny, [email protected],,attach=yes|delete=1 - En quinto lugar, iria la dirección del Pager… muy poco utilizado a dia de hoy - En último lugar, irían opciones especiales. En este caso, decimos que adjunto el mensaje, y lo borre a continuación. Si hemos activado las opciones en el contexto general, ira bien esto. Si queremos hacer “broadcasting” de mensajes de buzon a varios emails, hay varios métodos pero el que a mi mejor me ha funcionado es hacerlo en combinación a aliases del servidor de correo (en nuestro caso al usar Ubuntu, por defecto, Postfix)
1001 => 8765, Dpto. de Botijos, botijos@nuestroservidor,,attach=yes|delete=1 Nos vamos a /etc/aliases y añadimos botijos: [email protected],[email protected],[email protected]
Y refrescamos aliases comando: # newaliases Por ultimo no olvidemos recargar nuestro voicemail.conf #asterisk –rx ‘voicemail reload’ Ahora toca editar nuestro Dialplan para poder utilizar estos buzones recién configurados. Vamos al extensions.conf: Si queremos por ejemplo hacer que los usuarios puedan dejar mensajes a nuestro contestador tenemos que utilizar la aplicación Voicemail Ejemplo: exten => 1000,1,NoOp() exten => 1000,n,Dial(SIP/1000,30) exten => 1000,n,Voicemail(1000@extensiones,u) // En este caso, ponemos el número númer o del buzón que pusimos pusi mos antes @ el contexto al que q ue pertenecía, adicionalmente ponemos una opción, para que antes de dar el pitido de “empezar a grabar” diga el mensaje de “en estos momentos no nos encontramos, deje su mensaje después de oír la señal”. Aquí tenemos varias, opciones, en vez de utilizar los mensajes por defecto que se pueden encontrar en la carpeta de sonidos /var/lib/asterisk/sounds/ /var/lib/asterisk/sounds / todos los que empiezan por vm- tienen algo que ver con el buzón de voz y estas opciones. Las opciones posibles son: sin opciones: se escuchan las instrucciones para dejar el mensaje s: no se escucha nada (útil si queremos poner mensajes personalizados para cada usuario) su: mensaje de no disponible u: mensaje de no disponible + instrucciones sb: mensaje de ocupado b: mensaje de ocupado + instrucciones Con esto también podemos jugar con las aplicaciones Playback y Record, para con la opción “s” crear un buzón acorde a las necesidades de un usuario en concreto Por otro lado vendría la aplicación destinada a escuchar los mensajes guardados si no pusimos la opción de borrado automático: VoicemailMain. Tiene poca historia: exten => 10001,1,VoicemailMain(1000@extensiones) El tema es que a partir de ahí vendría un menú relativamente complejo, editable, y demás. Yo personalmente no lo utilizo ya que la función de envío a correo aparte de que me descarga el disco duro, hoy en día a la mayoría del personal le resulta formidable. Aun así, para aquellos que deseen profundizar, les dejo un enlace al manual por si acaso quieren probarlo. Cualquier consulta acerca de esto, no duden en comentármela! En principio, con todo esto, ya se podrían componer sistemas de Buzón de voz bastante interesantes. Como ven no es demasiado complejo y existen muchas alternativas y opciones. Yo personalmente opino que las opciones de envío a correo, todavía están muy poco elaboradas, pese a que se ha profundizado en ellas. Yo personalmente no he encontrado opciones por ejemplo, de envío CC o CCO (BCC) para envíos broadcasting (lo cual me resultaría muy interesante). Supongo que sería una cuestión de apoyar programando, al proyecto Asterisk. Quien sabe, a lo mejor más adelante nos animamos a ello.
tags: aliases aliases,, asterisk asterisk,, broadcasting broadcasting,, buzon de voz, voz, dialplan dialplan,, newaliases newaliases,, playback playback,, postfix postfix,, record,, sip record sip,, ubuntu ubuntu,, vm_callerid vm_callerid,, voicemail voicemail,, voicemail.conf No comment? 29/01/2011 18:49
Preparando nuestro sistema de FAX en Asterisk: Hylafax + IAXModem I AXModem 6 comments by SirLouen in Asterisk Asterisk,,Software
Hoy voy a tratar de explicar cómo crear un sistema de faxing a través de nuestro Gateway (o tarjeta) para poder recibir faxes a email, y poder enviar faxes con un software desde nuestros PCs. He observado múltiples manuales en la web, pero la verdad es que si no tienes “suerte” encontraras miles de problemas, especialmente en las últimas versiones de Ubuntu Server. Y la verdad es que cuantos más problemas mejor, así aprendemos más sobre el asunto que nos concierne. En primer lugar toca configurar nuestro IAX.conf para añadir una extensión para el FAX [iaxmodem] type=friend username=iaxmodem //secret=contraseña_de_la_extens //secret=contraseñ a_de_la_extension ion secret=fax qualify=yes notransfer=yes disallow=all allow=ulaw host=dynamic context=extensions callerid=”FAX” <100> requirecalltoken=no // esta línea ultima es muy importante importan te rebaja la seguridad de d e IAX para esta extensión, pero sino lo ponemos no funcionara IAXmodem en concreto Acto seguido vamos a configurar nuestro Dialplan para a través de un número DID que tenemos disponible o línea analógica conectada (como hemos visto en anteriores mensajes, configuraciones relacionadas al Gateway RDSI, o relacionadas al módulo DAHDI desde chan_dahdi.conf), indiquemos a que extensión se deben enviar los FAXes (en este caso IAX2/iaxmodem) que es nuestra extensión IAX para el FAX. Esto
se añadiría en el contexto que se envían las llamadas de nuestra PSTN (en nuestro caso desde-isdn) exten => 123123123,1,NoOp() exten => 123123123,n,Answer() exten => 123123123,n,Wait(3) exten => 123123123,n,Dial(IAX2/iaxmodem) Quiero recordar que cuando hagamos modificaciones en los ficheros es necesario “Recargar” nuestro asterisk para que tome los cambios. No estoy seguro en este punto, si ni siquiera lo comente alguna vez! – x dialplan reload # asterisk – – x iax2 reload # asterisk –
(Recargamos el extensions .conf modificado y el iax.conf modificado) Ahora toca configurar un modem capaz de reconocer los “tonos” de los faxes, a través de nuestra extensión IAX recién creada. Todo a través de software. La aplicación en cuestión, se llama IAXmodem
Podemos descargarla desde aquí: http://sourceforge.net/projects/iaxmodem/files/iaxmodem/ Ahora la descomprimimos: # tar – xvf xvf iaxmodem-versionquesea.tar.gz # cd iaxmodem-versionquesea Necesitamos alguna librería adicional en nuestro sistema para poder compilar: # aptitude install libtiff-dev libtiff-tools # ./configure # make Con esto creamos el binario iaxmodem. Lo copiamos en el path de ejecución de binarios, generalmente /usr/bin o /usr/local/bin o /usr/local/sbin # cp iaxmodem /usr/local/bin Y ahora nos toca configurar un puerto virtual para que iaxmodem sea capaz de generar la señal, tendriamos que crear el archivo /etc/iaxmodem/ttyIAX con la siguiente información: device /dev/ttyIAX owner asterisk:asterisk mode 660 port 4570 refresh 300 server 127.0.0.1 peername iaxmodem
secret fax cidname FAXIAX cidnumber 100 codec ulaw Es muy importante asignar un Puerto diferente al de IAX (4569) para que funcione puesto que esta extensión estará siempre en activo como veremos ahora. Sería necesario configurar un script de arranque event.d para que esto ocurra. Dentro de /etc/init/ #vim /etc/init/iaxmodem.conf start on startup respawn exec /usr/local/bin/iaxmodem ttyIAX Probamos para ver si hemos configurado bien iaxmodem: # iaxmodem ttyIAX su ccessfully. Si aparece: Registration completed successfully. Entonces hemos tenido éxito éxit o en la configuración. configuración .
Después arrancamos el “servicio” con el comando: # start iaxmodem
ATENCION: Este sistema de scripting es el sistema por defecto de las últimas versiones de Ubuntu, concretamente es Upstart, para más información: http://upstart.ubuntu.com/getting-started.html.. Anteriormente esto se hacia dentro http://upstart.ubuntu.com/getting-started.html /etc/event.d en versiones anteriores anterior es a la 9.10 e incluso antes esto e sto se hacía en inittab, inittab , clásico de sistemas Debian. Parece que se mantendrá ahora así, pero como Ubuntu va cambiando constantemente, obliga a tenernos actualizados constantemente, y por tanto esto está sujeto a modificaciones. Si no os arranca automáticamente, investigad un poquito, o mandadme un comentario a ver si os pudiera ayudar y/o actualizar este mensaje. Ahora viene la instalación de Hylafax para manejar los FAXes que entren por este modem. Primero descargamos las fuentes: # wget ftp://ftp.hylafax.org/source/hylafax-6.0.5.tar.gz # tar – xvf xvf hylafax-versionquesea.tar.gz # cd hylafax-versionquesea Y compilamos como casi siempre # ./configure Aquí nos muestra los directorios donde se encuentran aplicaciones básicas, decimos que si a todo si estamos conformes (que creo que lo estaremos casi siempre) # make # make install
Ahora necesitamos que faxgetty (para recibir faxes) funcione automáticamente como hicimos antes con iaxmodem. Lo mismo, introducimos el fichero de configuración en /etc/init: # nano /etc/init/ttyIAX.conf start on startup respawn exec /usr/local/sbin/faxgetty ttyIAX Y arrancamos con start ttyIAX igual que antes. Ahora tocaría configurar un poco el sistema de fax con faxsetup. En general todas las opciones por defecto, pero hay ciertas preguntas que debemos responder para mejorar la fiabilidad del sistema: Serial port that modem is connected to []? Ponemos ttyIAX que es nuestro iaxmodem También configuramos parámetros de número de fax y demás, no es que sea crucial pero cara al envío es importante puesto que en las cabeceras de los FAX esto es lo que aparece. Otra pregunta importante: Rings to wait before answering [1]? Ponemos “2” para asegurarnos que pasa un poco antes de empezar a recepcionar el FAX. No es fundamental, pero ayuda a que fallen menos Faxes por experiencia. Seguimos adelante hasta que nos pida configurar otro modem y decimos que no para terminar: Do you want to run faxaddmodem to configure another modem [yes]? Ahora vamos a probar que todo quedo bien configurado. Llamemos al teléfono que hemos configurado el FAX 123123123. Y si todo fue bien, oiremos los típicos pitidos de FAX. Por defecto, todos los faxes van a parar a /var/spool/hylafax/recvq en formato TIFF. Si queremos que el FAX recibido se envíe automáticamente, adjuntando la imagen TIFF en formato PDF, y utilizando una plantilla de envío en Español, tenemos que editar un fichero dentro de /var/spool/hylafax/etc/FaxDispatch y añadimos: TEMPLATE=es; FILETYPE=pdf; NOTIFY_FAXMASTER=errors; [email protected] case “$DEVICE” in ttyIAX) [email protected];[email protected];; esac Si fallara por cualquier razón, estaría bien que pusiéramos un email de administrador. En /etc/aliases hay que incluir la línea FaxMaster: [email protected]
Y “refrescar” los aliases: # newaliases Es importante respetar los „;‟ y sin espacios donde no tiene que haberlos. Considerar que es importante definir un FROMADDR exclusivamente, cuando utilicemos un Smarthost en nuestro servidor de correo que requiera autenticación, ya que por defecto se enviara el correo con el usuario “fax”. Todos los parámetros por defecto que no incluyamos en este fichero los recogerá de /var/spool/hylafax/bin/faxrcvd
Si teníamos la ruta de uuencode en setup.cache funcionara correctamente. Básicamente las instrucciones estas pueden encontrarse aquí Ahora viene la parte, para enviar un FAX, tenemos múltiples opciones. Vamos a considerar en principio que nos encontramos ante una red común en Windows, con máquinas Windows XP. Existe un software que carga un puerto de impresión para poder enviar Faxes como si s i de una impresión se tratase por po r una “impresora” virtual virtu al sobre este puerto. De este tipo hay varias opciones, pero la que vamos a tratar aquí de ejemplo es Winprint Hylafax. La página oficial de descarga es: http://winprinthylafax.sourceforge.net/ ACTUALIZACION: Ya existe version de Winprint Hylafax para Windows 7!: http://sourceforge.net/projects/wphfforwin7/files/ Y sobran las explicaciones de configuración, ya que en la propia página aparece un pequeño manual con capturas de pantalla. Pero este manual solo explica como configurar la interfaz en Windows. Por otro lado tenemos que tomar algunas consideraciones para hacerlo funcionar. Por un lado tenemos el fichero de configuración de “hosts” permitidos, usuarios y contraseñas. Se encuentra en /var/spool/hylafax/etc/hosts.hfaxd. El formato para registrar nuevos se puede consultar en la página de manual de este fichero man hosts.hfaxd
Básicamente se trata de una expresión regular bien explicada, en la que introduciremos la red, para la cual será permitido enviar FAXes con este software. Ejemplo: localhost 127.0.0.1 [email protected].[0-9]+.[0-9]+:: // Con esta línea sería equivalente equi valente a dar permiso a todos tod os los equipos de la subred sub red 192.168.1.0/24, además en la última pantalla de configuración, estaremos obligados a poner un usuario “fax” “fax ” pero no necesariamente necesariament e una contraseña. Lo más importante es especificar en la primera línea de la pantalla de configuración, el servidor Asterisk. Aparte sería interesante especificar el modem que vamos a utilizar para enviar (en nuestro caso ttyIAX) Tenemos otras opciones como Default Notify, que sería el correo de confirmación de entrega o error, también Address Book Format (dos ficheros o un fichero CSV para almacenar nuestra libreta de direcciones) y la ruta de nuestro ordenador donde queremos
guardar la libreta (ejemplo C:\libreta), y finalmente parámetros de calidad y tipo de papel. Con esto, al imprimir una hoja por esta impresora, nos pedirá los datos de envío y procederemos con el mismo Por último, si queremos que las notificaciones lleguen en español necesitamos crear un fichero dentro de /var/spool/hylafax/etc/FaxNotify y añadimos: TEMPLATE=es; Muy parecido a lo que hicimos en el FaxDispatch Voy a comentar un aspecto que puede ser interesante para muchos, ya que el envío de FAX y la recepción suele traer muchos quebraderos de cabeza. Las líneas RDSI, primarios, y líneas analógicas, es decir, el mundo PSTN es realmente la única vía aceptable para poder manejar la señal de FAX sin grandes complejidades. El envío a través de proveedores SIP, o a través de enlaces GSM puede dar lugar a problemas y errores que son bastante difíciles de solucionar, y yo personalmente aún no he conseguido aliviar, aunque la verdad es que resultaría bastante interesante profundizar sobre este tema. Concretamente si leísteis mensajes anteriores, anteriores, veréis como todas las salidas de mi central de pruebas son a través de enlaces GSM. Esto quiere decir, que he tenido que hacer modificaciones específicas en el Gateway Epygi, y en el Dialplan, para poder enviar Faxes específicamente, por las líneas RDSI que a priori, iban a estar exclusivamente dedicadas para la recepción de llamadas. Para ello aquí van las dos modificaciones de ejemplo que tuve que hacer: 1. Por un lado en el extensions.conf, extensions .conf, cree una regla adicional sobre la que ya había, para salida al exterior: exten => _3[9]ZXXXXXXX,1,NoOp() exten => _3[9]ZXXXXXXX,n,Dial(SIP/${EXTEN}@my-isdn,30) exten => _3[9]ZXXXXXXX,n,Hangup() Con esto estoy diciendo, que para mandar un fax, primero hay que marcar el número 3. Así le mandaremos al Epygi un número del tipo “3987654321” 2. Ahora en el Epygi, como vimos, en Call Routing -> Call Routing Table vamos a crear una ruta equivalente a las otras dos que hicimos, pero saliendo por uno de os troncales donde teníamos conectado una línea ISDN (en nuestro caso por ejemplo, el troncal 2). La única diferencia es que en la primera parte de la configuración pondríamos: Enable Record activado Tipo de llamada, ISDN Pattern: 3* (para que sean todas las llamadas que empiecen por 3, es decir las que vienen para FAXes) Number of Discarded Symbols: 1 (para que descarte el primer símbolo, el 3, a la
hora de hacer la llamada a través del ISDN) Description: isdn fax (aquí ponemos lo que queremos, yo pongo isdn 1 para saber que troncal de fax)
El resto, todo igual que los otros que ya configuramos. Incluso podríamos hacer otra línea equivalente, con razón de Failover igual, para tener la opción de ocupar múltiples troncales RDSI en caso que los otros estuvieran ocupados. Si quisiéramos enviar un FAX de prueba utilizaríamos la herramienta sendfax con el siguiente comando: $ sendfax -n -d 33987654321 /etc/issue.net // Enviaríamos la información de /etc/issue.net / etc/issue.net simbólicamente simból icamente Seguramente recibamos un error con la métrica de fuentes Courier Bold. Necesitamos instalar las fuentes ghostscript para ello podemos descargarlas y descomprimirlas en el directorio /usr/local/lib/ghostscript/fonts que es el que por defecto utiliza Hylafax para estas fuentes (sino existe podemos crearlo) # mkdir /usr/local/lib/ghostscript/ # cd /usr/local/lib/ghostscript/ # wget http://ghostscript.googlecode.com/files/ghostscript-fonts-std-8.11.tar.gz # tar – xvf xvf ghostscript-fonts-std-8.11.tar.gz ¿Qué ocurriría si deseáramos auto enviarnos faxes con motivo de pruebas? Al enviar a través de la extensión iaxmodem, daría comunicando. Como es gratis tener múltiples instancias de iaxmodem (aunque no sean gratis los canales subyacentes a estas instancias, damos por supuesto que nos sobran para este supuesto), pues vamos a ello (aunque también se podría hacer que la extensión IAX fuese capaz de recibir y enviar múltiples llamadas sin dar comunicando, pero yo no lo he conseguido aun, quizá exista un parámetro para el contexto en el iax.conf que desconozco). En primer lugar debemos crearnos otro modem IAX como vimos antes, otra extensión IAX. De momento para simplificar el iax.conf vamos a crear una máscara basándonos en el contexto [iaxmodem] que creamos antes. Cambiamos [iaxmodem] por [modem] y le añadimos (!) [modem](!) //con los mismos parámetros que q ue antes, sacamos username, secret secr et y callerid [iaxmodem](modems) // y aquí ponemos esos tres parámetros p arámetros específicos del modem primero que creamos [iaxmodem2](modems) // Lo mismo que para iaxmodem pero nuevos nu evos parámetros username=iaxmodem2 secret=fax callerid=”Fax 2″ <101> Luego copiamos el ttyIAX y lo modificamos el nuevo ttyIAX2 # cd /etc/iaxmodem/ttyIAX # cp ttyIAX ttyIAX2
Ejemplo: device /dev/ttyIAX2 owner asterisk:asterisk mode 660 port 4571 refresh 300 server 127.0.0.1 peername iaxmodem2 secret faxiax cidname iaxFAX 2 cidnumber 101 codec ulaw Y lo probamos # iaxmodem ttyIAX2 y creamos el archivo para autoejecucion en /etc/init y demás: # cp/etc/init/iaxmode cp /etc/init/iaxmodem.conf m.conf /etc/init/iaxmodem2.conf /etc/init/iaxmode m2.conf Editamos el iaxmodem2.conf y cambiamos el final por iaxmodem ttyIAX2 # start iaxmodem2 Necesitamos configurar también Hylafax para la gestión de envío de estos faxes, para ello copiamos el archivo de configuración del otro modem. Realmente no necesitamos editar nada relacionado a faxgetty puesto que no tendríamos, al menos en este caso, recibir faxes por este canal de fax. #cd /var/spool/hylafax/etc/ #cp config.ttyIAX config.ttyIAX2 Y finalmente # faxaddmodem ttyIAX2 y dejamos todos los parámetros por defecto tal cual se nos presentan. Para inicializarlo # faxmodem ttyIAX2. Podemos crear un script como el de faxgetty que creamos antes para la recepción de faxes equivalente. En /etc/init creamos el fichero ficher o ttyIAX2.conf con: start on startup respawn exec /usr/local/sbin/faxgetty ttyIAX2 Realmente faxgetty es el único comando que funciona a modo “demonio” y sirve tanto para hacer que el modem IAX pueda tanto recibir como enviar. En este caso vamos a usar ttyIAX2 para enviar pero igualmente podría recibir.
Si pusiéramos en consola #faxmodem ttyIAX2, también resultaría para enviar, pero este comando no funciona para ser utilizando para dejarlo en background como demonio. Si alguien conoce alguna forma de conseguir este mismo efecto sin ponerlo en escucha con faxgetty actualizaría este mensaje con la novedad. Y ahora por fin si: $ sendfax -n -d 3987654321 -h ttyIAX2@localhost /etc/issue.net
Y finalmente recibiremos nuestro propio FAX como corresponde comprobando que todo está correcto y funcionando. Debo decir que realmente esto se podría haber resumido bastante si hubiéramos utilizado los paquetes de los repositorios de hylafax y demás, pero la verdad es que haciéndolo a mano como comentaba al principio se ve en detalle como operada cada uno de los sistemas involucrados y si tenemos un problema, sabremos donde ir a buscar con más sencillez. Exactamente lo mismo que ocurre con el propio sistema Asterisk, cuando lo compilamos desde las fuentes al principio de todo. Seguramente salgan 1001 problemas más que yo no haya contemplado aquí. Si tenéis alguna inconveniencia escribidla y trataremos de analizarla en el detalle para perfeccionar este mensaje al máximo. De nuevo, agradezco vuestro interés por Asterisk y por este blog, al igual que vosotros agradeceréis el interés aquí mostrado. No nos dejes caer en la tentación y líbranos del mal. Amén. tags: asterisk asterisk,, dahdi dahdi,, dialplan dialplan,, epygi epygi,, fax fax,, fax asterisk, asterisk, faxdispatch faxdispatch,, faxgetty faxgetty,, faxsetup faxsetup,, hosts.hfaxd, hylafax hosts.hfaxd, hylafax,, iax iax,, iax.conf , iaxmodem iaxmodem,, libtiff , modem modem,, ttyIAX ttyIAX,, ubuntu ubuntu,, ubuntu server, server, upstart,, winprint upstart winprint,, winprint hylafax 6 comments! 16/01/2011 08:35
Combate Analogico: Segundo Asalto 4 comments by SirLouen in Asterisk Asterisk,,Digium Digium,,Telefonia Analogica
Han pasado ya varios meses desde aquel mensaje en el que perdia la primera batalla tratando de conectar mi tarjeta Digium TDM410P. Pues bien, tras la tramitacion del RMA de la misma, fue aceptada, y al poco tiempo de ser enviada, recibi una de vuelta, que tristemente ha quedado en la estanteria casi todo este tiempo, hasta que recientemente, he tenido la oportunidad de trastear con ella. Concretamente en estos ultimos dias, he vuelto a montar otra maquina sencilla de pruebas, ya que el servidor servi dor anterior ha pasado a un u n estado de “semi- produccion” produccion” con un total de 10 extensiones en funcionamiento, y una concurrencia de unas 3-4 llamadas en horario laboral. A esta nueva maquina le he conectado la tarjeta digium, y he procedido como vimos en anteriores mensajes a instalarle Asterisk version 1.6.2 (que a fecha es la que mayor estabilidad me reporta). Es curioso como ya paso mucho tiempo desde aquel mensaje en el que planteaba otras versiones y la velocidad a la que va creciendo esto. Ahora empieza el segundo asalto. Lo mas importante como se vio en el primer asalto, es conectar la tarjeta en la ranura PCI y conectarle un molex de la fuente, si vamos a utilizar como es nuestro caso, un modulo FXS. Esto es asi, por el hecho de que debemos
entregarle corriente al telefono analogico conectado a este modulo, si solo tuvieramos modulos FXO en esta tarjeta, no haria falta realmente este conector. En este caso, disponemos de un modulo FXS conectado en el puerto 1 y un modulo FXO en el puerto 4. Si realizamos la instalacion correcta de dahdi-linux-complete, solo necesitariamos tener un modulo activado en el fichero de configuracion /etc/dahdi/modules /etc/dahdi/module s para que nuestro sistema reconozca re conozca esta tarjeta de inmediato: in mediato: wctdm24xxp Por otro lado como vimos en su dia, lo necesario para configurar el fichero /etc/system.conf ya fue explicado. ex plicado. Solo hay que recordar el inciso in ciso que si el modulo es FXS ponemos fxoks y viceversa para el FXO, realmente indicamos lo que va a haber en el otro extremo, a mi personalmente me resulta un poco contra la logica sencilla, pero seguramente a otro nivel de logica, tiene mucho sentido, con el tiempo averiguare esto y si cabe os lo contare. Y tambien recordar que el FXS es el verde y el FXO el rojo. Una vez hechas estas configuraciones, solo quedaria adaptar nuestro fichero chan_dahdi.conf de asterisk para poder trabajar con estos modulos (aparte de la consiguiente configuracion del Plan de Marcacion para dar un uso practico finalmente). El fichero chan_dahdi puede ser tan sencillo o tan complejo como deseemos ya que permite una personalizacion casi milimetrica del sistema con respecto a la red telefonica. El contexto principal en este fichero es [channels] y a partir de ahi surgen varias configuraciones basicas que voy a comentar a continuacion [channels] language=es // Lenguaje que vamos a usar usa r usercallerid=yes // Si queremos usar el identificativo identi ficativo de la llamada cidsignalling=v23 // Señalizacion CID mas comun, tambien esta la opcion bell cidstart=ring // Cual es la señal de inicio de llamada. Aqui en caso de lineas RTB normales, normale s, ring es lo mas comun, pero en caso de usar enlaces GSM analogicos, seria una buena idea poner otro sistema como polarity_IN (inversion de polaridad) por el propio funcionamiento de los mismos que no viene al caso ahora, aunque yo los he probado con ring y tambien funciona aun con mas propensidad a fallos. hidecallerid=no // Autoexplicativo, Autoexplicativo , si quieremos ocultar nuestro identificador id entificador de llamadas callwaiting=yes // Si podemos poner llamadas en e n espera, utilizamos el boton bot on Hook Flash (comunmente visto en los telefonos analogicos con una letrita R aunque configurable en la mayoria de los casos) para saltar de una llamada en espera a otra callwaitingcallerid=yes // En el caso de poder tener llamadas ll amadas en espera, poder ver el Identificativo de llamadas cuando vamos saltando de una a otra llamada threewaycalling=yes
// Llamada a tres activada, hay ha y que considerar especialmente especialmen te para llamadas a traves de de la PSTN, que estos valores deben estar soportados adicionalmente por la misma y la “servi cios adicionales”. mayoria de los operadores (Telefonica) suelen cobrar por estos “servicios transfer=yes // Poder transferir llamadas, llamad as, no tanto por limitaciones de d e nuestro Dialplan, sino por po r el de la PSTN como hablamos antes canpark=yes // Poder aparcar llamadas, llamadas , lo mismo. Diferencia entre poner una llamada ll amada en espera y aparcarla, es que en el segundo caso la utilidad es por ejemplo, recuperar la llamada desde otra extension diferente cancallfoward=yes // Para poder “reenviar” la llamada callreturn=yes // Para poder volver a recibir recib ir de vuelta una llamada reenviada reenvi ada sin exito echocancel=yes // Cancelacion de eco activado act ivado echocancelwhenbridged=no // En caso que la llamada quede “dentro” de la red ejemplo, de una extension analogica a un equipo SIP, para que no cancele el eco en vano (ya que la llamada realmente con minimo retardo no lo requiere). Es curioso porque esta opcion viene activada “yes” por defecto, y tenemos que desactivarla en la mayor parte de las configuraciones chan_dahdi echotraining=800 // Tiempo que tarda en ms para “aprender” como de “retardada” viene la llamada y que cancelacion de eco debe aplicar. En el algoritmo intervienen variables como el retardo medio, y el jitter que viene a ser algo asi como la desviacion estandar sobre el retardo medio. relaxdtmf=yes // Ya habiamos visto esto en la l a parte SIP… los dichosos DTMF suelen ser motivo de problemas especialmente partiendo de la base de que no sabemos que sistema lleva el llamante. rxgain=1.0 txgain=2.0 // Ganancias en decibelios decibelio s de la llamada entrante y saliente respectivamente busydetect=yes busypattern=200,200 // Con estas opciones, simplemente simp lemente detectamos si el otro lado esta comunicando con un un tono de comunicando clasico en nuestro auricular. Ademas podemos especificar la cadencia en ms de el tono de llamada a detectar. Esto es diferente en cada pais y lo suele suministrar una norma de la PSTN que puede ser consultada en las normas del proveedor principal, en caso de España, Telefonica por ejemplo answeronpolarityswitch=yes hanguponpolariryswitch=yes // Esto es fundamental para como comentamos c omentamos antes, la gestion gest ion de las llamadas en funcion si trabajamos directamente sobre una linea RTB, o si utilizamos un enlace GSM. En el primer caso, serian las dos opciones a no, y en el segundo caso, a si (yes) faxdetect=incoming // Para detectar faxes entrantes, entran tes, es util, si vamos a utilizar utili zar ese canal para recibir Faxes. Tambien esta both para ambos sentidos. El hecho de detectar faxes tiene ciertas aplicaciones como IAXmodem, Hylafax como aplicaciones de recepcion de FAX para
Asterisk, o envios automaticos de llamadas, y gestion de las mismas con Autodialers. mohinterpret=default // Musica en espera por defecto def ecto mohsuggest=default // Musica en espera sugerida sugeri da cuando ponemos una llamada ll amada en espera para este canal. Para todo esto que he explicado, hay miles de opciones y configuraciones posibles. Aqui he puesto una configuracion valida de ejemplo para funcionar desde 0. Se pueden consultar las opciones directamente en las explicaciones mismas que trae el fichero de ejemplo proporcionado por el propio sistema generado por la opcion del make de Asterisk “samples”. Finalmente, metemos la configuracion especifica de los canales para luego ser tratada desde nuestro Dialplan. En mi caso, he conectado un telefono Dect en el canal 1 (FXS), y un Enlace GSM en el canal 4 (por eso he puesto las opciones anteriores basadas en este caso en concreto). Asi quedaria: group = 1 // Grupo de llamada, equivalente equivalen te al fichero SIP context= desde-movil // El contexto al que sera dirigidas dir igidas las llamadas entrantes entr antes por este canal signalling = fxs_ks // Señalizacion del canal, en este caso si es intuitivo intuitiv o callerid=asreceived // No se si recuerdan cuando cuan do se configuro el gateway gate way Epygi, una de las opciones que habia que poner en la configuracion de las lineas ISDN es como pasar el Identificador de llamante al sistema. En este caso, tal como viene decimos channel => 1 Asi por un lado quedaria configurado el canal 1, FXS. Por otro lado el canal 4 FXO quedaria asi: group=4 context=extensiones signalling=fxo_ks callerid=”Telefono DECT” <101> mailbox=101@extensiones channel=>4 En este caso, como puede observarse es exactamente igual que la configuracion del fichero SIP en cuanto a lo que contexto, callerid, mailbox y demas pudiere referirse. Con esto ya quedaria integramente configurado nuestro fichero chan_dahdi.conf. Para “recargarlo” desde la consola (CLI) Asterisk tenemos que utilizar el comando: module reload chan_dahdi.so Para la configuracion del Dialplan solo tomamos en cuenta una consideracion muy sencilla. Los canales analogicos por tarjetas se representan como DAHDI/X siendo X el canal. Asi que toda la configuracion del extensions.conf es equivalente a si pusieramos SIP/(nombre del contexto sip) pero con DAHDI
Ejemplo, para la extension 101 del telefono Dect exten => 101,1,NoOp() exten => 101,n,Answer exten => 101,n,Dial(DAHDI/4) exten => 101,n,Hangup Asi de sencillo, asi mismo para enviar una llamada a traves del FXS creamos una regla para moviles en mi caso (Enlace GSM conectado al canal 1) exten => _[67]XXXXXXXX,1,NoOp() exten => _[67]XXXXXXXX,n,Dial(DAHDI/1/${EXTEN}) exten => _[67]XXXXXXXX,n,Hangup() Por cierto ya que ha salido el tema, ¿os habeis enterado que como novedad este 2011 empezaran a salir numeros moviles que empiezan por el 7? Finalmente creariamos el contexto [desde-movil] para recepcionar todas las llamadas entrantes, si es que llamasen al numero del movil en cuestion asociado al canal 1. Y con esto ya hemos ganado el segundo Asalto, abordando un poco la cuestion relacionada a las tarjetas de Asterisk y su configuracion despues de lo que se sufrio en dias pasados. De todas formas esto no sera muy frecuente en mis sucesivos mensajes porque como comente, yo no soy nada partidario de utilizar tarjetas por los motivos que explique en su dia. dia. Aunque es curioso que todo aquel que se quiera presentar a un dCAP (logico, porque digium solo fabrica principalmente tarjetas), ha de conocer esto en profundidad. Hay que ademas saber tratar con tarjetas BRI y PRI que tienen ciertas variaciones muy especificas. Pero para eso existe un comando todo poderoso que te hace la mitad del trabajo: dahdi_genconf . Basicamente te configura el fichero system.conf tras chequear que hay disponible entre la tarjeteria cargada en el sistema (Y que puede observarse con el comando dahdi_tools). Quiza vengan en un futuro mas detalles si tengo la oportunidad de trastear con otras tarjetas, sean BRI de otras marcas (¿Beronet?) o alguna tarjeta Primaria de Digium (creo que es la unica tarjeta que verdaderamente merece la pena en cualquiera de los casos). Para terminar me gustaría sugerir a todo aquel seguidor de mi Blog, si tiene interés en que profundice o experimente en algún tema no dude en planteármelo como un comentario y procederé con la cuestión. Todo sea por mejorar la curva de aprendizaje de todos aquellos que me sigan tras el paso por este Blog a través de mi experiencia. tags: analogico analogico,, asterisk asterisk,, chan_dahdi chan_dahdi,, chan_dahdi.conf , dahdi dahdi,, dahdi_genconf , dahdi_tools dahdi_tools,, dialplan,, digium dialplan digium,, enlace gsm, gsm, epygi epygi,, fax fax,, fxo fxo,, fxoks fxoks,, FXS FXS,, fxsks fxsks,, hook flash, flash, hylafax hylafax,, iaxmodem iaxmodem,, pci,, pstn pci pstn,, rma rma,, tdm410p tdm410p,, telefonia analogica, analogica, zapata 4 comments! 18/12/2010 22:20
Creando una Operadora Automatica de Coste Cero I no comments
by SirLouen in Asterisk Asterisk,,Basicos Basicos,,DialPlan
Es curioso observar que el 99,99% de sistemas de operadoras automaticas de las PBX de marcas reconocidas como Alcatel-Lucent, Panasonic, Siemens, el coste de poseer un sistema de operadora automatica, o IVR (interactive voice response), sea directamente proporcional al numero de canales entrantes de voz. Y la pregunta es, ¿realmente estas operadores ofrecen algo mas que no podamos obtener a traves de nuestro magnifico sistema Asterisk? La respusta no solo es negativa, sino que ademas podemos discriminar que vamos a ser capaces a traves de nuestro plan de marcacion de realizar operaciones totalmente casi inimaginables para estas centralitas de alto nivel, al menos, sin una dificultad de alto standing. ¿Pero no se supone que las PBX de marcas reconocidas poseen interfaces de configuracion ampliamente escalables y de relativa facil configuracion? Solo si queremos hacer funciones, que no sobrepasen el nivel del mar. Y eso es lo que vamos a tratar de hacer hoy, pero sin ir demasiado lejos, solo andando un poco por la arena. Segun veiamos el otro dia con respecto a los Gateways, Gateways, y la capacidad de recibir llamadas entrantes, vamos a plantear un nuevo contexto dentro del DialPlan en el que manejemos dichas llamadas a nuestra voluntad. Partiendo de la base: [desde-rdsi] exten => 987654321,1,NoOp() exten => 987654321,n,Answer exten => 987654321,n,Goto(operadora,s,1) Tenemos la instruccion Goto, que nos permite desplazarnos a otro contexto (operadora), marcacion de extension (s) y prioridad (1). Ya hemos hablado sobre las prioridades y los contextos. ahora voy a hacer una breve reseña sobre las marcaciones de extension. Por un lado existen las marcaciones especiales: s viene de start, suele ser, la marcacion de inicio de todo contexto, una extension comodin para dejar claras las cosas por regla general. i viene de invalid, en caso que marquemos una extension que no pertenezca a un contexto, entonces iremos a esta marcacion de extension t viene de timeout simple, seria el caso de que se acabe el tiempo por una aplicacion que tenga expiracion de tiempo, como WaitExten T viene de timeout absoluta, existe una variable global (ya veremos variables locales y globales en otro momento) llamada TIMEOUT que establece el tiempo total que se permite mantener una llamada en activo, en el momento que expira este tiempo, entonces saltariamos a la T del contexto que nos encontremos Por otro lado existen las extensiones normales, y los patrones
Una extension normal simplemente es un numero cualquiera Un patron viene precedido por un guion bajo ”_” y permite que se puedan crear patrones de posibles extensiones numericas. Informacion detallada sobre esto, esto, la explico en un post mas antiguo Ahora ya que sabemos lo que necesitamos saber sobre extensiones comenzamos con nuestro contexto de IVR [operadora] exten => s,1,NoOp exten => s,n,Answer() exten => s,n, GotoifTime(8:00-14:00,mon-fri,*,*?abierto,s,1) exten => s,n,GotoifTime(16:00-18:00,mon-fri,*,*?abierto,s,1) exten => s,n,GotoifTime(*,mon-fri,1,jan?festivo) exten => s,n,Playback(fueradehorario) exten => s,n,Voicemail(100@default) exten => s,n,Hangup exten => s,n(festivo),Playback(festivo) exten => s,n,Voicemail(100@default) exten => s,n,Hangup Esto podria ser la estructura de una eficaz “introduccion” a nuestra operadora automatica. Leyendolo rapidamente, lo que tratamos de hacer es que salte al contexto “abierto” en caso que la llamada se encuentre en horario lectivo de la empresa, o que salte a la etiqueta “festivo” en caso que coincida que es dia de fiesta. En otro caso, lanzara un mensaje de “estamos cerrados”, saltara un buzon de voz para dejar mensajes y colgara, en caso que salte a la etiqueta “festivo”, algo parecido, un mensaje diciendo que es dia festivo en la empresa, buzon de voz y cuelgue.
Realmente esto se podria usar incluso como plantilla para miles de centralitas de PYMES y SOHO y ofreceria una configuracion basica, potente y eficaz, sin tener que andar merodeando en miles de interfaces graficas que pueden dar lugar al error facilmente. Esta claro que este blog esta dedicado a gente especializada en el mundo de la informatica y/o las telecomunicaciones por lo que trabajar sobre una pantalla con fondo negro y letras blancas no deberia ser demasiado drama y mas alla aun, deberia ser una gratificacion excepto en contados casos. casos.
Figura 1: “No exige aprender Linux o Scripting” Como si fuera algo malo
Ahora vamos alla con el detalle. En primer lugar vamos a introducir la aplicacion GotoifTime:
Como vimos con Goto, es equivalente, pero introduciendo una condicion temporal. Para los conocedores de Cron, esto es equivalente. En primera posicion, especificamos hora o rango horario, incluso varios rangos horarios. Por nuestro ejemplo podriamos haberlo resumido con: exten => s,n, GotoifTime(8:00-14:00,mon-fri,*,*?abierto,s,1) exten => s,n,GotoifTime(16:00-18:00,mon-fri,*,*?abierto,s,1) por exten => s,n,GotoifTime(8:00-14:00|16:00-18:00,mon-fri,*,*?abierto,s,1). Dos pajaros de un tiro como quien dice. El segundo parametro, es el dia de la semana, en ingles, los tres primeros caracteres, y ocurre lo mismo que con las horas, rangos, multiples rangos, etc. El tercer parametro, es el dia del mes y el cuarto, el mes en ingles y los tres primeros caracteres igual. El resto es equivalente a a la aplicacion Goto. Ademas aqui hemos introducido las etiquetas aparte de los contextos. Una etiqueta se ubica en una parte de la prioridad, esto es util cuando como ocurre en mis ejemplos en vez de poner prioridades del tipo, 1 2 3, etc pongo siempre n considerando lo de n+1 y queremos saltar a otra prioridad sin tener que saber la posicion relativa (esto nos permite la maxima genericidad en nuestros planes de marcacion y la capacidad de insercion futura en casos complejos). Sobre los ultimos dos parametros, dia del mes y mes, hay que considerar que esto permite mucho “poder” para par a crear genericidad a lo largo lar go de los años, como son el caso de los dias festivos. En nuestro ejemplo decimos: Si es lunes a viernes y ademas cae el 1 de Enero entonces es festivo. Aunque sea lo que sea realmente es festivo este seria un ejemplo especifico de la posibilidad saltar al contexto dia festivo realmente en estos dias, y si fuera un sabado o un domingo, como ya es festivo de por si, que de el otro mensaje (El de cerrado simplemente) . Opciones hay muchas y esto quedaria a nuestra libertad. Mas alla aun, asterisk 1.8 tengo entendido que incluso existe la posibilidad de crear calendarios con Google Calendar y desde ahi especificar los dias festivos y toda la informacion relativa a tiempos. tiempos. Hay mas informacion aqui, aqui, y esto nos ofreceria un nivel de potencia a bajo coste de complejidad para nuestro IVR que ninguna otra central se acercaria lo mas minimo. Ahora ya podemos decir que estamos sobre el nivel del mar, y eso que no hemos empezado siquiera en este mundillo. Por otro lado, tenemos la aplicacion Playback. Simplemente reproduce un archivo de musica que tengamos en la carpeta correspondiente en funcion de nuestro lenguaje definido. Los sonidos se encuentran en /var/lib/asterisk/sounds/ Finalmente esta la aplicacion Voicemail, que basicamente llama a otro archivo de musica (“deje su mensaje despues de oir la señal”) y guarda el mensaje de voz en el buzon especificado (100) del contexto por defecto (@default). Todo esto podemos verlo y configurarlo en el archivo de configuracion voicemail.conf que seguramente veremos en otro momento.
Y ahora ¿que ocurre con las llamadas que van al contexto “abierto”?
Vamos a hacer algo sencillito en abierto para terminar por hoy, y mas adelante intentaremos profundizar aun mas en todo esto. [abierto] exten => s,1,NoOp exten => s,n,Background(listadistribucion) exten => s,n,WaitExten(20) exten => 1,1,NoOp exten => 1,n,Goto(comercial,s,1) exten => 2,1,NoOp exten => 2,n,Goto(postventa,s,1) exten => t,1,NoOp exten => t,n,Goto(telefonista,s,1) exten => t, n,Goto(s,1) Voy a leerlo: primero, saltaria un mensaje, que diria “Bienvenido a nuestra empresa, Marque el 1 para hablar con Comercial o Marque el 2 para hablar con Posventa, en otro caso espere y le pondremos con un Agente”. En caso de marcar el 1, le mandaria al contexto comercial, y en caso de marcar el 2, a postventa. En caso de “Timeout simple” le mandaria al telefonista.
Aqui solo tenemos dos aplicaciones que no vimos hasta el momento: Background es equivalente a Playback pero deja a la espera de marcacion de una extension. Podemos interrumpir el background si marcamos teclas en el telefono y saltaria a la extension del contexto marcada (hay mas opciones complejas, como saltar a extensiones de otros contextos pero no voy a entrar en detalles) Por otro lado Waitexten, basicamente establece el tiempo que tenemos para marcar una extension antes de ir a la extension especial “t”. Parece sencillo, y lo es. Asi que invito a hacer mil combinaciones con toda esta información para crear posibles IVR sencillitos que cumplan una funcion que para la mayoria de las PBX del mercado suele ser bastante compleja y obliga a pasar por miles de secciones de la interfaz grafica. Por esto, es suficiente por hoy. Seguiremos informando como suele decirse tags: alcatel alcatel,, asterisk asterisk,, background background,, buzon de voz, voz, dialplan dialplan,, extension extension,, gotoiftime gotoiftime,, invalid invalid,, ivr ivr,, operadora automatica, automatica, panasonic panasonic,, playback playback,, shell shell,, siemens siemens,, start start,, timeout timeout,, voicemail voicemail,, waitexten No comment? 12/12/2010 21:32
Conectandonos al mundo Real: El planeta Gateway II 3 comments by SirLouen in Gateways Gateways,,Introduccion Introduccion,,Telefonia Analogica
Como comentaba en el ultimo mensaje, hoy tenia la intención de explicar en detalle como se realizaría la configuración en Asterisk, para admitir el Gateway Epygi configurado, y por otro lado, poder presentar la sencillez configuración y manejo los FXS que proporciona el magnifico Gateway Linksys SPA8000. Por un lado hablando del Epygi, tendríamos que conectarlo via SIP como ya sabemos. En el fichero sip.conf que ya conocemos de anteriores configuraciones vamos a crear un apartado para el mismo: [epygi] host=dirección ip de nuestro gateway defaultuser=usuario que pusimos en la configuración del sip trunk secret= la contraseña correspondiente qualify=yes (para tener monitorizado el elemento) type=friend (para recibir y emitir llamadas a través del mismo) context=desde-rdsi (este es el contexto en el dialplan donde las llamadas de las RDSI a través del gateway) Con esto es suficiente, seguramente podríamos especificar alguna opción de seguridad adicional, pero sobre seguridad en Asterisk ya hablaremos otro dia. Ahora toca hablar un poco del dialplan, el fichero extensions.conf. Realmente no he dedicado un mensaje especifico a hablar sobre el Dialplan, porque como es un tema tan extenso, prefiero ir introduciéndolo según la necesidad vaya surgiendo, en un mensaje próximo, escribiré un pequeño manual para crear un sencillísimo IVR (Contestador Automatico) para manejar las llamadas que nos entren a través de este Gateway, o cualquier otro operador ip que podamos utilizar. Como dijimos antes, vamos a utilizar el contexto [desde-rdsi] para todas las llamadas que nos entren por nuestro Gateway. [desde-rdsi] exten => 987654321,1,NoOp() exten => 987654321,n,Answer exten => 987654321,n,… Muy sencillo Dialplan. Simplemente como vimos en anteriores mensajes, siguiendo la estructura general de todo Dialplan, pasamos la extensión en primer lugar. La extensión que recibimos es justamente la que nos pasa el Gateway, y como configuramos en la sección ISDN del mismo, enrutaba a la centralita poniendo el teléfono del DID como extensión llamante. Esto quiere decir, que si disponemos de varios DID y los configuramos en la sección que vimos, pues simplemente tendríamos poner poner cada DID como extensión y configurar en el dialplan como querríamos manejar cada caso (mandándolo a una extensión con el comando Dial, o a un grupo de extensiones, o
activando el IVR en secuencia por comandos, o toda la potencia en general que nos permite el Plan de Marcacion de Asterisk) Si todo esto lo hubiera tenido por escrito en el momento que empece a configurar el Gateway seguramente podría haberlo montado en cuestión de 15 minutos sin problemas, porque como puede verse es realmente sencillo de manejar. Si esto resulto facl, vamos a ver un poco acerca del Linksys, que es todavía aun mas sencillo, aunque viene cargado de opciones, que podríamos editar al gusto, en este mensaje solo vamos a centrarnos en los primeros pasos, echarlo a funcionar, comprobar que todo esta OK, y configurar Asterisk para que reconozca bien cada puerto a voluntad. En primer lugar, comentar que el aparato tiene 4 modos de uso -
Usuario Basico
-
Usuario Avanzado
-
Administrador Basico
-
Administrador Avanzado
Todo esto se selecciona desde la interfaz de inicio, arriba a la derecha, Admin, Advanced necesitamos estar para configurar el sistema con lo básico. En el apartado Router -> WAN Setup configuramos lo básico acerca del sistema de red del equipo. Direccion IP (Static IP), Mascara de red, y Puerta de Enlace (esto no es muy recomendable usarlo, si no vamos a necesitarlo para nada en particular, ya que podría llegar a exponer nuesto equipo a ataques foráneos), aunque sin esto no podremos utilizar opciones para tener actualizada la hora de los teléfonos como los “NTP Server”, aunque podemos configurarlo a mano, no es una utilidad en principio que nos vaya a resolver la vida en Asterisk. En el apartado Voice es donde realizaremos toda la conexión con Asterisk. Uno de los problemas que mas afecto a mi sistema, era el hecho de no poder recibir los DTMF correctamente. Esto se solucionó inmediatamente cambiando un parámetro dentro de Regional:
Con respecto a la interconexión SIP con Asterisk se realiza desde cada una de las Lineas del sistema (L1,L2,L3, etc) Entrando por ejemplo en la linea 1, L1, en el apartado siguiente:
Tan simple como configurar eso 4 parametros, el servidor Asterisk, el usuario y la contraseña que tendremos en nuestro servidor Asterisk. Ahora ya solo quedaria registrar esta linea FXS, como una extension (ext10 del ejemplo), en el fichero sip.conf [ext10](extension,codecs) callerid=”Extension Analogica” defaultuser=ext10 secret=contraseñasupersegura mailbox=10@default Tan sencillo como con configurar cualquier extension SIP que podamos usar en un terminar IP puro, o en un softphone como vimos hace tiempo Tras este resumen, tenemos claro, que si manejamos bien todos los mensajes que fuimos recorriendo hasta este, configurar este Gateway no supone ningun inconveniente. De todas formas como siempre podrian surgir inconveniencias, tanto para este como para el Epygi, yo estoy abierto para resolver todos los problemas que pudieran surgiros al respecto, y asi si cabe, engrosar con mas cantidad y calidad, el nivel de informacion que circule en este blog. Nada mas por hoy. Con tanto componente en funcionamiento, ya solo queda empezar a subir el listo un poco, el proximo dia hablaremos sobre un IVR de ejemplo y tambien hare una gran introduccion al mundo de los CDR (Call detail record, o registro del detalle de llamadas) para poder analizar llamadas guardadas en una base de datos del sistema, e introducire el primer software adjunto al sistema que he conseguido poner en funcionamiento y reporta unos excelentes resultados.
tags: analogica analogica,, asterisk asterisk,, dialplan dialplan,, did did,, dtmf , epygi epygi,, extension extension,, FXS FXS,, gateway gateway,, linksys linksys,, quadro quadro,, sip,, SPA8000 sip SPA8000,, telefonia 3 comments! 06/09/2010 15:58
Introduciendo un Proveedor SIP: Parte 2 1 comment by SirLouen in Asterisk Asterisk,,Basicos Basicos,,DialPlan DialPlan,,Introduccion
Tras la migracion, y aun a la espera del retorno de la tarjesta TDM410P enviada en garantia, hoy voy a hacer una pequeña explicacion de las ultimas modificaciones introducidas a nuestro sistema Asterisk, concretamente a nivel de DialPlan, para en detalle, el funcionamiento del Proveedor SIP que que configuramos el otro dia y por otro lado, algunos retoques para darle un poco mas de nivel a nuestro sistema, como una pequeña operadora automatica de pruebas. Realmente aqui se vera gran parte del codigo contenido en nuestro fichero “extensions.conf” y un poco la explicacion de cada atributo. [operadorip] exten => 851123456,1,NoOp() exten => 851123456,n,Goto(s, 851123456,n,Goto(s,1) 1) exten => sirlouen,1,NoOp() sirlouen,1,NoOp() exten => sirlouen,n,Goto(s,1) sirlouen,n,Goto(s,1)
Si recuerdan, el otro dia pusimos en el contexto del provedor SIP dentro del sip.conf, llamado “operadorip”. Este contexto vendra directamente aqui. La primera vez que hable del DialPlan no explique exactamente a que se referia cada argumento de la linea exten=> En primer lugar, exten, se refiere como su nombre indica, a la extension marcada a la que va a hacer referencia como primer argumento. Esto es lo mas extendido y utilizado por defecto. En este caso, la extension, hablamos del numero DDI que nos ofrece el operador IP ya que de alguna forma es como lo reconocera como primera “entrada” nuestra centralita. En algunos casos, el proveedor IP te ofrece un numero de usuario adicionalmente, y este numero de usuario tambien lo entrega el operador IP sustituyendo al numero DDI, de forma casi aleatoria segun comprobe tras diversas pruebas. Por eso decidi poner las dos posibilidades. Como segundo argumento, es el numero de prioridad en la lista de ejecucion. Lo tipico es poner en la primera linea el 1, en la segunda el 2, etc. Pero si ponemos en la primera el 1 y luego la n, significa que aumentamos el contador de prioridad linealmente, 1, n+1 (2), n+1 (3), etc. Esto es util si por ejemplo en un futuro tenemos intencion de meter
mas lineas intermedias, no tengamos que cambiar el numero de prioridad a toda la secuencia completa, algo engorroso y que puede dar lugar a errores. El tercer argumento hace referencia a la funcion que va a cumplir esa linea. En mi caso, siguiendo un buen consejo que me dieron, lo ideal seria poner NoOp (sin operacion), para poder asi asignarle el elemento 1 por defecto. Esto es una buena practica en general ya que si luego creamos Macros (equivalente a plantillas para secuencias del Plan de Marcacion), esto hace que exista cierta uniformidad y estandarizacion. Tampoco es crucial escribir asi, pero desde que se creo el Copy & Paste tampoco supone una gran inconveniencia y nos aportara mas que nos rebajara. Los siguientes Argumentos en embos casos, son condicionales GO TO, tipicos en programacion. La funcion GoTo recibe 3 parametros siendo como primer parametro, un contexto, si solo se dan dos, se conserva en el contexto en que nos encontremos. El segundo, seria la posicion de marcacion dentro de ese contexto. S viene a ser la posicion de inicio por defecto. Donde suele entrar todo (hace referencia a Start, comienzo) al entrar en un contexto. Finalmente indicamos el lugar de la prioridad donde queremos entrar. Tambien con la funcion Goto podriamos pasar 1 solo argumento, esto es el lugar dentro del a prioridad (y consideraria la posicion de marcacion y el contexto donde actualmente nos encontrasemos), tambien podemos pasar una bandera asociada a un nivel de prioridad como veremos mas adelante. Con esto, de alguna forma, si nos llaman a nuestro numero DDI, “ya estariamos dentro de la centralita”, ahora tocaria a traves de un Contestador Automatico, manejar esta llamada
exten => s,1,NoOp() exten => s,n,Answer exten => s,n,Background(menu) exten => s,n,WaitExten(20) Esto es bastante sencillo. Igual que vimos con anterioridad, recogemos la llamada con Answer, y con Background ponemos un sonido que tendremos registrado en nuestro directorio /var/lib/asterisk/sounds. Hay dos formas de crear sonidos 1. A traves de una marcacion marcacion con la funcion Record, grabariamos grabariamos nuestros propios sonidos 2. Directamente introduciendo la pista de audio en la carpeta indicada con el nombre en cuestion y segun el formato formato .gsm, .wav, etc que tengamos tengamos especifcado dentro de los codecs soportados en este contexto. Finalmente tenemos la funcion WaitExten que basicamente basicamente realiza la operacion de espera a que se marque un digito durante los segundos pasados como parametro. parametro. Este digito entra como marcacion DTMF y como comente en otra ocasion, aqui se originaron problemas por parte del operador IP, a raiz de las malas latencias, que al final consegui solucionar solucionar en el fichero de configuracion de disposistivos disposistivos SIP utilizando el modo DTMF “inband” exten => 1,1,NoOp() 1,1,NoOp()
exten => 1,n,Playback(ext1000) 1,n,Playback(ext1000) exten => 1,n,Goto(extensiones_interna 1,n,Goto(extensiones_internas,1000,1) s,1000,1) exten => 2,1,NoOp() 2,1,NoOp() exten => 2,n,Playback(ext1001) 2,n,Playback(ext1001) exten => 2,n,Goto(extensiones_interna 2,n,Goto(extensiones_internas,1001,1) s,1001,1) Una vez marcado el digito por DTMF iriamos a la posicion de marcacion, en este caso pongo dos ejemplos sencillos, lo unico especial, la funcion Playback que a diferencia de Background no espera una marcacion, simplemente reproduce un mensaje y continua hasta la siguiente orden. En este caso, cambiamos de contexto y ya finalmente nos vamos a nuestro contexto “privado” donde estan ubicadas las extensiones de nuestra oficina oficina tal y como configuramos con anterioridad. Ahora vendria la otra perspectiva, desde “dentro” hacia el exterior a traves del proveedor SIP. En este caso por motivos logicos de “seguridad” no nos interesaria que alguien pudiera acceder a traves de las marcaciones ma rcaciones DTMF en el mismo contexto “operadorip” y ser capaz de llamar al exterior. Por esto, la idea es que esto solo pueda marcarse desde el contexto “privado” donde se encuentran nuestras extensiones. En este caso la marcacion marcacion es un tanto especial y tenemos que introducir nuevos conceptos: ;Salida de llamadas Nacionales exten => _[689]XXXXXXXX,1,NoOp() exten => _[689]XXXXXXXX,n,Dial(SIP/${EXTEN}@netelip,30) exten => _[689]XXXXXXXX,n,Hangup() Como podemos ver, aqui aceptamos un total de 9 posiciones. Bueno parecen mas, pero aqui explico el formato especial de marcacion que he tenido en cuenta para este caso: En primer lugar, si vamos a usar caracteres especiales como X,N o Z necesitamos poner delante la barra baja. En segundo lugar, observamos los tres valores 6,8,9 contenidos entre corchetes. Al estar contenidos entre corchetes significa los posibles valores que puede tomar el primer digito, solo el 6 (moviles), 8 (numeros geograficos virtuales) y 9 (numeros geograficos de España). Tambien podriamos tener un guion tipo [67-9] en este caso estariamos considerando considerando los valores 6,7,8 y 9 seria lo mismo que [6-9] En tercer lugar tenemos digitos especiales. especiales. X significa cualquier valor entre 0 y 9, Z entre 1 y 9 y N entre 2 y 9. En este caso seguramente seria mas eficaz separar los moviles y los fijos dado que podriamos en un segundo nivel restringir las llamadas a numeros especiales tipo 902, 901, etc eliminando la posibilidad con [89]ZXXXXXXX. [89]ZXXXXXXX. Aqui tenemos tantas posibilidades como queramos.
Una vez marcada esta secuencia, nos encontramos con la Funcion Dial, que al igual que utilizado para marcar extensiones en este caso con la variable ${EXTEN} recogemos lo marcado en la posicion de marcacion y lo “enrutamos” a traves del contexto sip indicado tras la @ en este caso nuestro Proveedor IP. El ultimo parametro 20, es el tiempo que esperara tras marcar para que recoja tono la llamada, en otro caso colgara. Entendido esto podriamos crear sistemas de marcacion todo lo complejo que se nos ocurriesen. Y muy util para la creacion de plantillas, y para la generacion de extensiones de manera semi-automatica semi-automatica puesto que por parte del dialplan no seria necesario apenas escribir codigo si el patron de las extensiones es equivalente. Con esto doy una breve revision de la interrelacion de un proveedor IP y el Plan de Marcacion de nuestro sistema para poder darle uso. Pero el Dial Plan tiene mucha miga por dentro, miles de funciones. Seguire en sucesivos articulos poniendo mas ejemplos sobre posibles opciones que se me ocurran y que mas concretamente concretamente sean muy utiles en un entorno de produccion/oficina. tags: asterisk asterisk,, ddi ddi,, dialplan dialplan,, netelip netelip,, operador ip, ip, pbx pbx,, voip voip,, waitexten 1 comment... 20/06/2010 02:36
Curso Asterisk de Iniciacion: Dias 2 y 3 no comments by SirLouen in Introduccion
He dejado pasar sin mayor opcion algunos dias tras el ultimo mensaje. Tenia pendiente la escritura de mis impresiones y como fueron los ultimos dos dias del Curso de Asterisk de Iniciacion. La cuestión reporto grandes y mejores resultados en estos dias ya que tras la instalacion y los primeros pasos en el sistema Asterisk empezamos a realizar ciertos ejercicios con nuestra maquina y nuestro telefono. El día 2 fue íntegramente dedicado a la comprensión del sistema de marcación, Dial Plan de Asterisk. Tras haber visto, como conectar diferentes dispositivos con la Maquina Asterisk, llegaba el momento de interconectar todo entre si a traves de este mecanismo. El Dial Plan queda reflejado principalmente en el fichero extensions.conf del sistema. A lo largo del dia vimos numerosos ejemplos, entre los que se encontraban, llamadas directas a una extension, mascaras, algunas Aplicaciones, entendimiento del concepto secuencial del sistema, prioridades, etiquetas, etc. Tambien vimos un poco de programación, que contemplaban alternativas condicionales y bucles principalmente. Todo esto si que me resulto verdaderamente util, ya que al final de dia, tenia bastante claro como realizar la primera acción que tenía bastante interes y expectacion sacar del curso: Como configurar una Operadora Automatica (IVR/Autoattendant). Jutamente el
ultimo ejercicio del dia fue configurar una operadora muy sencilla, la cual debia poner un mensaje de Contestador Automatico en caso de estar fuera de la Oficina, luego un menu de marcacion, y la aplicacion de saltos condicionales, y de un pequeño bucle para comprobar que la persona no habia introducido por error la marcacion un numero determinado de veces, antes de colgar la llamada. Todo esto lo vamos a ver en profundidad en otro momento ya que constituye bajo la perspectiva del momento, el pilar principal del sistema. Un comentario extra, justamente ese día aprovechamos para ver el partido de EspañaSuiza, una lastima que perdiéramos de 1 gol, contra un equipo tan inferior a nuestra Selección! Pero definitivamente esto no hizo que variáramos nuestra programación, de hecho diría que fue el día mas productivo de los tres! (Espero que la Selección también se aplique el cuento en productividad para el futuro) El tercer dia, originalmente trataria sobre la adaptacion del mundo Analogico a nuestro sistema Asterisk. Para ello nos proveian de una Tarjeta Digium 410, con un modulo FXO y otro FXS, uno para conectar en teoria, a un Gateway con varios puertos FXS que haria las veces de enlace directo con otra centralita Asterisk, y el otro para conectar a un telefono analogico. Primero se vieron multiples conceptos basicos de la Telefonia convencional y luego se tantearon todos los ficheros de configuracion que involucraban esta idea. El sistema Analogico, especialmente a nivel interno Linux-Tarjetas lo maneja Dahdi (se ve que antiguamente se llamaba Zaptel). Aparte Dahdi y las tarjetas Digium ofrecen una fuente de reloj de sincronizacion para ciertas aplicaciones avanzadas, como las Salas de Conferencias (aplicacion MeetMe). En caso que necesitemos una alternativa a Dahdi, se podria plantear todo el sistema a traves de Gateways SIP y configurarlos dentro del sistema como interfaces SIP exactamente igual que cualquier otro dispositivo, como los configurados el primer dia del Curso. Luego todos los detalles analogicos de interconexion con Asterisk, y con el operador o telefonos analogicos, se configurarian aparte en el Gateway, a traves una interfaz web propia del Gateway. Pero en el caso de las tarjetas, aparte, en Linux es necesario cargar los modulos de sistema, y luego en el fichero chan_dahdi.conf la necesidad de indicar montones de parametros que detallan toda la configuracion en referencia a como debe tratar Asterisk a los citados Puertos. Tambien se hizo una buena reseña al mundo de los Primarios y los Accesos Basicos. El pequeño detalle negativo, fue el hecho de que los equipos que nos fueron proporcionados y hacian de servidor de Asterisk, no poseian puertos PCI libres (y las tarjetas Digium que nos ofrecieron eran PCI 2.2). Esto impidio que pudieramos probar por nuestra cuenta, si la configuracion expuesta funcionaba correctamente, y haber hecho algunas pruebas de integracion, con lo que habiamos realizado en los dias anteriores. Las pruebas se hicieron con un unico equipo que si poseia el citado puerto, manejado por el profesor. Realmente me hubiera gustado probar todo aquello en aquel momento que estaba en mi salsa con todo montado y sin mucho mas que hacer que eso mismo. Pero en los proximos dias, aprovechare para hacer las primeras pruebas con la tarjeta, y algun equipo que trate de configurar.
Por la tarde, se vieron algunas cuestiones mas avanzadas del sistema, como el uso de Macros, las salas de conferencia, y la gestion de Colas y Agentes. Con esto, ya he podido coger un buen espectro del funcionamiento del sistema en lineas generales. Debo decir que he quedado bastante impresionado con las funcionalidades basicas de Asterisk, mas considerando que para mi condicion en relacion a la informatica, todo el tratamiento del sistema me resulta muy cercano, y mucho menos complejo de lo que esperaba (ya que habia que tocar ficheros de configuracion / programar y comparando con ciertas interfaces graficas que proveen otro tipo de PBX, pense que iba a haber una diferencia ignominiable a nivel de complejidad, aunque ahora veo que nada mas lejos de la realidad, es bastante mas sencillo y versatil. Comparativamente esto es como tener que crear una pagina web, con un asistente de creación de paginas web, o poder crearla a nivel HTML con codigo. Es cierto que hay que aprenderse con código todos los detallitos que conforman el sistema, pero el poder y las combinaciones y opciones que esta opcion otorga, no tiene fin, ni limite, es posible dar alas a la imaginación, y todo lo imaginable. se puede hacer realidad. Como valoracion general, debo decir que me ha resultado bastante provechoso el curso de Iniciacion, y de hecho se lo recomendaria a cualquiera. El profesor resulto muy flexible en general, y el nivel dentro de lo posible se intento mantener lo suficientemente alto como para no quedarnos estancados sin avanzar. Por contra, principalmente, que fueron demasiados pocos dias, el precio por dia es un poco elevado, y el nivel de organización no fue el deseado. Un curso de 4 dias hubiera estado mucho mejor para cubrir algunos aspectos que se quedaron en el tintero, como la integración con IAX (el protocolo de intercomunicación entre centralitas Asterisk, con la idea de unir varias centralitas Asterisk y poder compatir ciertas cuestiones, como los Dial Plan), quiza haber tratado un poco mas el mundo RDSI, y poder haber realizado mas practicas para haber dejado todo claro como el agua. Aparte, tambien tuvimos ciertas dificultades desde el inicio, desde que los sistemas no estaban bien instalados, hasta el tema que comente antes de los puertos PCI, un grandisimo error (mas, para aquellos que ni siquiera adquirieron la tarjeta en propiedad para luego hacer sus practicas en casa, y para los que si lo hicieron, que no tuvimos la oportunidad de “catarla”). Espero poder avanzar ahora después de esto mucho mas rápido, y poder proveeros de mucha mas información para poder Acelerar la curva del Aprendizaje de Asterisk lo máximo posible. tags: curso curso,, dialplan dialplan,, introduccion No comment?
Asterisk 1.8: Usando las nuevas funciones de calendario
Otra de las novedades de Asterisk 1.8 que creo más se puede llegar a utilizar, es la característica de su integración con calendarios, ya que sin duda, una de las tareas de soporte más habituales, es habital que sea el cambiar los horarios de atención de la centralita , que suele requerir de una intervención en el dialplan. Gracias a esta funcionalidad, se puede crear un interfaz externo, comodo y visualmente atractivo, desde donde efectuar esta operativa, usando las herramientas habitales de una agenda. Así, cualquier usuario podría hacer muchísimas cosas de forma sencilla, como por ejemplo, que el horario de fuera de la oficina, se controle desde un calendario externo (por ejemplo, en una agenda en el correo corporativo, en lotus domino, exchange o gmail), que en función de tu calendario se te localice en un número o otro , se efectue alguna acción especial cuando estes de vacaciones o reunido (que no se te pasen llamadas o vayan a tu backup), se puedan configurar diferentes horarios de atención, o incluso, que se localice a un técnico o otro en función del horario o guardias especificas. La flexibilidad y rango de opciones que se alcanza, es como veis, muy grande, sobre todo cuando la mayoria de nosotros lllevamos la agenda ya sincronizada con el móvil , por lo que coseguir cambiar un desvio o otro, puede ser tán facil como actualizar, en el móvil, la entrada de la agenda. Incluso usando twittercal twittercal,, podriamos desde un simple cliente twitter actualizar nuestra calendario google, y actuar sobre nuestra centralita.
Desde el blog de irontec, ya vimos un imaginativo articulo, articulo, hace ya varios meses, en los cuales, a través de un AGI efectuado en Ruby, podian efectuarse características parecidas en versiones anteriores de Asterisk, pero en la 1.8, esta funcionalidad ya viene nativa y mucho más facil de integrar. A través del fichero calendar.conf, podremos definir el calendario a comprobar en internet (podemos definir todos los calendarios que queramos) y enlazarlo en el dialplan. Veamos un ejemplo de dicho fichero: [calendar_andres] type = ical url = http://www.google.com/calendar/ical/andres.gorostidi%40gmail.com/private00f5583d3d387ca8fe92d4cb2d9d0490/basic.ics user = [email protected] secret = miclavegmailsupersecreta refresh = 15 timeframe = 600 autoreminder = 10 channel = SIP/andres context = notificacion_calendario extension = s waittime = 30 Con esta entrada, definimos los parametros de calendario para un usuario, en este caso, usamos mi cuenta en gmail para el horario de la oficina (lo habitual seria crear un usuario genérico para la oficina).
¿ Como sabemos el formato de la url a usar en el calendar.conf?. Aunque esta “algo escondido”, no es complicado, la url con el fichero ICS que define las entradas de
calendario (puede usarse formatos estandar iCalendar o CalDAV, además del propio de Microsoft Exchange Server), la habremos sacado previamente de la configuraciṕn del calendario de google……..a este respecto hay que recordar que pueden, sobre la misma cuenta, compaginarse varios calendarios (incluso calendarios publicos tipo festivos nacionales, calendarios escolares, calendarios de partidos de futbol, etc), por lo que podemos escoger que calendario(s) utilizar, incluso configurar varias calendarios para difentes acciones, dentro de la misma cuenta google, y usarlos de forma publica, privada o compartida para diferentes acciones.
Una vez obtenidos los datos de los calendarios a usar en el calendar.conf, y introducidos en el formato adecuado (como hemos visto en el ejemplo al principio del artículo), ya queremos tener solo nos falta definir, en el dialplan, que comportamiento queremos dependiendo de nuestro calendario… [incoming] exten => 916719179,1,Answer exten => 916719179,n,GotoIf(${CALENDAR_BUSY(andres)}?cerrado:operadora,s,1) exten => 916719179,n(cerrado),Set(id=${CALENDAR_QUERY(andres,${EPOCH},${EPOCH} )}) exten => 916719179,n,Set(mensajehorario=${CALENDAR_QUERY_RESULT(${id},descriptio n)}) exten => 916719179,n,Playback($[${ISNULL(mensajehorario)} ? mensage_estandar :: ${mensajehorario}]) exten => 916719179,n,Hangup En el dialplan, invocamos a mi calendario especifíco (la entrada “andres” del calendar.conf, consultando si en la hora actual, el calendario está marcado como libre o
ocupado. Si está ocupado, CALENDAR_BUSY devolverá 1, y iremos entonces a la etiqueta “cerrado”, sino, seguiremos el flujo normal hacia la operadora. Incluso podemos añadir complejidad dependiendo de si el dia es festivo, se trata de un evento especial, es la hora de comida, o es horario extralaboral… solo necesitamos preguntar por los detalles de la entrada del calendario, usando la funcion CALENDAR_QUERY con los parametros inicial de “HoraInicio” y “HoraFin” en formato “unix time” (seconds from unix epoch)… Obtenemos asi la variable ID, que a continuación, usado con la funcion CALENDAR_QUERY_RESULT nos permitira obtener la descripción de la entrada (podemos actuar sobre los parametros summary, description, organizer, location, calendar, id, start, end, busystate, attendees...) , en la cual, podriamos haber especificado apoyandonos en el campo “description” el nombre del fichero de sonido que queremos pasar, por ejemplo. Este diaplan puede ser muy facilmente modificado, para coger, por ejemplo, el número de telefono de una persona que este de “guardia”, de forma que tengamos un calendario con todas las guardias horarias y la llamada se pase a la persona que en determinado momento tuviera tal función. Las funciones de calendario nos permiten áun mucho más, podriamos por ejemplo, conseguir que Asterisk nos llamara de forma automática para recordarnos una cita, haciendo uso de la posibilidad que tiene Asterisk para recoger los eventos que los calendarios disparan, y que previamente en el calendar.conf le hemos dicho cada cuanto consultar (refresh), cuanto tiempo almacenar en la consulta (timeframe) y que antelación usar en el aviso (autoreminder) [notificacion_calendario] exten => s,1,Answer exten => s,n,Playback(recordatorio) exten => s,n,SayUnixTime(${CALENDAR_EVENT(start)}) exten => s,n,Hangup Pero las funciones de Asterisk no estan encaminadas SOLO a leer los datos del mismo, sino también nos permiten escribir entradas en la agenda . Esto nos permite tambien nuevas funciones en el dialplan, ya que podriamos, por ejemplo, almacenar en el calendario todas las llamadas recibidas, y saber quien nos ha llamado, a que hora, y durante cuanto tiempo.. . [incoming] exten => 6000,1,Set(horainicio=${EPOCH}) exten => 6000,n,Dial(SIP/Andres) exten => h,1,Set(horafinal=${EPOCH}) exten => h,n,Set(CALENDAR_WRITE(calendar_andres,summary,horainicio,horafinal)=Llamad a recibida del numero ${CALLERID(all)},${start},${end}) Espero lo disfruteis, yo ya me voy a empezar a olvidar de los GotoIfTime.. Save this on Delicious
Los comentarios son el alma del blog. ¿No quieres decir nada? 11 Responses to Asterisk 1.8: Usando las nuevas funciones de calendario calendario
Yon guillen
Estupendo articulo, justo necesitaba montar un servicio de guardas con un calendario que pudieramos ver los miembros del equipo y modificarlo todos de forma sencilla (incluido jefes) y me viene como anillo al dedo. muchas graci as andres… por otra parte…se te ocurre ocurre alguna de de esas ideas tuyas tuyas para que quedara quedara constancia constancia de la llamada llamada de urgencia ? Lo ideal seria que en calendario se registrara la llamada hecha, que tecnico finalmente la atendio, y un sms de aviso al responsable d el servicio…es posible hacerlo todo desde dialplan sin que tenga que meterme en agis o programacion compleja? Si puedes darme una idea de como hacerlo te lo agradeceria… Gracias… 31-oct-2010 11:19:00
Elio Rojano
Con la aplicación CALENDAR_WRITE que lo explica al final del artículo, puedes ver como hacerlo. 31-oct-2010 01:04:50
Andrés Gorostidi Gorostidi
Yon, como dice Elio, usa calendar_write, practicamente es copiar antes del hangup del primer ejemplo el código que viene más tarde al final. . Si lo que te preocupa es lo del SMS, en asterisk tambien hay metodos para enviar de forma nativa mensajes por SMS (y recibir), pero requieren que tu operador de linea te de ese servicio por una linea convencional… Si no, hay diferentes proveedores de SMS que puedes contratar, y que te daran el AGI / Script que necesites para enviar ese SMS… (me temo que este ultimo caso si que necesitaras un pequeño script/agi al que invocar desde el dialplan, pero normalmente seran unas simples lineas en perl o php que te dara el proveedor de sms). . Tambien te recomiendo que mires el truco que se publica aqui, una idea bastante ingeniosa para, usando el api de google calendar, enviar sms de aviso de forma automática (y gratuita!) … 01-nov-2010 12:12:21
FrankEinstain
Hola Andrés, me apunto con Yon y opino que “estupendo articulo”. Sobre todo me ha sorprendido q ue se pueda integrar con Domino. Estoy buscando la manera de poderlo integrar en mi empresa (que usa Lotus). Me puedes decir o indicarme alguna dirección, donde pueda ver algún ejemplo de integración Asterisk-Domino.
Muchas gracias.02-nov-2010 08:26:16
Andrés Gorostidi Gorostidi
Domino es mucho mas potente, pero a su vez, requiere de un poco mas curro y conocer la plataforma…… .
El problema es que los ficheros .ICS solo los genera automaticamente el cliente Notes (a través de las opciones export), pero el servidor Domino no los genera…. por tanto no se sirven por web…… . Sin embargo, una de las grandes ventajas de domino es precisamente la personalización… y es muy facil hacer un agente en domino usando lotusscript, y que genere el ics, para lograr ese efecto. Usa el fichero que puedes generar con lotus notes como modelo de referencia y veras que el formato es sencillo de obtener…. .
El agente no es dificil de crear (simplemente avanzar através de un vista), lo bueno es que despues de un poco de curro con ese agente podrias si lo quisieras preprocesar informacion, incluso de diferentes fuentes, utilizar logicas adicionales, etc… . Tambien puedes hacer uso de vistas con codigo html passtru embebido de esa forma en 5 minutos creas el formato requerido…. tienes un ejemplo aqui abajo usando “pages”, es tan facil como cambiarlo para “views” -> http://www.dominoguru.com/pages/icalendar_domino-outlook.html 02-nov-2010 11:53:44
Santos
Me da un error de escritura en el calendario: “calendar_write_exec: Calendar „Santos‟ has no write function” Hay alguna opción en Google calendar para habilitarlo o es un error mio en la config? 04-nov-2010 03:20:38
Andrés Gorostidi Gorostidi
Pues… desgraciadamente, la funcion de calendar_write solo es valida para sistemas CalDAV o Exchange. En formato iCAL esta funcion aun no esta soportada…a soportada…asi si que si quieres escribir en el calendario de google (y no solo leer), hay que usar para esa parte, el API de google. Usa este enlace como referencia… -> http://lopezivan.blogspot.com/2007/05/usando-el-api-de-google-calendar.html 04-nov-2010 11:31:10
Elio Rojano
El calendario de google también se puede cargar como CalDAV. 08-nov-2010 01:59:55
Andrés Gorostidi Gorostidi
efectivamente , no lo sabia.. Thks elio !! efectivamente, Prueba entonces a cambiar y acceder por Caldav y no ical (usa el formato de URL https://www.google.com/calendar/dav/[email protected]/user) . Asi las funciones write deberian tambien funcionar………. funcionar………. suerte!!! 08-nov-2010 11:45:27
Alex Celi
Me parece que esto funciona con un tipo de calendario tipo Google Calendar o Exchange. La pregunta del millon es como hacer que esto funcione con una red tipo OpenLDAP o Linux 10-nov-2010 07:53:05
Andrés Gorostidi Gorostidi
Alex.. no entiendo muy bien a que te refieres………
Estamos hablando de estandares, y entre ellos estandares de calendario como el iCAL o el CalDav. Se nombran en el articulo servidores Google o Exchange, por ser de los mas conocidos, pero cualquier servidor (o programa) qe tenga un servicio de calendario/agenda que trabaje con estos estandares, seria valido, obviamente. Por otra parte, me hablas del estandar de directorio (LDAP) que tiene otra funcionalidad totalmente distinta, no entiendo como pretendes usar dicha funcionalidad funcionalidad para un servicio de calendario, cuando lo que nos da es un servicio de nombres y/o autenticaciñon. Ademas, Asterisk tiene cierta integracion con LDAP, pero para lo que LDAP es, o sea, un servicio de directorio. Esos estandar de directorio, calendario, o lo que sea, pueden por supuesto correr en Linux, Windows o lo que sea…… 16-nov-2010 10:38:56
Andrés Gorostidi
Compártelo! inShare A tus amigos también lo agradecerán
Lee otros artículos sobre: Asterisk asterisk 1.8
¿Qué es la telefonía IP? La Telefonía IP es una tecnología que permite integrar en una misma red - basada en protocolo IP - las comunicaciones de voz y datos. Muchas veces se utiliza el término de convergencia ia IP I P , aludiendo a un concepto un poco más amplio de redes convergentes o convergenc integración en la misma red de todas las comunicaciones (voz, datos, video, etc.). Esta tecnología hace ya muchos años que está en el mercado (desde finales de los 90) pero no ha sido hasta hace poco que se ha generalizado gracias, principalmente, a la
mejora y estandarización de los sistemas de control de la calidad de la voz (QoS) y a la universalización del servicio Internet. Cuando hablamos de un sistema de telefonia IP estamos hablando de un conjunto de elementos que debidamente integrados permiten suministrar un servicio de telefonia (basado en VoIP) a la empresa. Los elementos básicos que forman este sistema son: la centralita IP, el Gateway IP y los diferentes teléfonos IP. Las principales ventajas de la telefonía IP son la simplificación de la infraestructura de comunicaciones en la empresa, la integración de las diferentes sedes y trabajadores móviles de la organización en un sistema unificado de telefonía - con gestión centralizada, llamadas internas gratuitas, plan de numeración integrado y optimización de las lineas de comunicación - la movilidad y el acceso a funcionalidades avanzadas (buzones de voz, IVR, ACD, CTI, etc.) Más información en la Wikipedia: http://es.wikipedia.org/wiki/Voz_sobre_IP
Curso de Asterisk sábado, 14 de marzo de 2009 DIAL PLAN & FEATURES • Dial Plan & Features – Dial Plan: Basic DP simple, DP Interactivo – Dial Plan: Variables, Funciones, Condicionales – Dial Plan: Voicemail, Macros – Asterisk: Features COMANDOS BASICOS ASTERISK
Comandos Asterisk: asterisk – asterisk –r: r: permite reconectarse al servidor asterisk – asterisk –g: g: permite iniciar el servicio asterisk restart now: permite reiniciar el servicio de asterisk stop now: permite detener el servicio asterisk exit: Cierra la consola de asterisk DIAL PLAN BASICS El plan de marcación o “Dial Plan”, es el corazón de toda configuración configuración en asterisk, y de esta configuración dependerá el performace y eficiencia de nuestra central telefónica. Para poder personalizar la central a gusto se deberá comprender plenamente plenamente el funcionamiento del plan de marcación marcación de asterisk Sintaxis: El plan de marcación se configura en el archivo extensions.conf, este archivo reside usualmente en la carpeta /etc/asterisk/ El dial plan esta compuesto de 04 conceptos principalmente: principalmente: - Contextos - Extensiones - Prioridades - Aplicaciones CONTEXTOS: El dial plan se divide en secciones llamadas contextos, los contextos son nombres para un grupo de extensiones, las cuales pueden tener diferentes propósitos. Los contextos contextos también pueden interactuar entre ellos. Los contextos se denotan escribiendo el nombre del contexto entre corchetes “*nombre_de_contexto+”. Durante la creación de una extensión (sip.conf, iax.conf, etc) se define a que contexto pertenece. p.e. context=from-internal context=from-internal Todas las instrucciones por debajo del nombre del contexto son asignadas a ese mismo contexto hasta que un nuevo contexto sea declarado. Al inicio del archivo extensions.conf, existen dos contextos especiales -[General] -[Globals]
La sección general, contiene los parámetros generales del dial plan. La sección globals, contiene las variables globales del sistema, las cuales irán siendo utilizadas por los contextos siguientes. EXTENSIONES: Normalmente conocemos con el nombre de extensión, al numero que se le asigna a los terminales telefónicos, telefónicos, sin embargo en asterisk una extensión es mucho mas que un número _ telefónico, ya que define una serie de pasos (donde cada paso contiene una aplicación) que asterisk realizara durante una llamada. La sintaxis usada para declarar una extensión es la palabra “exten”, seguido de una flecha formada por una signo igual y un signo mayor p.e. exten => Esto va seguido por el numero de la extensión. exten => name,priority,application() name,priority,application() Una extensión completa esta compuesta de: El nombre (o numero) de la extensión. La prioridad (cada extensión puede incluir múltiples pasos, el numero del paso es llamado prioridad) La aplicación (o comando) es el que realiza la acción en la llamada. PRIORIDADES: Cada extensión puede tener multiples pasos, llamados prioridades, cada prioridad es numerada secuencialmente, comenzando con 1, y ejecutando una aplicación especifica. Existe un tipo de prioridad “no numerada” que se representa con la letra n y permite evitar problemas generados por la numeración secuencial. Esta prioridad “no numerada” signif ica ica que cada prioridad es igual a la prioridad anterior +1 Por lo tanto: n=n+1 p.e. exten => 123,1,Answer() 123,1,Answer() exten => 123,n,do something exten => 123,n,do something else exten => 123,n,do one last thing exten => 123,n,Hangup() 123,n,Hangup()
PRIORIDADES - ETIQUETAS: Desde asterisk 1.2, es muy común asignar etiquetas de texto (labels), a las prioridades. Esto es para asegurarnos que podremos referirnos a esa prioridad por un valor distinto a su numero, el cual probablemente no se conozca (prioridad n), y dado que actualmente el uso de prioridades no numeradas es muy usual en el diseño de una dial plan. Para asignar una etiqueta de texto a una prioridad, solo basta con agregarla entre paréntesis justo después del numero numero de la prioridad. prioridad. p.e. exten => 123,n(label),application() 123,n(label),application() APLICACIONES: Las aplicaciones son el caballito de batalla del dial plan, cada aplicación realiza una acción especifica sobre el canal actual, como por ejemplo, tocar una melodía, aceptando entradas de tono, marcar un canal, colgar una llamada, y así sucesivamente. Algunas aplicaciones como Answer() o Hangup(), no requieren mayor información para hacer su trabajo, sin embargo existen otras aplicaciones que si requieren de cierta información información adicional para procesarla, a esta información adicional se le conoce como parámetros, y para pasarle los parámetros a la aplicación deben colocarse entre los paréntesis. Ocasionalmente Ocasionalmente podríamos ver el pipe entre los paréntesis, y es que este signo es utilizado para separar mas de un parámetro. CONSTRUYENDO CONSTRUYENDO UN DIAL PLAN SIMPLE: Answer(), Playback(), Hangup() Vamos a construir un dial plan que consista en que , asterisk contesta la llamada, toca una melodía, y luego cuelga. Para este ejemplo vamos a asumir que ya hemos creado la extensión y que tiene como nombre de contexto “from“from-internal” Para la construcción de este dial plan utilizaremos las siguientes aplicaciones: Answer() Playback() Hangup() Answer(), es la aplicación que se utiliza util iza para que la central conteste una llamada que esta timbrando.
Se puede utilizar al inicio de la configuración configuración del contexto para una extension, pero en algunas ocasiones no es necesario. Como ya mencionamos, Anwser() no tiene argumentos Playback(), es la aplicación que se utiliza para reproducir un sonido grabado previamente en un archivo o a través de un canal. Cuando utilizamos playback, las entradas (inputs) del usuario desde la extension son ignoradas. Para utilizar playback() se debe ingresar el nombre del archivo sin la extension (p.e. .wav o .mp3) como argumento entre los paréntesis. Por defecto playback buscara el archivo ingresado como argumento en la ruta “/var/libs/asterisk/sounds” Si se desea hacer referencia a un archivo ubicado en otra ruta, se deberá ingresar la ruta completa entre los paréntesis Playback(/home/john/sounds/filename) Lo mas comun es crear una carpeta para estos archivos dentro de la ruta por defecto Playback(custom/filename) Ahora si vamos a crear nuestro dial plan [from-internal] exten => 1234,1,Answer() 1234,1,Answer() exten => 1234,n,Playback(hello-w 1234,n,Playback(hello-world) orld) exten => 1234,n,Hangup() 1234,n,Hangup() CONSTRUYENDO UN DIAL PLAN INTERACTIVO: Background(), WaitExten(), and Goto() La aplicación background, es la pieza vital para un dial plan interactivo. El background(), al igual que playback() reproduce una grabación, pero a diferencia de playback(), esta aplicación aplicación si permite al usuario ingresar entradas (inputs) desde el teclado del teléfono, estas entradas interrumpen la reproducción y se dirige a la extensión correspondiente. El uso mas común que suele dársele a la aplicación background, se encuentra en la construcción de menús de voz.
exten => 123,1,Answer() 123,1,Answer() exten => 123,n,Background(main123,n,Background(main-menu) menu) En el ejemplo anterior por defecto se cortara la llamada, pero si lo que queremos es esperar a que el usuario ingrese o marque algun codigo podemos agregarle agregarle la aplicación waitexten() al final. exten => 123,1,Answer() 123,1,Answer() exten => 123,n,Background(main123,n,Background(main-menu) menu) exten => 123,n,WaitExten() 123,n,WaitExten() La aplicación WaitExten(), le indica al sistema que espere por el ingreso de una extensión, la cual deberá estar dentro del contexto. exten => 123,1,Answer() 123,1,Answer() exten => 123,n,Background(main123,n,Background(main-menu) menu) exten => 123,n,WaitExten() 123,n,WaitExten() exten => 2,1,Playback(digits/2) 2,1,Playback(digits/2) exten => 3,1,Playback(digits/3) 3,1,Playback(digits/3) exten => 4,1,Playback(digits/4) 4,1,Playback(digits/4) Que ocurre cuando, tenemos un duplicado entre los primeros digitos de las extensiones disponibles: p.e. exten => 123,1,Answer() 123,1,Answer() exten => 123,n,Background(main123,n,Background(main-menu) menu) exten => 123,n,WaitExten() 123,n,WaitExten() exten => 1,1,Playback(digits/1) 1,1,Playback(digits/1) exten => 2,1,Playback(digits/2) 2,1,Playback(digits/2) exten => 3,1,Playback(digits/3) 3,1,Playback(digits/3) exten => 4,1,Playback(digits/4) 4,1,Playback(digits/4) Del ejemplo anterior si llamamos al 123, y luego presionamos la opción 123, volveremos a ir al menú, pero que ocurre si solo presionamos 1. Como se puede comprobar en la practica asterisk esperara unos segundos cuando se encuentra con mas de una alternativa posible. Luego de este tiempo ejecutara la extensión según los dígitos que fueron ingresados. Finalmente vamos a mencionar que la aplicación WaitExten() soporta como argumento el tiempo en segundos que esperara para que el usuario ingrese una extensión valida, luego de este tiempo terminara esta aplicación, y pasara a la siguiente prioridad si existiera.
Ahora vamos a utilizar la aplicación Goto(). La aplicación Goto(), es utilizada para enviar una llamada a otra parte del dial plan, la sintaxis de la aplicación Goto(), requiere los argumentos contexto, extensión y prioridad. exten => 123,n,Goto(context,ex 123,n,Goto(context,extension,priority) tension,priority) Background(), WaitExten(), and Goto() [from-internal] exten => 123,1,Answer() 123,1,Answer() exten => 123,n,Background(main123,n,Background(main-menu) menu) exten => 1,1,Playback(digits/1) 1,1,Playback(digits/1) exten => 1,n,Goto(incoming,123 1,n,Goto(incoming,123,1) ,1) exten => 2,1,Playback(digits/2) 2,1,Playback(digits/2) exten => 2,n,Goto(incoming,123 2,n,Goto(incoming,123,1) ,1) MANEJANDO INPUTS Y TIMEOUTS [from-internal] exten => 123,1,Answer() 123,1,Answer() exten => 123,n,Background(enter-ex 123,n,Background(enter-ext-of-person) t-of-person) exten => 123,n,WaitExten() 123,n,WaitExten() exten => 1,1,Playback(digits/1) 1,1,Playback(digits/1) exten => 1,n,Goto(from-internal,1 1,n,Goto(from-internal,123,1) 23,1) exten => 2,1,Playback(digits/2) 2,1,Playback(digits/2) exten => 2,n,Goto(from-internal,1 2,n,Goto(from-internal,123,1) 23,1) exten => 3,1,Playback(digits/3) 3,1,Playback(digits/3) exten => 3,n,Goto(from-internal,1 3,n,Goto(from-internal,123,1) 23,1) exten => i,1,Playback(pbx-invalid) i,1,Playback(pbx-invalid) exten => i,n,Goto(from-internal,1 i,n,Goto(from-internal,123,1) 23,1) exten => t,1,Playback(vm-goodbye t,1,Playback(vm-goodbye)) exten => t,n,Hangup() MANEJANDO INPUTS Y TIMEOUTS La opción i, se ejecuta cuando el usuario ingresa una opción invalida, y cuando se cumple el tiempo máximo disponible para que el usuario marque una extensión, la llamada será direccionada automáticamente automáticamente hacia la extensión t (el timeout por defecto es de 10 segundos). Utilizando las opciones “i” y “t”, obtenemos un dial plan un poco mas robusto y amigable. amigable. La extensión “S”
Cuando una llamada entra en un contexto sin un destino especifico (por ejemplo una llamada en la línea FXO), se pasa a la extensión s, “S” significa inicio o start. La extensión “S” es muy utilizada para generar menús en la central central telefónica. El siguiente ejercicio intentara mostrar el funcionamiento de la extensión s, haciendo uso de la aplicación Goto(). [menu] exten => _98,1,Goto(from-pstn,s,1 _98,1,Goto(from-pstn,s,1)) [from-pstn] exten => s,1,Answer() exten => s,n,Playback(hello-world) s,n,Playback(hello-world) exten => s,n,Hangup() s,n,Hangup() Habiendo definido esto ahora pasaremos a ver otras aplicaciones muy importantes, como la aplicación DIAL(), que nos permite comunicar comunicar a dos anexos (personas) entre si. Usando la aplicación Dial() La aplicación Dial(), es una de las l as aplicaciones mas importantes importantes con las que cuenta asterisk, tiene la capacidad de conectar dos usuarios uno con el otro. Esto resulta muy útil sobre todo cuando los usuarios están utilizando distintos tipos de medio de comunicación, por ejemplo. Por ejemplo podemos utilizar la aplicación Dial() para comunicar a un usuario que llama desde un teléfono analógico a través de la rede de telefonía tradicional, con otro usuario que se puede encontrar en cualquier parte del mundo conectado conectado a través de Internet con su teléfono IP. La sintaxis de Dial(), es mas compleja que la sintaxis de la funciones anteriores, y puede tener hasta 4 argumentos, el primero el el destino al cual esta intentando conectarte. Dial(type/identifier, timeout, options, URL) p.e. exten => 204,1,Dial(SIP/201) 204,1,Dial(SIP/201) exten => 202,1,Dial(IAX2/202 202,1,Dial(IAX2/202)) También se pueden llamar a un conjunto de extensiones p.e. exten => 111,1,Dial(SIP/202&SIP/203&SIP/204)
Usando la aplicación Dial() El segundo argumento me permite colocar el tiempo máximo que se ejecutara la aplicación Dial. exten => 123,1,Dial(Zap/1,10 123,1,Dial(Zap/1,10)) exten => 123,n,Playback(vm-nob 123,n,Playback(vm-nobodyavail) odyavail) exten => 123,n,Hangup() 123,n,Hangup() El tercer parámetro puede ser una cadena o carácter, la lista de opciones es bastante larga, y pueden encontrarla en el siguiente hipervínculo: http://www.voip-info.org/wiki/view http://www.voip-info.org/wiki/view/Asterisk+cmd+ /Asterisk+cmd+Dial Dial Usando la aplicación Dial() p.e. exten => 123,1,Dial(Zap/1,10 123,1,Dial(Zap/1,10,m) ,m) exten => 123,n,Playback(vm-nob 123,n,Playback(vm-nobodyavail) odyavail) exten => 123,n,Hangup() 123,n,Hangup() El carácter “m”, permite que el usuario que esta llamando escuche la MOH en lugar del tono de ring, hasta que la llamada sea contestada. Cuando recibimos una llamada podemos derivarla a un menú como el que hemos creado, pero a su vez podemos formar un menú mas completo con el comando Dial(), tal como se aprecia en el siguiente ejemplo: [from-pstn] exten => 123,1,Answer() 123,1,Answer() exten => 123,n,Background(enter-ex 123,n,Background(enter-ext-of-person) t-of-person) exten => 123,n,WaitExten() 123,n,WaitExten() exten => 1,1,Dial(Zap/1,10) 1,1,Dial(Zap/1,10) exten => 1,n,Playback(vm-nobodya 1,n,Playback(vm-nobodyavail) vail) exten => 1,n,Hangup() 1,n,Hangup() eten => 2,1,Dial(SIP/Jane,10) exten => 2,n,Playback(vm-nobodya 2,n,Playback(vm-nobodyavail) vail) exten => 2,n,Hangup() 2,n,Hangup() exten => i,1,Playback(pbx-invalid) i,1,Playback(pbx-invalid) exten => i,n,Goto(from-internal,1 i,n,Goto(from-internal,123,1) 23,1) exten => t,1,Playback(vm-goodbye t,1,Playback(vm-goodbye)) exten => t,n,Hangup() DIAL PLAN: VARIABLES, FUNCIONES, CONDICIONALES
Las variables pueden ser de 03 tipos: Variables Globales Variables de Canal Variables de Entorno Las variables ayudan a reducir o simplificar el contenido y la estructura del dial plan optimizando de esta manera el proceso de lectura de los archivos de configuración configuración de nuestra centralita. También sirven para agregar lógica a nuestro dial plan. Una variable es como un contenedor que puede mantener una valor durante un periodo. Variables Globales, se aplican a todas las extensiones en todos los contextos, esta variables deberán ser declaradas debajo del contexto [globals]. Por ejemplo vamos a guardar el valor SIP/201 en la variable JESUS [globals] JESUS=SIP/201 JESSICA=SIP/202 PABLO=SIP/208 exten => 123,1,Dial(${JESUS}&${JESSICA}) Ciertamente el tema de las variables resulta mas interesante cuando las asignamos a las troncales [globals] TELEFONICA=ZAP/1 1977=ZAP/2 BASE CLARO=ZAP/3 JESUS=SIP/201 JUAN=SIP/202 Este tipo de esquema nos permite elaborar un dial plan en funciona a variables y si se produce alguna modificación modificación en el esquema, solo bastara con cambiar cambiar el valor de la variable y no será necesario modificar todo nuestro dial plan. Variable de canal, esta variable se asocia solamente con una llamada, y a diferencia de las variables globales, las variables de canal se definen solo para la duración de la llamada actual, y solo están disponibles para los canales que participan de esa llamada.
Existen varias variables de canal predefinidas y están disponibles para ser utilizadas durante la marcación. p.e. exten => 125,1,Set(MAGICNUMBER 125,1,Set(MAGICNUMBER=42) =42) Las variables de entorno, son una forma de acceder a las variables del entorno unix desde asterisk, podemos hacer referencia a estas variables a través de la funciona de marcación env(), la sintaxis de esta variables v ariables es: ${ENV(var)} ${ENV(var)} ; donde var es una variable del entorno de linux o unix a la cual queremos referenciar. Este tipo de variables no son de uso común en el dial plan pero están disponibles si fuesen necesarias. Patrones de Marcado y Variable ${EXTEN} Los patrones de marcación son comodines que nos permiten simplificar un grupo de extensiones, con este tipo de comodines podemos podemos crear reglas que agrupen grandes conjuntos de números en unas cuantas líneas. X : equivale a un digito 0 – 0 – 9 Z : equivale a un digito 1 – 1 – 9 N : equivale a un digito 2 – 2 – 9 [15-7] : equivale a los dígitos 1, 5, 6, 7. . : Este comodín equivale a un o mas dígitos sin importar el valor Patrones de Marcado y Variable ${EXTEN} La variable EXTEN, toma el mismo valor que el numero de la extensión. exten => _XXXX,1,SayDigits(${EX _XXXX,1,SayDigits(${EXTEN}) TEN}) A partir de esta variable también podemos mutilar el numero marcado, por ejemplo si seguimos la siguiente sintaxis conseguiremos recortar los primeros dígitos del numero. $EXTEN:x:y$EXTEN:x:y- ; “X” es la posición donde comenzara el numero resultante y “Y” es la cantidad de dígitos que serán retornados exten => _XXXX,1,SayDigits(${EXTEN:2}) Patrones de Marcado y Variable ${EXTEN}
Los siguientes ejemplos ayudaran a comprender mejor las opciones: exten => _273443,1,SayDigits(${EXTEN:2}); ${EXTEN:2}=3443 exten => _273443,1,SayDigits(${EXTEN:1}); ${EXTEN:1}=73443 exten => _9388211,1,SayDigits(${EXTEN:3}); ${EXTEN:3}=8211 exten => _9388211,1,SayDigits(${EXTEN:3:2}); ${EXTEN:3:2}=82 exten => _9388211,1,SayDigits(${EXTEN:0:1}); ${EXTEN:0:1}=9 exten => _9388211,1,SayDigits(${EXTEN:0:2}); ${EXTEN:0:2}=93 exten => _9388211,1,SayDigits(${EXTEN:-4:2}); ${EXTEN:0:2}=82
exten => _XXXX,1,SayDigits(${EXTEN:2}), devolverá los últimos 3 dígitos que se hallan marcado Patrones de Marcado y Variable ${EXTEN} Un ejemplo mas practico seria el siguiente: Si queremos que los usuarios marquen el nueve antes del numero que van a llamar como en la mayoría de las centrales telefónicas el dial plan seria:
exten => _9.,1,SayDigits(${EXTEN:1}), _9.,1,SayDigits(${EXTEN:1}), de esa manera se devolverá el numero que se halla marcado pero sin el 9, listo para salir a la red publica de telefonía. Patrones de Marcado y Variable ${EXTEN} Habilitando una ruta saliente: OUTBOUNDTRUNK=ZAP/1 [outbound-local] exten => _9NXXXXX,1,Dial(${OUTBOUNDTRUNK}/${EXTEN:1}) exten => _9NXXXXX,n,Congestion _9NXXXXX,n,Congestion() () exten => _9NXXXXX,n,Hangup() Habilitando una llamada a Numero Fijo Local sin prefijo 9: OUTBOUNDTRUNK=ZAP/1 [fijo-local] exten => _[2-8]XXXXXX,1,Dial(${OUTBOUNDTRUNK}/${EXTEN}) exten => _[2-8]XXXXXX,n,Conges _[2-8]XXXXXX,n,Congestion() tion() exten => _[2-8]XXXXXX,n,Hangup() Patrones de Marcado y Variable ${EXTEN} Habilitando una ruta saliente a números Fijos LDN: OUTBOUNDTRUNK=ZAP/1 [outbound-local]
exten => _0[4-8]X[2-8]XXXXX,1,Dial(${OUTBOUNDTRUNK}/${EXTEN}) exten => _0[4-8]X[2-8]XXXXX, _0[4-8]X[2-8]XXXXX,n,Congestion( n,Congestion()) exten => _0[4-8]X[2-8]XXXXX,n,Hangup() Habilitando una llamada a Numero LDI: OUTBOUNDTRUNK=ZAP/1 [fijo-local] exten => _00.,1,Dial(${OUTBOUNDTRUNK}/${EXTEN}) exten => _00.,n,Congestion() _00.,n,Congestion() exten => _00.,n,Hangup() _00.,n,Hangup() Includes Es posible concatenar los contexto mediante el comando include, de echo lo mas común es diseñar distintos contextos para diferentes funciones de la central y luego enlazarlos para formar unos pocos para asignar a los diferentes tipos de extensiones según los privilegios o características que les queremos asignar a cada uno. Sintaxis: [contextoA] include => contextB Funciones: Las funciones nos premitiran aumentar el potencial de nuestro dial plan, exiten varias funciones disponibles y trataremos de explicar las mas utilizadas. Sintaxis: FUNCTION_NAME(argument) Al igual que muchas funciones podemos podemos referenciar a la funcion tal como esta escrito en la sintaxis, sin embargo tambien podemos hacer referencia del valor de dicha funcion de la siguiente manera: ${FUNCTION_NAME(argument)} Funciones:
Una función puede encapsular otra función: ${FUNCTION_NAME(${FUNCTION_NAME(argument)})} Ejemplo: exten => 123,1,Set(TEST=exam 123,1,Set(TEST=example) ple)
exten => 123,n,SayNumber(${LEN(${TEST})}) La función Set(), asigna un valor a una variable. La función SayNumber(), reproduce el valor de un numero La función LEN(), devuelve el valor de la longitud de una cadena de letras. Funciones:
Otra función muy utilizada es la función TIMEOUT(), la cual puede recibir tres tipos de argumentos, solo uno a la vez:
Absolute; asigna el tiempo absoluto máximo de duración de la llamada Digit; asigna el máximo de tiempo entre dígitos que puede tomarse un usuario. Response; es el tiempo máximo de espera cuando el usuario no ingresa ningún digito.
DIAL PLAN CONDICIONALES
La aplicación Gotoif() La clave para lograr una ramificación condicional entre los contextos de nuestro dial plan es la función gotoif(). Gotoif() evalúa los argumentos ingresados y reenvía al llamante a un destino especifico dependiendo si la evaluación resulto verdadera o falsa. Sintaxis GotoIf(expression?destination GotoIf(expression?destination1:destination2) 1:destination2) Si la expresión resulta verdadera, entonces la llamada saltara hacia el destino 1 si resulta falsa ira hacia el destino 2. El valor verdadero es representado por el numero 1 y el falso por el numero 0 Los destinos posibles pueden ser los siguientes: 1.- Una prioridad etiquetada dentro de la misma extensión. 2.- Un prioridad etiquetada de otra extensión dentro del mismo contexto. 3.- Una prioridad etiquetada de otra extensión en otro contexto. Cualquiera de los dos destinos puede ser omitido pero nunca se puede omitir los dos destinos
al mismo tiempo. En caso de que la condicional resulte hacia uno de los destinos omitidos simplemente simplemente se proseguirá hacia la siguiente línea o prioridad. Ejemplo: exten => 345,1,Set(TEST=1) 345,1,Set(TEST=1) exten => 345,n,GotoIf($[${TEST} 345,n,GotoIf($[${TEST} = 1]?uno:dos) exten => 345,n(uno),Saydigits(12 345,n(uno),Saydigits(12)) exten => 345,n,Hangup() 345,n,Hangup() exten => 345,n(dos),Saydigits(34 345,n(dos),Saydigits(34)) exten => 345,n,Hangup() 345,n,Hangup()
DIAL PLAN VOICEMAIL
Una de las características mas populares de los teléfonos modernos es el sistema de buzón de voz, y naturalmente asterisk tenia que contar con un sistema de voz muy flexible, algunas de las principales características del buzón de voz que nos ofrece asterisk son las siguientes: Contiene distintos fólderes para organizar los mensajes en el buzón. Saludos distintos para los estados Ocupado Saludos por defecto, y personalizados personalizados Posibilidad de asociar varios teléfonos con un buzón y varios buzones con un teléfono Indicador de mensaje de espera, visual con luz intermitente, y audible con tren de tonos Directorio de la compañía, basado en el buzón de voz. El archivo de configuración configuración se llama “voicemail.conf” “voicemail.conf” Creando un Buzón: Dentro de cada contexto del correo de voz, definiremos distintos buzones de voz, la sintaxis para definir un buzón de voz es la siguiente: mailbox => password,name[,email[,pager_email[,options]]] Pero que función cumple cada uno de estos parámetros?
Mailbox: es el numero del buzón de voz, usualmente lleva el mismo numero que la extensión a la que esta asociado. Password: es la contraseña numérica que el propietario del buzón de voz utilizara para ingresar a su buzón. Si el propietario cambia su contraseña el sistema la actualizara en este archivo (voicemail.conf)
Name: Es el nombre del propietario del buzón de voz, el directorio de la compañía utiliza este campo para realizar la búsqueda del usuario. Email: Aquí va la dirección de correo electrónico del propietario del buzón de voz, Asterisk Aster isk puede enviar mensaje al correo, incluyendo el mismo audio del mensaje. Pager email: dirección de correo del localizador o celular del propietario donde se enviara un mensaje corto. Options: en esta campo pueden ir una lista de opciones que permitirán afinar la configuración del buzón de voz del propietario del buzón y prevalecen sobre la configuración global. Hay nueve opciones validas: adjuntar, servermail, tz, saycid, review, operator, callback, dialout, y exitcontext. Estas opciones deber ingresarse ingresarse respetando el formato “opción=valor” y separadas por el signo pipe “|”, la opción tz permite definir la zona horaria, a las zonas previamente definidas en la sección [zonemessages] en el mismo archivo (voicemail.conf), Una definición típica para un buzón de voz es la siguiente: 101 => 1234,Joe Public,jpublic@somedomai Public,[email protected],jpublic@ n.com,jpublic@pagergatew pagergateway.net,tz=central|a ay.net,tz=central|attach=yes ttach=yes El buzón de voz utiliza la aplicación voicemail(), voicemail(), esta aplicación envía al llamante a una especifico buzón de voz para que pueda dejar el mensaje, el buzón de voz debe ser especificado como “mailbox@context” donde “context” es el nombre del contexto del correo de voz, opcionalmente se puede agregar las letra “b” y “u”, para diferencias los tipos de saludo (ocupado y no disponible). Vamos a poner algunos ejemplos de cómo configurar el buzón de voz en nuestro dial plan exten => 201,1,Dial(${JOHN}) ; esta extensión permite llamar a la extensión de Jhon.
exten => 201,1,Dial(${JOHN 201,1,Dial(${JOHN},10) },10) exten => 201,n,VoiceMail(101@ 201,n,VoiceMail(101@default,u) default,u) ; con esta otra podemos podemos hacer que la l a extensión de jhon timbre durante 10 segundos y si no contesta derivar la llamada al buzón de jhon, y la u indica que Jhon no esta disponible.
Ahora vamos a combinarlo con la aplicación gotoif()
exten => 201,1,Dial(${JOHN 201,1,Dial(${JOHN},10) },10) exten => 201,n,GotoIf($["${DIA 201,n,GotoIf($["${DIALSTATUS}" LSTATUS}" = "BUSY"]?busy:unavail) "BUSY"]?busy:unavail) exten => 201,n(unavail),Voicem 201,n(unavail),Voicemail(101@d ail(101@default,u) efault,u) exten => 201,n,Hangup() 201,n,Hangup() exten => 201,n(busy),VoiceMail(1 201,n(busy),VoiceMail(101@default, 01@default,b) b) exten => 201,n,Hangup() 201,n,Hangup() Ingresando al buzón de voz:
Para acceder al buzón de voz utilizaremos la aplicación, aplicación, VoiceMailMain() exten => 700,1,VoiceMailMain() 700,1,VoiceMailMain() ; esto nos preemitirá ingresar al buzón de voz por medio de la extensión 700. Otra manera también interesante de ingresar al buzón de voz es la siguiente: exten => _*982XX,1,VoiceMailMain(${EXTEN:3}@default) exten => _*982XX,1,Hangup _*982XX,1,Hangup Aplicación Directorio: directory() Esta aplicación puede aceptar hasta 3 argumentos, el primero el es contexto dentro del archivo voicemail.conf, voicemail.conf, donde buscara a los usuarios, el segundo es el contexto en extensions.conf, extensions.conf, desde donde intentara llamar a los usuarios, y el tercero (es opcional), puede ser la letra f, por defecto el directorio realiza la búsqueda por el apellido, pero con la letra f se puede configurar el directorio para que realice la búsqueda por nombre. Por ejemplo: exten => 8,1,Directory(default,from8,1,Directory(default,from-internal,f) internal,f) exten => 9,1,Directory(default,from9,1,Directory(default,from-internal) internal)
DIAL PLAN MACROS
Las macros resultan de mucha ayuda a la hora de elaborar el dial plan, ya que nos permiten simplificar aun mas la elaboración de nuestro dial plan, es como crear nuestras propias funciones personalizadas personalizadas para el dial plan, a continuación vamos a utilizar como ejemplo la creación de una macros para el buzón de voz. Observemos el siguiente dial plan: exten => 201,1,Dial(${JOHN 201,1,Dial(${JOHN},10) },10) exten => 201,n,GotoIf($["${DIA 201,n,GotoIf($["${DIALSTATUS}" LSTATUS}" = "BUSY"]?busy:unavail) "BUSY"]?busy:unavail) exten => 201,n(unavail),Voicem 201,n(unavail),Voicemail(101@d ail(101@default,u) efault,u) exten => 201,n,Hangup() 201,n,Hangup()
exten => 201,n(busy),VoiceMail(1 201,n(busy),VoiceMail(101@default, 01@default,b) b) exten => 201,n,Hangup() 201,n,Hangup() En el hemos automatizado la forma como las llamadas ingresaran directamente al buzón de voz dependiendo del estado de la extensión utilizando la variable ${STATUS}, sin embargo así como esta tendríamos que agregar estas líneas por cada extensión en la central ya que esta extensión estará siempre ligada hacia el usuario Jhon o sea la l a extensión 201. Utilizaremos las macros para mostrar cual es la mejor manera de configurar una buzón de voz para varias extensiones. Definiendo la macros La macros se definen de una manera muy similar a los contextos, debemos definir una macros entre corchetes y anteponiendo la palabra “macro“macro -” antes del nombre de la macro que vamos a crear. Ejemplos: [macro-prueba] [macro-voicemail] De esta manera el sistema podrá diferenciar una macro de un contexto normal Definiendo la macros Veamos un ejemplo con el buzón de Jhon pero ahora dentro de una macros [macro-voicemail] exten => s,1,Dial(${JOHN},1 s,1,Dial(${JOHN},10) 0) exten => s,n,GotoIf($["${DIALSTA s,n,GotoIf($["${DIALSTATUS}" TUS}" = "BUSY"]?busy:unavail) "BUSY"]?busy:unavail) exten => s,n(unavail),Voicemail( s,n(unavail),Voicemail(101@default,u) 101@default,u) exten => s,n,Hangup() s,n,Hangup() exten => s,n(busy),VoiceMail(101@d s,n(busy),VoiceMail(101@default,b) efault,b) exten => s,n,Hangup() s,n,Hangup() Uno punto importante es mencionar que las macros solo soportan la extensión “S” Todo va bien solo que aun seguimos amarrados al buzón de Jhon. Definiendo la macros
Sin embargo las macros tienen propiedades importantes a comparación
de un contexto común corriente. Y es que permiten trabajar con algunas variables adicionales e incluso soportan el envió de argumentos Incorporando una macros al Dial Plan: exten => 201,1,Macro(voicem 201,1,Macro(voicemail) ail) Las aplicación macro define variables especiales, para su utilización: ${MACRO_CONTEXT}, contiene el contexto original desde donde fue ejecutada la macro ${MACRO_EXTEN}, ${MACRO_EXTEN}, contiene el valor de la extensión original donde fue ejecutada la macro ${MACRO_PRIORITY}, ${MACRO_PRIORITY}, contiene la prioridad original desde donde fue ejecutada la macro $ARGn-, contiene el “n” mismo argumento ingresado a través de la macro, por ejemplo, el primer argumento será ${ARG1}, el segundo argumento será {ARG2} y así sucesivamente. En el siguiente ejemplo trataremos trataremos de explicar como se pueden utilizar esta variables especiales: [macro-voicemail] exten => s,1,Dial(${JOHN},1 s,1,Dial(${JOHN},10) 0) exten => s,n,GotoIf($["${DIALSTA s,n,GotoIf($["${DIALSTATUS}" TUS}" = "BUSY"]?busy:unavail) "BUSY"]?busy:unavail) exten => s,n(unavail),Voicemail( s,n(unavail),Voicemail(${MACRO_E ${MACRO_EXTEN}@def XTEN}@default,u) ault,u) exten => s,n,Hangup() s,n,Hangup() exten => s,n(busy),VoiceMail(${MAC s,n(busy),VoiceMail(${MACRO_EXTEN}@ RO_EXTEN}@default,b) default,b) exten => s,n,Hangup() s,n,Hangup() Usando argumentos en las macros Ahora vamos a prepara una macros genérica gracias a los argumentos, observemos el siguiente ejemplo donde por fin separamos la macros del numero de la extensión, para poder utilizarla desde cualquier extensión. [macro-voicemail] exten => s,1,Dial(${ARG1},10 s,1,Dial(${ARG1},10)) exten => s,n,GotoIf($["${DIALSTA s,n,GotoIf($["${DIALSTATUS}" TUS}" = "BUSY"]?busy:unavail) "BUSY"]?busy:unavail) exten => s,n(unavail),Voicemail( s,n(unavail),Voicemail(${MACRO_E ${MACRO_EXTEN}@de XTEN}@default,u) fault,u) exten => s,n,Hangup() s,n,Hangup() exten => s,n(busy),VoiceMail(${MAC s,n(busy),VoiceMail(${MACRO_EXTEN}@ RO_EXTEN}@default,b) default,b) exten => s,n,Hangup() s,n,Hangup() De esta manera podemos llamar a la macros desde el dial plan
[macro-voicemail] exten => s,1,Dial(${ARG1},10 s,1,Dial(${ARG1},10)) exten => s,n,GotoIf($["${DIALSTA s,n,GotoIf($["${DIALSTATUS}" TUS}" = "BUSY"]?busy:unavail) "BUSY"]?busy:unavail) exten => s,n(unavail),Voicemail( s,n(unavail),Voicemail(${MACRO_E ${MACRO_EXTEN}@de XTEN}@default,u) fault,u) exten => s,n,Hangup() s,n,Hangup() exten => s,n(busy),VoiceMail(${MAC s,n(busy),VoiceMail(${MACRO_EXTEN}@ RO_EXTEN}@default,b) default,b) exten => s,n,Hangup() s,n,Hangup() [from-internal] exten => 101,1, Macro(voicemail,${JOHN}) exten => 102,1,Macro(voicemail,${JANE}) exten => 103,1,Macro(voicemail,${JACK}) Incluso podemos simplificar una vez mas utilizando la variable ${EXTEN} [macro-voicemail] exten => s,1,Dial(SIP/${ARG1} s,1,Dial(SIP/${ARG1},10) ,10) exten => s,n,GotoIf($["${DIALSTA s,n,GotoIf($["${DIALSTATUS}" TUS}" = "BUSY"]?busy:unavail) "BUSY"]?busy:unavail) exten => s,n(unavail),Voicemail( s,n(unavail),Voicemail(${MACRO_E ${MACRO_EXTEN}@de XTEN}@default,u) fault,u) exten => s,n,Hangup() s,n,Hangup() exten => s,n(busy),VoiceMail(${MAC s,n(busy),VoiceMail(${MACRO_EXTEN}@ RO_EXTEN}@default,b) default,b) exten => s,n,Hangup() s,n,Hangup() [from-internal] exten => 1XX,1,Macro(voicemail,${EXTEN}) Solo debemos tomar en cuenta que en esta ocasión estamos amarrados al protocolo SIP, en el ej. Anterior no importaba el tipo de canal utilizado ya que este se declaraba como variables globales. Un ejemplo mas avanzado he interesante de analizar es el siguiente: [macro-voicemail] exten => s,1,Dial(${ARG1},20 s,1,Dial(${ARG1},20)) exten => s,n,Goto(s-${DIALSTATUS},1 s,n,Goto(s-${DIALSTATUS},1)) exten => s-NOANSWER,1,Voicemail(${MACRO_EXTEN},u) exten => s-NOANSWER,n,Goto(inc s-NOANSWER,n,Goto(incoming,s,1) oming,s,1) exten => s-BUSY,1,Voicemail(${MACRO_EXTEN},b) exten => s-BUSY,n,Goto(incoming,s, s-BUSY,n,Goto(incoming,s,1) 1) exten => _s-.,1,Goto(s-NOAN _s-.,1,Goto(s-NOANSWER,1) SWER,1) En esta ocasión estamos incluyendo el comando Goto y esto nos puede servir para reenviar la llamada hacia un menú por ejemplo donde el usuario llamante tenga mas de una opción. ASTERISK: FEATURES
Podemos configurar algunas características adicionales adicionales en el archivo features.conf. features.conf. Las características principales son las siguientes: Transferencia desatendida (blind transfer) Parqueo de llamadas (parking lot) Grupo para jalar llamadas (pickup group) Sala de conferencias (meetme) Para ello será necesario que editemos el archivo features.conf ubicado en la carpeta de asterisk. TRANSFERENCIAS DESATENDIDA
Normalmente Normalmente por defecto la transferencia desatendida se realiza presionado el boton # Este tipo de transferencia consiste en derivar la llamada hacia otro anexo sin habernos cerciorado antes si la persona en la extensión destino se encuentra disponible para recibir la llamada. Vamos a editar el archivo de la ruta /etc/asterisk/features.conf /etc/asterisk/features.conf Donde buscaremos el parámetro blind b lind transfer y cambiaremos el varo “#” por “##”, con esto conseguiremos conseguiremos evitar problemas con las llamadas hacia números que comiencen con la tecla “#” como los móviles RPM por ejemplo. El siguiente grafico ilustrara mejor el proceso de comunicación comunicación
Realizar una transferencia atendida, consiste en llamar al destino para confirmar la transferencia, antes de realizarla. Este tipo de transferencia suele ser necesario para trabajadores que no acostumbran contestar ni llamar directamente directamente de su extensión, tales como funcionarios, gerentes, ejecutivos, etc. El siguiente grafico nos ilustrara el proceso de comunicación. comunicación.
Se puede habilitar una combinación para la transferencia atendida, por ejemplo *2 para simular la tecla flash
PARQUEO DE LLAMADAS
En algunas ocasiones durante una conversación conversación telefónica es necesario movilizarnos ( para ir a conseguir un archivo, documento, o realizar alguna consulta), pero lamentablemente no es posible ni practico que todos los usuario cuenten con un anexo inalámbrico, en estos casos es ideal contar con la función de parqueo de llamadas. Esta función consiste en aparcar una llamada en una extensión virtual dentro de nuestra central telefónica, de esta manera podremos recuperar recuperar esa llamada simplemente simplemente llamando a la extensión virtual creada en el momento que aparcamos aparcamos la llamada
Esta función se habilita en la sección [general] Y cuenta con los siguientes parámetros: Parkext => 700 donde 700 es el numero de la extensión de entrada al estacionamiento Parkpos => 701-720, aquí definimos el rango de posiciones apra nuestro estacionamiento Context => parkedcalls, aquí definimos el nombre del contexto en para nuestro
estacionamiento, estacionamiento, no olvidar que este contexto debe estar incluido (include) en el contexto de las extensiones que queramos queramos que puedan recuperar llamadas desde el estacionamiento. estacionamiento. Parkingtime => 180, este será el tiempo máximo en segundos que una llamada se mantendrá en el estacionamiento. estacionamiento. PICKUP GROUP
Un Pick up group es un grupo conformado por extensiones con con autorización para “jalarse” las llamadas, es decir; estas extensiones podrán contestar llamadas ll amadas dirigidas hacia cualquier anexo de su grupo, pero marcando previamente un código. Por ejemplo si tenemos dos extensiones en un mismo grupo, y llaman a una de ellas pero justo no se encuentra la persona en su extensión, entonces otra persona podrá contestar la llamadas desde su extensión (siempre que este dentro del mismo pickup group) con solo presionar: *8
Esta opción también se encuentra en la sección general y podemos definir o modificar el código por defecto *8 en el parámetro: Pickupexten = *8 Pero será necesario también que asignemos los grupos a cada extensión en el archivo sip.conf. El grupo puede asignarse mediante los parámetros: Callgroup=1, donde 1 es el número del grupo de llamada Pickupgroup=1, donde 1 es el número del grupo para pickup Publicado por William Valverde en 21:09 Etiquetas: Basic DP simple, simple, Condicionales Condicionales,, Dial Plan, Plan, DP Interactivo, Interactivo, Funciones Funciones,, Macros Macros,, Variables,, Voicemail Variables
