Introducción Dialplan

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.

To Do Esta página necesita ser completada. Puedes revisar todas las páginas por completar en este enlace.

El Plan de Marcación, llamando Dialplan en Asterisk, podría considerarse la columna vertebral del sistema. Como caracteristica principal, podriamos decir que es algo parecido a un lenguaje de script, en el que funciones, aplicacicones y recursos se van intercalando para formar algo parecido a "procedimientos" y "programas" dentro de lo que pudiera considerarse.

Este paradigma de programación orientado a los canales de telefonía es exclusivo en el mundo y aporta todo el potencial y flexibilidad, que las PBX tradicionales no pueden ofrecer, o lo hacen mediante mecanismos de licenciamiento y estructuras en ocasiones demasiado complejas.

Logo Asterisk

Algo tan sencillo como crear un calendario de disponibilidad, suele ser una función que las centrales más nuevas y sofisticadas del mercado solo consiguen aplicando estrategias que en la mayor parte de los casos quedan limitadas a una serie de plantillas que no cubren la totalidad de la posible intención que requiera el cliente. Por ejemplo cuando hablamos de horarios por departamentos, se considera un proceso clásico en Asterisk, que en cambio, en algunas PBX, puede convertirse en un mundo.

Conceptos Esenciales

Para empezar a desarrollar un posible Dialplan, vamos a ver algunos conceptos básicos en los que se fundamenta todo el potencial.

El Dialplan se fundamenta principalmente en un fichero, aunque se pueden incluir ficheros auxiliares adicionales, llamado extensions.conf, dentro del directorio de configuraciones generales /etc/asterisk.

Concepto de Marcación

Cuando hablamos de Plan de Marcación, hacemos referencia literalmente a esto: La Marcación en un teléfono, o dispositivo de cualquier tipo (no tiene que ser necesariamente los clásicos 10 números, sino también empezamos a incluir el concepto de carácter alfanumérico). Una vez realizado el marcado, este, entraría como una "entrada" dentro de nuestro plan de marcación por el contexto que corresponda, en función de como hayamos definido nuestro el canal al que hace referencia nuestro dispositivo SIP, IAX, etc. Dentro de este contexto, la entrada (la marcación que hicimos), empieza a recorrer el script secuencialmente y a partir de ahí pueden surgir una serie de eventos asociados a esa entrada que en cualquier caso siempre suelen tener algo que ver con el mundo de la comunicación, aunque no necesariamente, ya que por ejemplo, podría darse un caso curioso de una aplicación concreta, como es la de al Marcar los números 1-1-1 en nuestro teléfono, y que se encendiera la luz de nuestro despacho.

A cada posibilidad concreta, de un conjunto de marcaciones o marcación individidual se le denomina extensión. Ejemplo, la marcación 1-1-1 sería la extensión 111.

Contextos

Los contextos son la forma de categorizar o englobar , una serie de procedimientos en función de la marcación a la que hacemos referencia desde el dispositivo que la hacemos. La sintaxis típica seria un nombre de contexto englobado entre corchetes, algo asi: [contexto].

Por ejemplo si nuestro dispositivo, que opera a traves del protocolo SIP, le indicamos que al realizar su Marcación, la envíe al contexto [general] dentro de nuestro Dialplan, definiremos que hace una posible marcación realizada en forma de extensión.

Hay que considerar que en caso que un dispositivo no tenga especificado un contexto en concreto, todas sus marcaciones se redirigiran directamente a un contexto genérico llamado [default]

Extensiones

Dentro de los contextos, se van definiendo las posibilidades concretas para un conjunto de marcaciones o como dijimos antes, extensiones.

Para definir una extensión se hace poniendo la palabra "exten =>" delante de la marcación a la que queremos hacer referencia (ejemplo exten => 111). Como comentabamos antes, hay que recordar que el concepto de marcación gracias a Asterisk no solo se limita a caracteres númericos, sino que se expande a los alfanumericos, por tanto la extensión, exten => doe también se podría considerar una extensión valida.

La sintaxis correcta sería: exten => <marcación_de_la_extensión>,<prioridad>,<aplicación>

Las Prioridades las veremos en adelante, las Aplicaciones se ven todo alrededor de este Wiki ya que realmente estas son el verdadero mundo de Asterisk.

Prioridades

Una Extensión, al ser de alguna forma como un lenguaje de script, puede tener varias funciones, o aplicaciones de forma secuencial. Al marcar la extensión 111, si la intención es que prepare la comida del horno, en primer lugar, podríamos requerir que programara la temperatura, en segundo lugar, que programara el tiempo de horneado, y en tercer lugar que lanzara la orden de calentado. Como queremos que este "algoritmo" siga un orden establecido, esto lo hacemos a través de las prioridades, que se conforman en orden secuencial numerico (el 1, el 2, el 3), aunque también podemos hacer una llamada recursiva a un contador interno para que vaya aumentando de forma "automática" (el 1, el 2, el n+1 (3), el n+1 (4) etc).

Siguiendo la sintaxis de las extensiones para ejecutar la orden de horneado seria algo así:

exten => 111,1,Programa_Temperatura()
exten => 111,2,Programa_Tiempo()
exten => 111,3,Encender_Horno()

Pero podemos mejorar esta estructura con si aplicamos el contador que hablábamos antes:

exten => 111,1,Programa_Temperatura()
exten => 111,n,Programa_Tiempo()
exten => 111,n,Encender_Horno()

Con la última versión de Asterisk, la 1.8, para no andar repitiendo constantemente lo de "exten => extension" se introduce una sintaxis nueva que simplifica mucho la vida, con same => (significa algo asi como, "lo mismo que antes").

exten => 111,1,Programa_Temperatura()
same => n,Programa_Tiempo()
same => n,Encender_Horno()

Esta última forma será la que seguiremos en todos los ejemplos al ser la más escueta y correcta a día de hoy.

Etiquetas

Dado que podemos empezar a utilizar los contadores en las prioridades, que ya no asignan un número especifico, puede ser difícil referenciarnos a una prioridad de una extensión en cuestión. Por esto surge el concepto de etiquetas, que junto a las prioridades, podemos darle un nombre a las mismas, y así poder hacer una referencia directa si nos surgiera la necesidad.

Por ejemplo, si tenemos una extensión con muchas prioridades:

exten => 111,1,...
exten => 111,n,...
...
exten => 111,n,...
exten => 111,n,...

Y por cualquier circunstancia quisiéramos ir justamente a la penúltima prioridad de la extensión, añadiendo la etiqueta (penúltima) a esa prioridad, ya tendríamos esa referencia penúltima para darle el uso a conveniencia en un futuro. Esto es especialmente útil para los saltos condicionales que veremos más adelante.

exten => 111,1,...
exten => 111,n,...
...
exten => 111,n(penultima),...
exten => 111,n,...

Gestión de Variables

Como en todo buen lenguaje de programación o en este caso, de script, es fundamental que exista un mecanismo para almacenar Variables. Las variables pueden almacenar múltiples tipos de información pero no tan extendido como en otros lenguajes. Principalmente se usan para simplificar el código o hacerlo más legible.

Existen cuatro tipos de variables:

• Variables de Canales
• Variables Globales
• Variables de Entorno
• Variables Compartidas

Variables de Canales

Como veremos en Aplicaciones Básicas existe una Aplicación llamada Set que sirve para crear una variable y asignarle un valor especifico durante la ejecución de un canal en concreto. Podrían asemejarse a las variables locales de una función si lo comparáramos a cualquier otro lenguaje de programación. Por ejemplo si queremos asignar a la variable CONTADOR el numero 5 seria: Set(CONTADOR=5). Si luego quisiéramos acceder a esta variable, la sintaxis seria: ${<nombre_variable} en este caso sería: ${CONTADOR}.

Además existen una serie de Variables especificas asociadas a los canales y predefinidas por el sistema, las más comunes son:

• ${DIALSTATUS}: Sirve para saber el estado de la llamada, posibles valores ANSWER (respondido), BUSY (ocupado), NOANSWER (sin respuesta), CANCEL (llamada cancelada), DONTCALL (llamadas bloqueadas, el destinatario esta en estado no disponible), etc.
• ${CONTEXT}: Devuelve el nombre del contexto.
• ${EXTEN}: Devuelve el número de la extensión completa dentro del contexto en cuestión.
• ${PRIORITY}: Devuelve el número de la prioridad dentro de la extensión en cuestión.
• ${CALLERID}: Muestra el identificador del llamante, puede ser un número o cadena de texto.
• ${CHANNEL}: Devuelve el nombre del canal en cuestión.

Variables Globales

Son aquellas variables accesibles e iguales desde cualquier contexto, canal o instancia durante la ejecución del plan de marcación.

Se definen debajo de un contexto especial llamado [globals] que suele posicionarse justo al principio del fichero extensions.conf.

El clásico uso de estas variables, es para conceptualizar los distintos pares con un nombre mas "accesible". Por ejemplo, en vez de usar SIP/ext11 para llamar a la extensión ext1 conectada por el protocolo SIP, podríamos definir dentro de "globals" una variable global así:

[globals]
EXT11 = SIP/ext11

Y desde ese momento llamar a la variable ${EXT11} cuando queramos hacer referencia a ese canal. De hecho podríamos agrupar varios canales, por ejemplo para un uso concreto como es el de llamada a múltiples extensiones simultáneamente, con una sola variable global:

[globals]
VENTAS = SIP/ext11&SIP/ext12&SIP/ext13&SIP/ext14

Luego utilizando la función Dial podríamos llamar a todas esas extensiones a la vez solo utilizando la variable ventas:

exten => 111,1,Dial(${VENTAS})

Variables de Entorno

Son un tipo de variables muy poco utilizadas por el sistema Asterisk ya que sirven para acceder a las variables de entorno de nuestro sistema *NIX. La sintaxis es muy sencilla: ${ENV(<nombre_variable>)}. Por ejemplo la variable de entorno HOME, que indica la ruta al directorio principal del usuario que ejecuta el sistema en ese momento podria obtenerse (si por ejemplo quisiéramos escribir un fichero de audio especifico dentro de ese directorio a través de una combinación de aplicaciones en una extensión).

Variables Compartidas

De reciente incorporación, podrían considerarse un subconjunto de variables locales o de canal, ya que de alguna forma, tienen la misma naturaleza, pero sirven para ser compartidas específicamente por dos o mas canales. Realmente se introdujo para poder ofrecer esta funcionalidad especifica, de poder extender el uso de una variable de canal, a otros por necesidades muy concretas.

La definición de esta variable al igual que las de canal es a través de la aplicación set: Set(SHARED(CONTADOR,SIP/ext11)). Así "escribimos" la variable CONTADOR en el canal SIP/ext11, y este en su ejecución podría acceder a la misma muy parecido al resto de las variables: ${SHARED(CONTADOR,SIP/ext11}

Véase también

• IAX
• SIP

Enlaces Externos

• 10000 Horas es un ejemplo de enlace externo