DIALPLAN

El Plan de Marcacin, llamando Dialplan en Asterisk, podra

considerarse la columna vertebral del sistema. Como caracterstica
principal, podramos decir que es algo parecido a un lenguaje de
script, en el que funciones, aplicaciones y recursos se van
intercalando para formar algo parecido a "procedimientos" y
"programas" dentro de lo que pudiera considerarse.
Este paradigma de programacin orientado a los canales de telefona
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.

Aplicaciones imprescindibles en tu Dialplan

Aunque Asterisk ofrece cientos de aplicaciones para
personalizar hasta el ltimo detalle cualquier dialplan, casi
siempre se utiliza una lista mucho ms corta pues son las que
ofrecen los servicios ms demandados o ms comnmente
demandados por las empresas. En esta seccin hemos
querido recoger una pequea seleccin con algunas de estas
aplicaciones:
Para los interesados, la lista completa puede encontrarse en
este enlace de la Wiki oficial de Asterisk.
AGI
Permite ejecutar aplicaciones externas (principalmente
scripts). Tiene una variable asociada, AGISTATUS que
permite comprobar si la ejecucin del programa externo
ha sido un xito, ha fallado o incluso si ha sido la
responsable de colgar una llamada.
Sintaxis:

AGI(command,arg1,[arg2[,...]])

Answer
Responder a una llamada entrante (para ser ms
exactos, responde a un canal en estado 'ringing').

Sintaxis:

Answer([delay,[nocdr]])

Background
Reproduce una locucin pasada como parmetro a la vez
que espera a que el lado al que se le est reproduciendo
la locucin marque una extensin a la que saltar dentro
del Dialplan. En funcin del nmero de DTMFs que se
quiera especificar para el men, puede ser tambin
necesario el uso de la aplicacin WaitExten().
Sintaxis:

BackGround(filename1&[filename2[&...]],[options,[langoverride,

[context]]])

Busy
Indica al lado llamante (calling part) que el lado llamado
(called part) est ocupado.
Sintaxis:

Busy([timeout])

ConfBridge
Permite que un usuario entre en una sala de
conferencias especfica. Si lo desea, el usuario puede
salirse de la sala colgando la llamada o pulsando un
DTMF si est configurado as. Esta aplicacin es la
evolucin de la aplicacin MeetMe. El uso de esta
aplicacin es algo avanzado y est asociado al
fichero confbridge.conf.
Sintaxis:

ConfBridge(conference,[bridge_profile,[user_profile,[menu]]])

Congestion
Indica al lado llamante (calling part) que el lado llamado
(called part) est congestionado.

Sintaxis:

Congestion([timeout])

Dial
Es la aplicacin as importante de Asterisk. Permite
lanzar una llamada a uno o ms destinos especificados
como argumentos de la aplicacin. Tiene varias variables
asociadas, DIALEDTIME, ANSWEREDTIME y DIALSTATUS adems de
ms de 20 opciones disponibles para utilizar como
argumento options.
Sintaxis:

Dial(Technology/Resource&[Technology2/Resource2[&...]],
[timeout,[options,[URL]]])

GoSub
Salta al punto del dialplan objetivo y contina la
ejecucin del dialplan. Una vez encuentra una orden
de Return, vuelve al punto del programa desde el cual se
inici el salto. Existen alternativas a esta aplicacin con
saltos condicionales.
Sintaxis:

Gosub([context,[exten,]]priority[(arg1,[...][argN]]))

Goto
Es prcticamente idntica a la aplicacin GoSub nada
ms que en este caso no existe una ruta directa al
mismo punto del programa desde el cual se inici el
salto. Existen alternativas a esta aplicacin con saltos
condicionales.
Sintaxis:

Goto([context,[extensions,]]priority)

Hangup
Permite colgar un canal que est siendo utilizado.
Sintaxis:

Hangup([causecode])

 NoOp
"Do Nothing". No realiza ninguna operacin pero si se le
pasa como argumento un string de texto, ste aparecer
en el CLI de Asterisk cada vez que se ejecute esta lnea.
Principalmente se utiliza para depurar el dialplan.
Sintaxis:

NoOp([text])

Queue
Mete la llamada entrante en una queue de llamadas a la
espera de ser atendidas por un agente libre. Tiene una
variable asociada, QUEUESTATUS que controla el estado de
la queue a la que se quiere enviar la llamada.
Sintaxis:

Queue(queuename,[options,[URL,[announceoverride,[timeout,
[AGI,[macro,[gosub,[rule,[position]]]]]]]]])

Read
Lee un valor por la entrada estndar y lo almacena en
una variable.
Sintaxis:

Read(variable,filename&[filename2[&...]],[maxdigits,[options,
[attempts,[timeout]]]]])

Record
Graba en un fichero todo lo que diga quien ha lanzado la
llamada a la aplicacin. Es la funcin que se suele
utilizar para grabar en el sistema mensajes de voz
personalizados.
Sintaxis:

Record(filename.format,[silence,[maxduration,[options]]])

Set
Permite asignarle un valor a una variable.

Sintaxis:

Set(name=value)

Verbose
Enva el mensaje pasado como parmetro a la salida
de Verbose (si est configurado el fichero logger.conf, los
mensajes aparecern en los logs del sistema).
Sintaxis:

Verbose([level,]message)

VoiceMail
Permite dejar un mensaje en el buzn de voz (mailbox)
indicado como parmetro. Tiene una variable
asociada, VMSTATUS que permite comprobar si la llamada a
la aplicacin VoiceMail ha sido un xito, ha fallado o incluso
si se ha abandonado antes de que la ejecucin de la
aplicacin haya almacenado algn dato.
Sintaxis:

VoiceMail(mailbox1&[mailbox2[&...]],[options])

VoiceMailMain
Permite comprobar el estado del buzn de voz indicado
como argumento. Da acceso al men del buzn de voz
para escuchar, cambiar de directorio o borrar los
mensajes de voz almacenados.
Sintaxis:

VoiceMailMain([mailbox@[context]],[options])

Wait
Detine la ejecucin del dialplan durante el tiempo (en
segundos) que se le indique a la aplicacin como
argumento.
Sintaxis:

Wait(seconds)

WaitExten

Espera durante un tiempo a que el usuario introduzca un

nmero de extensin al que saltar.
Sintaxis:

WaitExten([seconds,[options]])

BIBLIOGRAFIA
https://openwebinars.net/blog/tutorial-asterisk-ivr-y-funciones-dialplan/
https://www.youtube.com/watch?v=I3j_L9ZB8hw
http://curso--de-asterisk.blogspot.pe/2009/03/dial-plan-features.html