Asterisk: The Future of Telephony

Name

DeadAGI() — Executes an AGI-compliant script on a dead (hung-up) channel

Synopsis

    DeadAGI(program,args)

Executes an AGI-compliant program on a dead (hung-up) channel. AGI allows Asterisk to launch external programs written in almost any language to control a telephony channel, play audio, read DTMF digits, and so on by communicating with the AGI protocol on STDIN and STDOUT. The arguments specified by args will be passed to the program.

This application has been written specifically for dead channels, as the normal AGI interface doesn’t work correctly if the channel has been hung up.

Use the show agi command on the command-line interface to list all of the available AGI commands.

Returns -1 if the application requested a hangup, or 0 on a non-hangup exit.

               exten => h,1,DeadAGI(agi-test)

See Also

AGI(), FastAGI()