Asterisk ami-action

Overview

Asterisk ami(Asteriskk Manager Interface) 명령어 정리.

Basic

Telnet 접속

/etc/asterisk/manager.conf 파일에 설정한 IP 주소 및 포트 번호를 이용하면 telnet 으로도 접속이 가능하다.

$ telnet 127.0.0.1 5038
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Asterisk Call Manager/1.0

Login

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

Queue

QueueStatus

Queue 의 현재 상태 정보를 확인한다. 입력된 Queue 항목의 없다면 현재 활성화된 전체 Queue 의 상태 정보를 리턴한다.

Action Request

Action: QueueStatus
Queue: Camp200
ActionID: 001

• Queue - 확인하고자 하는 Queue name.

Action Response

Response: Success
ActionID: 001
Message: Queue status will follow

Event: QueueParams
Queue: Camp200
Max: 0
Strategy: ringall
Calls: 0
Holdtime: 0
TalkTime: 0
Completed: 0
Abandoned: 0
ServiceLevel: 0
ServicelevelPerf: 0.0
Weight: 100
ActionID: 001

Event: QueueMember
Queue: Camp200
Name: user1
Location: Local/200@DialCamp
Membership: static
Penalty: 0
CallsTaken: 0
LastCall: 0
Status: 5
Paused: 0
ActionID: 001

Event: QueueStatusComplete
ActionID: 001

- QueueParam 정보

• Event - 메시지 타입. QueueParam:Queue 정보, QueueMember:Queue에 속해있는 member 정보.
• Queue - Queue name
• Max - Queue에서 허용 가능한 최대 콜 수.
• Strategy - 콜 분배 방식.(rignall|roundrobin|leastrecent|fewestcalls|random|rrmemory|linear|wrandom)
• HoldTime - 현재 평균 큐 대기 시간.
• Weight - 큐의 우선 순위. 높은(많은) 우선순위를 가진 큐의 콜이 낮은(적은) 우선순위를 가진 큐보다 먼저 분배될 확률이 높아진다.
• ServiceLevel - ServiceLevelPerf 를 확인하는 Interval time(sec)
• ServicelevelPerf - SerivceLevel 시간동안의 콜 응답률(%). 응답 콜 /전체 인입 콜 * 100
• Calls - 현재 큐에서 대기중인 콜의 갯수.
• Abandoned - 큐에서 대기중에 분배되지 못하고 끊어진 콜.
• TalkTikme - 분배 후 평균 통화시간.
• Completed - 정상적으로 분배 완료된 콜 갯수

- QueueMember 정보

• Event - 메시지 타입. QueueParam:Queue 정보, QueueMember:Queue에 속해있는 member 정보.
• Queue - Queue name
• Name - Member name
• Status - 멤버의 상태 번호(0:AST_DEVICE_UNKNOWN, 1:AST_DEVICE_NOT_INUSE, 2:AST_DEVICE_INUSE, 3:AST_DEVICE_BUSY, 4:AST_DEVICE_INVALID, 5:AST_DEVICE_UNAVAILABLE, 6:AST_DEVICE_RINGING, 7:AST_DEVICE_RINGINUSE, 8:AST_DEVICE_ONHOLD).
• Location - 멤버의 Channel 정보 혹은 위치 정보
• StateInterface - 멤버의 상태 정보를 확인하는 장치 정보.
• Membership - 멤버의 등록 방법(dynamic|realtime|static).
• Penalty - 패널티 정보(높은 패널티를 가지게 되면 상대적으로 콜을 분배받기 어려워진다.)
• CallsTaken - 분배받은 콜의 숫자
• LastCall - 마지막으로 받은 콜의 시간. Unix 타임을 사용한다.
• Paused - Paused 여부. (1:Paused 상태, 0:Normal 상태)

See also

• https://wiki.asterisk.org/wiki/display/AST/AMI+Actions - Asterisk-1.8 AMI reference guide.
• https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+AMI+Actions - Asterisk-10 AMI reference guide.
• https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+AMI+Actions - Asterisk-11 AMI Action reference guide.
• https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+AMI+Events - Asterisk-11 AMI Event reference guide.
• https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+AMI+Actions - Asterisk-12 AMI Action reference guide.
• https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+AMI+Events - Asterisk-12 AMI Event reference guide.
• https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+AMI+Actions - Asterisk-13 AMI Action reference guide.
• https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+AMI+Events - Asterisk-13 AMI Event reference guide.

References

<references />