Aplicaciones Básicas

De Asterisk Wiki
Ir a la navegación Ir a la búsqueda
Format.png Formatear
Esta página necesita ser editada para cumplir los requisitos del wiki.
Puedes revisar todas las páginas sin suficiente formato en este enlace.
Alert.png To Do
Esta página necesita ser completada.
Puedes revisar todas las páginas por completar en este enlace.


El mundo de las Aplicaciones en Asterisk es tan extenso que merece ser tratado independientemente. Concretamente existen una serie de aplicaciones que son utilizadas recurrentemente, y es importante que sean vistas y tratadas de manera especifica, como parte del formato de construcción de nuestros Planes de Marcación.

Logo Asterisk

Aplicación Answer

Traducción directa de "Responder". La función de esta aplicación básicamente es la de descolgar la llamada entrante. Puede resultar trivial, pero hay que entender que en función de las aplicaciones que vengan a continuación es posible que sea necesario que nuestra máquina Asterisk ya tenga el control sobre el canal entrante (mediante el uso de esta aplicación), o no lo requiera de momento.

A nivel de mensaje SIP ejecutar esta aplicación es lo mismo que enviar un mensaje al par que llama de OK. Hay que considerar que en el momento que lanzamos esta aplicación al descolgar la llamada, ya comenzaría el ciclo de facturación del llamante por lo que eventualmente, a no ser que sea estrictamente necesario, no es una buena idea incluirla en nuestro dialplan por sistema o costumbre. Tenemos que saber si las aplicaciones sucesivas, realmente requieren que el canal este "contestado" para que funcionen correctamente.

Puede recibir un solo parámetro Answer(<retraso>), numérico en milisegundos, tiempo que esperara antes de recepcionar la llamada. Es equivalente a poner la aplicación Wait previa a esta, por lo que no es muy común, dado que "complica" un poco el código.

Aplicación Progress

Contrariamente a la aplicación Answer, es posible enviar un mensaje llamado 183 Session Progress. Es considerado una forma de enviar "Audio por adelantado" y solo funciona evidentemente en entornos donde este mensaje sea permitido como SIP e IAX. Con este mensaje lanzado, podríamos a continuación ejecutar alguna aplicación o recurso que necesite este mensaje "Early Audio" como laMúsica en Espera

Aplicación Playback

La sintaxis especifica es: PlayBack(archivo1[&archivoN],opciones)

Sirve para reproducir una pista de audio contenida en un fichero dentro de nuestra máquina. El método de seleccion de esta pista, si solo especificamos el nombre, lo consultará en el directorio asociado al lenguaje que estemos utilizando para el canal especifico. Si en nuestro fichero de configuración SIP, definimos por defecto el lenguaje Español (es), y es un dispositivo SIP el que accede a la extensión que ejecuta esta aplicación de reproducción entonces consultaría en el directorio especifico de pistas en español (var/lib/asterisk/sounds/es/), y si no lo encuentra, consultaría en el directorio general (var/lib/asterisk/sounds/).

Durante la reproducción, la aplicación tiene el control del canal, esto quiere decir, que no se permiten lanzar otras Aplicaciones simultáneamente.

Esta aplicación ademas de recibir el archivo a reproducir, también puede recibir opciones. Las más comunes:

  • skip: solo se reproducirá la pista, única y exclusivamente, si antes se ha ejecutado la aplicación Answer, sino, saltaría sin reproducir nada.
  • noanswer: en este caso, si el tipo de canal soporta "Early Audio", lanza la pista, sin descolgar la llamada.

Sin opciones por defecto, descuelga la llamada, reproduce el mensaje

Aplicación Hangup

Simplemente, cuelga la llamada. No es necesario pasarle ningún parámetro especifico.

Al contrario de la aplicación Answer, esta aplicación si resulta interesante posicionarla al final de un proceso de una extensión, dado que si por ejemplo, el destinatario de la llamada, después de establecer contacto, cuelga la llamada, a nosotros no se nos colgaría, a no ser que lo hagamos expresamente en nuestro dispositivo. En cambio si esta aplicación esta disponible, al colgar la llamada, se lanzaría la aplicación y nos llevaría a la extension "h" según podemos ver en Introducción Dialplan, y a continuación si se nos colgaría la llamada automáticamente.

Aplicaciones para Depuración de Errores

Aplicación NoOp

Significa literalmente No Operation, es decir, Sin Operación, así que esta aplicación no hace nada. ¿Utilidad? Se puede insertar cualquier mensaje a voluntad, inclusive variables y se visualizarían directamente durante el registro de detalle en nuestra interfaz CLI. Es muy práctica para saber por ejemplo el estado de una variable en un momento determinado si estamos teniendo algún tipo de problema que no somos capaces de resolver, por tanto es una gran aplicación para Depuración en tiempo real.

Considerar también que es una muy buena práctica poner esta aplicación, en la prioridad numero 1. Ya que al no hacer nada especial, directamente podemos empezar a poner aplicaciones a voluntad en las siguientes prioridades utilizando el sistema de conteo automático (n, n+1) y podemos luego alterar el orden o incluir nuevas aplicaciones a voluntad en el futuro sin que afecte al orden de prioridades.

Ejemplo. Si tenemos la siguiente secuencia:

exten => 111,1,Answer()
same => n,Dial(...)
same => n,Hangup()

Si queremos introducir una aplicación al principio, tendríamos que modificar bastante código:

exten => 111,1,Wait(3)
same => n,Answer()
same => n,Dial(...)
same => n,Hangup()

En cambio si hubieramos tenido una operación NoOp() al principio, hubiera sido muy fácil insertarlo

exten => 111,1,NoOp()
same => n,Answer()
same => n,Dial(...)
same => n,Hangup()

Solamente agregando una linea a la secuencia. Puede resultar insignificante, pero es un sistema para mantener un código con mayor flexibilidad y calidad.

exten => 111,1,NoOp()
same => n,Wait(3)
same => n,Answer()
same => n,Dial(...)
same => n,Hangup()

Aplicación Verbose

Es exactamente igual que la aplicación NoOp con la diferencia que NoOp siempre imprime en el nivel de detalle (verbose) número 3 o superior, y esta aplicación puede especificar el nivel concreto.

Recordar que los niveles de Detalle (verbose) se pueden especificar tanto al cargar la interfaz CLI con el parámetro -v (-vvv 3 niveles por ejemplo), tanto por defecto en el archivo asterisk.conf

Aplicación DumpChan

Muestra información sobre el canal en curso. Puede recibir un parámetro DumpChan(<nivel>) siendo al igual que la aplicación Verbose, el nivel desde el cual podríamos ver esta información.

Aplicaciones para el Control de Flujo

Estas son las aplicaciones clásicas para obtener los comportamientos esenciales de todo lenguaje de programación. Principalmente hablamos de los eventos condicionales y los bucles. Para ello se aplica un sistema muy parecido al de Ensamblador, con bucles basados en GOTO y condicionales basados en GOTOIF.

Aplicación GoTo

Su funcionamiento estándar es el de enviar un canal en un momento determinado (prioridad) de la extensión en la que se encuentra a otro lugar diferente dentro del plan de marcación.

La sintaxis para esta "redirección" es la siguiente: Goto(<contexto>,<extensión>,<prioridad>/<etiqueta>)

  • Si solo se definen dos valores, estos hacen referencia a <extensión>,<prioridad>/<etiqueta>
  • Si solo se define un valor, entonces hace referencia a una <prioridad> o <etiqueta> de esa extensión

Supongamos que tenemos dos contextos [dia] y [noche], ambos con la extensión 111 por igual. Si queremos ir supongamos a la etiqueta "publico" de la extensión 111 despues cualquier parte de la etensión 111 del contexto día podriamos hacerlo de la siguiente forma:

Archivo: /etc/asterisk/extensions.conf
[dia]
exten => 111,1,...
same => n,...
same => n,Goto(noche,111,publico) --->

[noche]=> 111,1,...
same => n,...
same => n(publico),... <---


Aplicación GoToIf

Muy parecida a la aplicación esta constituye el formato condicional para que se produzca la redirección. Consideremos que GoTo se ejecuta siempre, pero en este caso, si utilizamos una expresión regular como podemos ver en Introducción Dialplan, que devuelva un valor Booleano (0 o 1), entonces redirigiremos el canal hacía un punto del dialplan, u otro (o simplemente dejaremos que la llamada continue su curso).

En este caso la sintaxis es la siguiente: Gotoif(<expresion_regular_condicional>?<redirección_si_verdadero:<redireccion_si_falso>).

  • Si no especificamos la redirección en el caso que no se cumpla la condición (si falso), entonces la extensión continua en la siguiente prioridad por su cauce.
  • Las opciones <redireccion_si_verdadero/falso> siguen la misma estructura de redirección que la utilizada en el apartado GoTo.

Con esto, y como ejemplo vamos a diseñar un pequeño bucle muy sencillo de tipo FOR (bucle con contador, que va pasando secuencialmente por todos los valores del mismo):

Archivo: /etc/asterisk/extensions.conf
[bucle]
exten => 111,1,Set(i=1)
same => n(for),GoToIf($[${i}>10?fin_for)
same => n,NoOp(El valor de i es: ${i})
same => n,Set(i=$[${i}+1])
same => n,GoTo(for)
same => n(fin_for),...


Con esta estructura tenemos potencial para hacer todo tipo de algoritmos, considerando que el "valor" de entrada que manipulamos es la llamada. Esto es muy práctico sobre todo cuando realizamos las funciones que por doquier suelen ser más complejas en los sistemas de marcación, los IVR (Interactive Voice Response), sistemas de respuesta de voz interactiva, en las que el llamante, va interactuando con la máquina para obtener determinadas funcionalidades (por ejemplo saber el saldo de su cuenta de crédito, realizar autentificación en sistemas seguros, comprar un producto sin ser atendido, etc). Esto se ve más a fondo en el apartado Dialplan Avanzado.

Aplicación Background

Esta aplicación sirve para lanzar una pista de audio, mientras se espera para la captura de tonos de marcación. Es fundamental utilizarla con la aplicación WaitExten que esta a continuación, dado que es importante establecer una restricción de tiempo, ya que al llegar esta, los digitos marcados serán los que se utilicen para realizar una combinación que casara con una extensión de nuestro DialPlan.

A priori, esta combinación se asociara con una extensión dentro del mismo contexto en el que la aplicación Background fue ejecutado.

Veamos su sintaxis: Background(<archivo_de_sonido>[&archivo_de_sonidoN],<opciones_varias>,<seleccion_de_idioma>,<otro_contexto>).

  • Solo es necesario 1 archivo de sonido, el resto son opcionales
  • Podemos especificar varios archivos de sonido para que vayan sonando secuencialmente, práctico si queremos componer un "Menú" de audio combinando varias pistas
  • Como opciones tenemos:
    • s: Si el canal todavia no respondido con la aplicación Answer (u otra que forzara la respuesta), entonces este Background no se aplicaría
    • n: Trata de no responder al canal utilizando el sistema "Early Audio" hasta que no se detecta la primera marcación
    • m: Tan pronto detecta una asociación con una extensión para el mensaje de audio. Esto es MUY práctico cuando queremos hacer un menú que consta de pulsaciones de un solo dígito, ya que no obligamos a que transcurra el tiempo completo impuesto por la Aplicación WaitExten
  • Si seleccionamos un idioma concreto, la aplicación buscara en el directorio correspondiente a dicho idioma antes de elegir un archivo de audio predefinido que coincida con el nombre del mismo.
  • Si queremos que busque la extensión marcada en otro contexto diferente al que se encuentra la aplicación Background la definimos como último parámetro.

Supongamos que tenemos un menú de Voz que indica: "Pulse 1 para hablar con Ventas, Pulse el 2 para hablar con Posventa". Podemos tener este menu en un contexto concreto (por motivos de seguridad del Dialplan por ejemplo). Podríamos crear la siguiente pequeña operadora automática:

Archivo: /etc/asterisk/extensions.conf
[operadora]

exten => s,1,Background(menu_bienvenida&ventas&posventa,m,es,menu_operadora)
same => n,WaitExten(10)

exten => t,1,Goto(s,1)

[menu_operadora]

exten => 1,1(ventas),Goto(...)
exten => 2,1(posventa),Goto(...)


Subtitulo 2.1

Info del Subtitulo 2.1

Subitutlo 2.1.1

Info del Subtitulo 2.1.1 [1]

Referencias

  1. 10000 Horas, Manuel Camargo (2010)

Véase también

Enlaces Externos