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=y
essignalling=fxs_ks
context=from-pstnrx
gain=2.0txgain=4.0c
allprogress=yesusec
allerid=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=f
rom-local
bindport=5060binda
ddr=0.0.0.0

[100]type=frie
ndhost=dynamic
username=100
secret=XXXXXXX

[101]type=frie
ndhost=dynamic
username=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:

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

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
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)B
ackgroud(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)G
oto(extension,priority)Goto(prio
rity)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

2interface
que sonde
lasprogramacion de Asterisk
unicas que utilice, AGI y nos encontramos con
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.