Posteado por Pablo Jorge Sanguinetti

Asterisk 101++ o Trabajando en un Dialplan e introducción a AGI Breve resumen del

charla anterior

Apartir de esto podemos decir que en corazón de asterisk (*) es el dialpan que se define en el archivo

extension.conf.

Como habíamos hablado cada dispositivo se le define un contexto que es donde comienza a

trabajar ese dispositivo.

Veamos un ejemplo de una entrada de telefonía (zap) y 2 teléfonos SIP

En zaptel.con tengo algo como:

[channels]transfer=yescancallforward=yessignalling=fxs_kscontext=from-pstnrxgain=2.0txgain=4.0callprogress=yesusecallerid=yescallerid=asreceived group=0channel=> 1

Esta es una famosa X100 placa que es un WinModem con un chipset Ambient de Intel. Lo mas

importante es que la definí en el contexto from-pstn.

Luego en el sip.conf tenemos lo siguiente:

[general]context=from-local bindport=5060bindaddr=0.0.0.0

[100]type=friendhost=dynamicusername=100 secret=XXXXXXX

[101]type=friendhost=dynamicusername=101 secret=XXXXXXX

Una muestra de lo que es un dialplan básico seria:

[from-local]exten => 100,1,Dial(SIP/100)exten => 101,1,Dial(SIP/101)exten => _9.,1,Dial(Zap/1/${EXTEN:1})

[from-pstn]exten => s,1,Answerexten => s,2,Playback(welcome)exten => s,3,Dial(SIP/101,15,t)exten => s,4,Dial(SIP/102,15,t)exten => s,5,Playback(nobody)exten => s,6,Voicemail(101)exten => s,7,Hangup

Hace falta explicar un par de cosas acerca de esto:

Primeramente el archivo extension.conf tiene como casi todos un [general] que es para definiciones

básicas las mas importantes son 2 definiciones: static y writeprotect ambas por defecto en NO. Sirve solo

si static es Yes y writeprotect es No. Pero esto es un detalle menor

Hay una parte de [global] donde se definen variables globales y lo que se puede decir que una

variable se define en este lugar así:

VARIABLE => Zap/1

Y se usa ${VARIABLE} o ${Variable} o ${variable}.

Pero ahora definamos extensiones, cada extensión es:

exten => extensión,prioridad,Comando(parámetros)

Primeramente veamos extensión, la cual puede ser literales, patrones o predefinidas, Las primeras son

aquellas en las cuales definimos el numero que se marca por ejemplo 101 o 100 en los cuales hacemos

cosas especificas para cada uno de estos números.

Los Patrones nos aquellos que match con el numero discado, comienzan con _ y pueden contener:

Un ejemplo seria que tenemos diferentes proveedores para diferentes provincias y un dial

plan puede ser: _0351. Córdoba _0352. Santa Fe etc.....

o si se disca: _4XXXXXX Un numero común loca acá en Córdoba

Hay que tratar de no usar cosas como _. porque esto machearia con cualquier cosa, es mejor _X.

También podemos usar cosas un poco mas complejos como discar algo solo si el caller id machea con

algún patrón: 123/4892233 Entra al contexto discando 123 desde el teléfono 4892233

Y podemos remplazar todo por los patrones antes definidos.

Las extensions predefinidas son las siguientes:

i extensión invalida. Un contexto tiene un limitado números que un usuario puede marcar y si

marco otro podemos tomar ese error y hacer algo, por ejemplo

[from-local]exten => 100,1,Dial(SIP/100)exten => 101,1,Dial(SIP/101)exten => _9.,1,Dial(Zap/1/${EXTEN:1})exten => i,1,Playback(discadoinvalido)exten => i,2,Hungup

h corte de la extensión Es cuando un cliente corta la comunicación y generalmente se usa para cobrar

X números del 0 al 9

Z números del 1 al 9

N números del 2 al 9

[24-7] números específicos en este caso 2,4,5,6,7

. uno o mas números ! cero o mas números

o loguear llamadas.

a asterisco Es para determinar que se presiono el asterisco

s para llamadas no conocidas Es generalmente cuando las llamadas entran y no conocemos que

puede llegan a discar.

t máximo tiempo de respuesta Esto es para dar un tiempo especifico a las respuestas de un cliente

sobretodo en los IVRs

[from-local]exten => 100,1,Dial(SIP/100)exten => 101,1,Dial(SIP/101)exten => _9.,1,Dial(Zap/1/${EXTEN:1})exten => t,1,Playback(muchotiempotecorto)exten => t,2,Hungupexten => i,1,Playback(discadoinvalido)exten => i,2,Hungup

T máximo tiempo de llamada Es para controlar cuanto tiempo la llamada del cliente esta activa, por

defecto el tiempo absoluto de llamada esta en 0 o sea que no se controla.

Hay otros como fax, que es obvio y solo se usa con drivers ZAP. Los demás son de poco uso o nos

vamos a poner a discutir un monton.

Hay un problema con el orden de los patrones en cada contexto. Veamos el siguiente ejemplo:

[demo]exten => _450.,1,Dial(SIP/100)exten => _X.,1,Dial(SIP/102)exten => h,1,Hungup

Cuando hagamos un show dialplan vemos como asterisk lo ordeno: 1 _X. 2 _450. 3h No importa

lo que hagamos en este contexto todo va salir por la opción _X. Para cambiar el orden debemos

usa un trampa para el parser.

[demo]include => demo- uno exten => _450.,1,Dial(SIP/100)exten => h,1,Hungup

[demo-uno]exten => _X.,1,Dial(SIP/102)

Si dentro de un contexto encontramos un include sera parceado al final del contexto y en el orden

de los include, para nuestro ejemplo queda: 1 _450 2h 3 _X. Que era lo que nosotros queríamos

Hasta acá todo acerca de extensiones, ahora hablaremos de prioridades. En nuestro ejemplo

primigenio teníamos un buen ejemplo de prioridades:

[from-pstn]exten => s,1,Answerexten => s,2,Playback(welcome)exten => s,3,Dial(SIP/101,15,t)exten => s,4,Dial(SIP/102,15,t)exten => s,5,Playback(nobody)exten => s,6,Voicemail(101)exten => s,7,Hangup

Las prioridades son el orden que debe tener para cada extensión. Cual es la otra función además de

darle un orden estos números de prioridad, para ser usados con funciones como GotoIf.

exten => s,6,GotoIf($[ ${x} < 3 ]?2:5)

A partir de la versión 1.2 podemos escribir

[from-pstn]exten => s,n,Answerexten => s,n,Playback(welcome)exten => s,n,Dial(SIP/101,15,t)exten => s,n,Dial(SIP/102,15,t)exten => s,n,Playback(nobody)exten => s,n,Voicemail(101)exten => s,n,Hangup

En la cual se entiende que el orden de esta extensión esta dado por el orden que la hemos escrito.

Pero entonces perdimos el tema de los GotoIf, no se pueden escribis cosas feas como:

exten => s,n(start),Answer

Y entoces podemos hacer:

exten => s,n,Goto(start)

Hay un par de cosas mas acerca de la prioridad pero voy muy atrasado.

Hay 2 cosas que que nos faltan que son los comandos y la variables, los comandos son mas

simples y uno de los mas importante es Dial.

Dial(tipo/identificador,timeout,opciones,URL)

tipo puede ser cualquiera de los canales definidos (Zap, SIP, IAX2, h323, oh323, ooh323)

identificador depende mucho de la definición del canal. Ya que como venimos poniendo en nuestros

ejemplos SIP/100 depende de que en el sip.con hayamos definido un dispositivo SIP con el label 100.

Pero También podremos hacer una llamada a un teléfono SIP ignoto con

SIP/${EXTEN}@145.12.22.30.

timeout es el tiempo que dial intentara discar dado en segundos, luego terminara la función

y prenderá la opción de t.

opciones tiene una gran cantidad, como por ejemplo t en la cual permite a esta llamada poder hacer

transferencia de llamadas, pueden llegar a tener cosas como cambiar de tipo de ring, determinar como va

ser la llamada, entre otras.

URL este es opcional y es para ciertos canales que permiten URLs

Answer(delay)

Generalmente se pone en los contexto que toman llamadas desde fuera de nuestro Asterisk y podemos

hacer esperar un tiempo determinado en segundos

Playback(file,option)Backgroud(file,option)

Emite el mensaje de voz almacenado en file. Playback emite el mensaje y devuelve el control a la

aplicación, En cambio Backgroud emite el mensaje de voz y si algun DTMF es regitrado y machea con

el contexto lo ejecuta. Los archivos de audio lo busca en /var/lib/asterisk/sound, por defecto, en

instalacion estan los sonidos en Ingles. Pero uno en la misma estructura agrega el directorio es y dentro

los mismos sonido pero en español y setea la vriable de lenguaje SetLanguage en es y vera solo los

sonidos dentro del directorio es.

Goto(contex,extension,priority)Goto(extension,priority)Goto(priority)Goto(contex,extension,label)Goto(extension,label)Goto(label)

Es un salto a un contexto, extension, prioridad o label especifico.

SayDigits(numeros)

Muy util, solo dice los numeros, si dentro de numeros esta 123, el comando dice uno, dos, tres.

SayNumber(numeros,genero)

Hace lo mismo pero dice el numero por ejemplo 123 dice ciento veintitres y en genero va “m” por

male, “f” por female o “c” por computer. Pero se torna indomito para el manejo multilenguaje.

Con esto podemos armar nuestro primer IVR.

[from-pstn]exten => s,n,Answerexten => s,n,Playback(bienvenidos)exten => s(menu0),n,Background(opcionesmenu0)exten => 1,n,goto(menu1)exten => 2,n,goto(menu2) exten => a,n,Playback(graciasporcomunicarse)exten => a,n,hungupexten => i,n,Playback(ingresoinvalido)exten => i,n,goto(menu0)exten => t,n,Playback(marqueunaopcion)exten => t,n,goto(menu0)

[menu1]exten => s,n,Playback(ingresedni)exten => t,n,Playback(porfavor)exten => t,n,goto(menu1)exten => XXXXXXX.,n,SayDigits(${EXTEND})exten => XXXXXXX.,n,Goto(from-pstn,a)exten => i,n,Goto(from-pstn,i)

Falta obviamente el contexto menu2 pero puede ser algo muy parecido.

De todas maneras quiero poner 2 comandos mas:

NoOp()

Que como su nombre lo indica no hace nada pero sirve como printf para debug basico.

Macro(nombremacro,arg1,arg2,...,argN)

Ejecuta un contexto llamado macro-nombremacro y pasa los argumentos que se necesitan al nuevo

contexto. Usa todas las variables ademas de MACRO_EXTEN, MACRO_CONTEXT and

MACRO_PRIORITY den donde es llamado, por ejemplo:

exten => s,n,macro(internacional,${EXTEND})

[macro-internacional]exten => s,n,Dial( Sip/${ARG1}@11.12.12.12,20 )exten => s,n,Dial( oh323/${ARG1}@123.1.1.15 ,20)exten => s,n,Playback(nohaylinea)exten => s,n,Congestion

Toda la info sobre los comandos los podemos encontrar en:

http://www.voip-info.org/wiki/view/Asterisk+-+documentation+of+application+commands Ya entrando en la

interface de programacion de Asterisk nos encontramos con 2 que son las unicas que utilice, AGI y FastAGI.

AGI (script.agi|arg1|arg2|....|argN)

y se ejecuta:

exten => s,n,AGI(dialRadius.agi)

El archivo dialRadius.agi debe estar en /var/lib/asterisk/agi-bin debe ser ejecutable y leible por el

usuario que corre Asterisk y puede ser uno de los varias interfaces que hay a diferentes lenguajes, y

hay para todo Java, Perl, Python, Ruby, PHP, C, C# y bash.

Yo lo he usado en Perl y alli solo se hace:

use Asterisk::AGI;$AGI = new Asterisk::AGI;%input = $AGI->ReadParse();

$AGI->set_callerid($number)$AGI->exec('Dial', 'SIP/ ' . $number . '@' . $someip);$AGI->exec('Hungup');

Es una interface de comandos que al dar exect ejecutamos funciones del dialplan, o podemos setear

variables. Es para integrar Arterisk a Bases de datos pero con programacion incluida, como los

programas de Prepagos. No creo que haya mucho mas que esto. El resto hay que dedicarse a leer.