Documentação do Asterisk 23
Documentação do Asterisk 22
Documentação do Asterisk 21
Documentação do Asterisk 20
Documentação do Asterisk 18
Documentação do Asterisk 17
Documentação do Asterisk 16
Documentação do Asterisk 15
Documentação do Asterisk 14
Documentação do Asterisk 13
Documentação do Asterisk 12
Documentação do Asterisk 11
AGI()
Executa uma aplicação compatível com AGI.
Executa um programa compatível com Asterisk Gateway Interface (AGI) em um canal. O AGI permite que o Asterisk inicie programas externos escritos em qualquer linguagem para controlar um canal de telefonia, reproduzir áudio, ler dígitos DTMF, etc., comunicando-se por meio do protocolo AGI.
As seguintes variantes de AGI existem e são escolhidas com base no valor passado ao parâmetro command:
- AGI - A variante clássica do AGI, que inicia o script especificado por
commandcomo um novo processo. A comunicação com o script ocorre via stdin e stdout. Se o caminho completo para o script não for fornecido, será utilizado o diretórioastagidirespecificado emasterisk.conf. - FastAGI - Conecta o Asterisk a um servidor FastAGI usando uma conexão TCP. O URI para o servidor FastAGI deve ser fornecido no formato
[scheme]://host.domain[:port][/script/name], ondeschemeé agi ou hagi. No caso de hagi, uma consulta SRV será realizada para tentar conectar a uma lista de servidores FastAGI. O nome do host no URI deve ser prefixado com _agi._tcp antes da resolução DNS. Por exemplo, se você especificar o URIhagi://agi.example.com/foo.agi, a consulta DNS será por _agi._tcp.agi.example.com. É necessário garantir que isso seja resolvido corretamente. - AsyncAGI - Usa a AMI para controlar o canal via AGI. Comandos AGI podem ser invocados usando a ação
AMI, com uma variedade de eventos específicos do AGI retornados pela conexão AMI. O AsyncAGI deve ser invocado passandoagi:asyncao parâmetrocommand.
Observação: A partir da versão 1.6.0, este canal não interrompe a execução do dialplan em caso de desligamento dentro desta aplicação. A execução do dialplan continuará normalmente, mesmo após o desligamento, até que a aplicação AGI indique o desejo de parar (seja ao sair ou, no caso de um script de rede, ao fechar a conexão). Um script AGI executado localmente receberá SIGHUP em caso de desligamento do canal, exceto quando já estiver desligado. Um servidor FastAGI receberá um sinal HANGUP em linha com o diálogo de comando. Ambos os sinais podem ser desativados definindo a variável de canal AGISIGHUP como no antes de executar a aplicação AGI. Alternativamente, se desejar que a aplicação AGI saia imediatamente após detectar o desligamento do canal, defina a variável AGIEXITONHANGUP como yes.
Exemplos:
- Iniciar o script AGI
/tmp/my-cool-script.sh, passando o conteúdo da variável de canal FOO:same => n,AGI(/tmp/my-cool-script.sh,${FOO}) - Iniciar o script AGI
my-cool-script.shlocalizado no diretórioastagidir, especificado emasterisk.conf:same => n,AGI(my-cool-script.sh) - Conectar ao servidor FastAGI localizado em
127.0.0.1e iniciar o scriptawesome-script:same => n,AGI(agi://127.0.0.1/awesome-script) - Iniciar AsyncAGI:
same => n,AGI(agi:async)
Variáveis retornadas:
- AGISTATUS - O status da tentativa de execução do script AGI, uma das opções: SUCCESS, FAILURE, NOTFOUND, HANGUP
Sintaxe: AGI(command,arg1,[arg2[,...]])
Parâmetros:
- command - Como o AGI deve ser invocado no canal.
- args - Argumentos a serem passados ao script ou servidor AGI. arg1 é obrigatório.
same => n,AGI(/tmp/my-cool-script.sh,${FOO})
same => n,AGI(my-cool-script.sh)
same => n,AGI(agi://127.0.0.1/awesome-script)
same => n,AGI(agi:async)
AGI(command,arg1,[arg2[,...]])
ENTRE EM CONTATO COM A LOJAMUNDI.
