AMI Asterisk Manager Interface

要激活AMI,需要在/etc/asterisk/manager.conf中,[general]块下设置enabled=yes

然后添加用户,比如

[admin]

secret = admin

deny = 0.0.0.0/0.0.0.0

permit = 127.0.0.1/255.255.255.0

read = all,system,call,log,verbose,command,agent,user,config

write = all,system,call,log,verbose,command,agent,user,config

 

重启asterisk,用telnet连接到AMI

 

 

[root@Freeiris2 ~]# telnet 127.0.0.1 5038 Trying 127.0.0.1... Connected to localhost.localdomain (127.0.0.1). Escape character is '^]'. Asterisk Call Manager/1.0 

 

现在,可以输入命令来登录,注意冒号后的空格

 

Action: Login ActionID: 1 Username: admin Secret: admin 

 

敲两次回车确认,得到服务器的回复:

 

Response: Success ActionID: 1 Message: Authentication accepted 

 

 

当然了,我们最关心的是如何通过脚本来实现自动化.在鉴权成功后,就可以进行数据包交换了.数据包包的类型在第一行定义.客户端发送Action包,服务器响应Response或者发送Event包.另外数据包中行的顺序是不相关的.每一行使用CR(回车)或LF(换行)来结束.整个数据包使用一个额外的回车或换行来结束.一个AMI终端通常为每一个Action发送一个随机但是唯一的ActionID,服务器使用这个ActionID在Response中来管理重叠的数据包流(packet stream).

 

服务器发送终端Event数据包,可以关联任何事件,每一个事件就是一行,包括终端初始化Action.这种情况下,服务器发送"Response:Follows",紧接初始action的ActionID事件(行)后,接着是一个关闭事件(通常是 actionnameComplete).

 

如果你的终端不需要事件响应,他可以通过包含"Events:off"语句在鉴权数据包中,来关闭这些通知.这样设置后,AMI将只回应终端初始化的actions.

If your client has no need for events, it can turn off these notifications by including Events: off in the authentication packet. Once set, the AMI sends only responses to actions initiated by the client.

 

下面是可用命令表:

Asterisk manager commands

Freeiris2*CLI> show manager commands Action Privilege Synopsis ------ --------- -------- AbsoluteTimeout call,all Set Absolute Timeout AgentCallbackLo agent,all Sets an agent as logged in by callback AgentLogoff agent,all Sets an agent as no longer logged in Agents agent,all Lists agents and their status ChangeMonitor call,all Change monitoring filename of a channel Command command,all Execute Asterisk CLI Command DAHDIDialOffHoo <none> Dial over channel while offhook DAHDIDNDoff <none> Toggle channel Do Not Disturb status OFF DAHDIDNDon <none> Toggle channel Do Not Disturb status ON DAHDIHangup <none> Hangup Channel DAHDIRestart <none> Fully Restart channels (terminates calls) DAHDIShowChanne <none> Show status channels DAHDITransfer <none> Transfer Channel DBGet system,all Get DB Entry DBPut system,all Put DB Entry Events <none> Control Event Flow ExtensionState call,all Check Extension Status GetConfig config,all Retrieve configuration Getvar call,all Gets a Channel Variable Hangup call,all Hangup Channel IAXnetstats <none> Show IAX Netstats IAXpeers <none> List IAX Peers ListCommands <none> List available manager commands Logoff <none> Logoff Manager MailboxCount call,all Check Mailbox Message Count MailboxStatus call,all Check Mailbox MeetmeMute call,all Mute a Meetme user MeetmeUnmute call,all Unmute a Meetme user Monitor call,all Monitor a channel Originate call,all Originate Call Park call,all Park a channel ParkedCalls <none> List parked calls PauseMonitor call,all Pause monitoring of a channel Ping <none> Keepalive command PlayDTMF call,all Play DTMF signal on a specific channel. QueueAdd agent,all Add interface to queue. QueuePause agent,all Makes a queue member temporarily unavailable QueueRemove agent,all Remove interface from queue. Queues <none> Queues QueueStatus <none> Queue Status Redirect call,all Redirect (transfer) a call SetCDRUserField call,all Set the CDR UserField Setvar call,all Set Channel Variable SIPpeers system,all List SIP peers (text format) SIPshowpeer system,all Show SIP peer (text format) Status call,all Lists channel status StopMonitor call,all Stop monitoring a channel UnpauseMonitor call,all Unpause monitoring of a channel UpdateConfig config,all Update basic configuration UserEvent user,all Send an arbitrary event WaitEvent <none> Wait for an event to occur ZapDialOffHook <none> Dial over channel while offhook ZapDNDoff <none> Toggle channel Do Not Disturb status OFF ZapDNDon <none> Toggle channel Do Not Disturb status ON ZapHangup <none> Hangup Channel ZapRestart <none> Fully Restart channels (terminates calls) ZapShowChannels <none> Show status channels ZapTransfer <none> Transfer Channel