目录 Action URI 使用说明... 1 1. Action URI... 1 2. 话机配置... 1 3. Action URI 的使用... 2 4.Yealink 话机通过 Action URI 可实现的功能 :... 3 1) 接听来电 :... 3 2) 使用免提键 :... 3 3) 使用转接键 TRAN:... 3 4) 增加音量 :... 3 5) 减小音量 :... 3 6) 使用静音键 Mute... 4 7) 使用保持键 Hold:... 4 8) 挂断电话键 cancel... 4 9) 使用会议键 CONF:... 4 10) 使用软键 1:... 4 11) 使用软键 2:... 4 12) 使用软键 3:... 4 13) 使用软键 4:... 4 14) 使用信箱键 MESSAGE:... 4 15) 使用耳麦键 HEADSET :... 4 16) 使用重播键 RD:... 4 17) 使用方向键 上 :... 4 18) 使用方向键 下 :... 4 19) 使用方向键 左 :... 4 20) 使用方向键 右 :... 5 21) 重启话机 :... 5
22) 使话机检测 Auto provision 更新 :... 5 23) 开启 DND:... 5 24) 关闭 DND:... 5 25) 使用数字键 0 :... 5 26) 使用数字键 1 :... 5 27) 使用数字键 2 :... 5 28) 使用数字键 3 :... 5 29) 使用数字键 4 :... 5 30) 使用数字键 5 :... 5 31) 使用数字键 6 :... 5 32) 使用数字键 7 :... 5 33) 使用数字键 8 :... 5 34) 使用数字键 9 :... 6 35) 使用 * 键 :... 6 36) 使用 # 键 :... 6 37) 使用 line 1 键 :... 6 38) 使用 line 2 键 :... 6 39) 使用 line 3 键 :... 6 40) 使用 line 4 键 :... 6 41) 使用 line 5 键 :... 6 42) 使用 line 6 键 :... 6 43) 使用 DSS 键 1:... 6 44) 使用 DSS 键 2:... 6 45) 使用 DSS 键 3:... 6 46) 使用 DSS 键 4:... 6 47) 使用 DSS 键 5:... 6 48) 使用 DSS 键 6:... 7 49) 使用 DSS 键 7:... 7 50) 使用 DSS 键 8:... 7
51) 使用 DSS 键 9:... 7 52) 使用 DSS 键 10:... 7 53) 拨号 :... 7
Action URI 使用说明 1. Action URI Action URI, 从功能的实现效果来理解, 即在远端 ( 如 PC) 发一个 URL 至话机, 话机接收到后会产生某个动作如拨号 开启 DND, 摘机等如果软电话上的每一个按键都绑定一个 URI, 就实现了软电话控制话机的功能 例如, 软电话上的数字键 1 绑定的 URI 是 http://phone ip/cgi-bin/configmanapp.com?key=1 该功能与 Action URL 配合使用, 实现话机与软电话的相互控制 2. 话机配置 为了保证话机不被随意的控制,V70 及以上版本中默认禁止所有 IP 对话机进行控制 如果要允许话机被控制, 要将控制方的 IP 地址填入 Action URI 信任 IP 如下图所示 : V70 V71 及以上版本 1
3. Action URI 的使用 用户在对应的地址栏输入对应的 HTTP 指令, 话机在接收到相应 URI 指令后可以执行对应的操作, 同时要给发送者 200 ok 的回复 用户在网页地址栏输入 http://phone ip/cgi-bin/configmanapp.com?key=xxx 其中 Phone ip 替换为话机的 IP,key=xxx 替换为相应的功能按键 例如 : 话机的 IP 地址为 10.1.4.22, 则在网页地址输入栏内输入 http://10.1.4.22/cgi-bin/configmanapp.com?key=ok, 话机就执行按下 OK 键的动作, 进入 Status 菜单 如下图 2-1 所示 : 图 2-1 地址栏中输入 URI 地址 注意 : 在不同的话机界面, 按键会实现不同的功能 2
如果话机版本是 V60/V61 及以上, 请确保话机配置 功能 ActionURI 限制 IP 的值为空 ( 接收所有 IP 的命令 ), 或者你的主机地址有被包含 如果话机版本是 V70 及以上, 请确保话机配置 功能 ActionURI 限制 IP 的值为 any( 接收所有 IP 的命令 ), 或者你的主机地址有被包含 如果话机版本是 V71 及以上, 请确保功能 远程控制 允许控制 IP 列表的值为 any( 接收所有 IP 的命令 ), 或者你的主机地址有被包含 V70 及以前的话机版本,URI 请求链接是 /cgi-bin/configmanapp.com?key=ok V71 及以后的话机版本,URI 请求链接是 /servlet? key=ok 格式不一样,v71 兼容旧链接的方式是通过返回 302, 重定向新地址实现的, 会在 302 回包中带有新地址 如果软电话不支持重定向, 没有处理 302 这个回包, 也就不会继续请求新地址, 从而控制失败! 4.Yealink 话机通过 Action URI 可实现的功能 : ( 假设话机 IP:10.1.4.22) 1) 接听来电 : http://10.1.4.22/cgi-bin/configmanapp.com?key=ok ( 按 OK 键接听 ) http://10.1.4.22/cgi-bin/configmanapp.com?key=enter ( 按 enter 键接听 ) http://10.1.4.22/cgi-bin/configmanapp.com?key=speaker ( 按 speaker 键接听 ) 2) 使用免提键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=speaker 3) 使用转接键 TRAN: http://10.1.4.22/cgi-bin/configmanapp.com?key=f_transfer 4) 增加音量 : http://10.1.4.22/cgi-bin/configmanapp.com?key=volume_up 5) 减小音量 : http://10.1.4.22/cgi-bin/configmanapp.com?key=volume_down 3
6) 使用静音键 Mute: http://10.1.4.22/cgi-bin/configmanapp.com?key=mute 7) 使用保持键 Hold: http://10.1.4.22/cgi-bin/configmanapp.com?key=f_hold 8) 挂断电话键 cancel: http://10.1.4.22/cgi-bin/configmanapp.com?key=x (T20/T22: http://10.1.4.22/cgi-bin/configmanapp.com?key=callend) 9) 使用会议键 CONF: http://10.1.4.22/cgi-bin/configmanapp.com?key=f_conference 10) 使用软键 1: http://10.1.4.22/cgi-bin/configmanapp.com?key=f1 11) 使用软键 2: http://10.1.4.22/cgi-bin/configmanapp.com?key=f2 12) 使用软键 3: http://10.1.4.22/cgi-bin/configmanapp.com?key=f3 13) 使用软键 4: http://10.1.4.22/cgi-bin/configmanapp.com?key=f4 14) 使用信箱键 MESSAGE: http://10.1.4.22/cgi-bin/configmanapp.com?key=msg 15) 使用耳麦键 HEADSET : http://10.1.4.22/cgi-bin/configmanapp.com?key=headset 16) 使用重播键 RD: http://10.1.4.22/cgi-bin/configmanapp.com?key=rd 17) 使用方向键 上 : http://10.1.4.22/cgi-bin/configmanapp.com?key=up 18) 使用方向键 下 : http://10.1.4.22/cgi-bin/configmanapp.com?key=down 19) 使用方向键 左 : http://10.1.4.22/cgi-bin/configmanapp.com?key=left 4
20) 使用方向键 右 : http://10.1.4.22/cgi-bin/configmanapp.com?key=right 21) 重启话机 : http://10.1.4.22/cgi-bin/configmanapp.com?key=reboot 22) 使话机检测 Auto provision 更新 : http://10.1.4.22/cgi-bin/configmanapp.com?key=autop 23) 开启 DND: http://10.1.4.22/cgi-bin/configmanapp.com?key=dndon 24) 关闭 DND: http://10.1.4.22/cgi-bin/configmanapp.com?key=dndoff 25) 使用数字键 0 : http://10.1.4.22/cgi-bin/configmanapp.com?key=0 26) 使用数字键 1 : http://10.1.4.22/cgi-bin/configmanapp.com?key=1 27) 使用数字键 2 : http://10.1.4.22/cgi-bin/configmanapp.com?key=2 28) 使用数字键 3 : http://10.1.4.22/cgi-bin/configmanapp.com?key=3 29) 使用数字键 4 : http://10.1.4.22/cgi-bin/configmanapp.com?key=4 30) 使用数字键 5 : http://10.1.4.22/cgi-bin/configmanapp.com?key=5 31) 使用数字键 6 : http://10.1.4.22/cgi-bin/configmanapp.com?key=6 32) 使用数字键 7 : http://10.1.4.22/cgi-bin/configmanapp.com?key=7 33) 使用数字键 8 : http://10.1.4.22/cgi-bin/configmanapp.com?key=8 5
34) 使用数字键 9 : http://10.1.4.22/cgi-bin/configmanapp.com?key=9 35) 使用 * 键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=* 36) 使用 # 键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=pound 37) 使用 line 1 键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=l1 38) 使用 line 2 键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=l2 39) 使用 line 3 键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=l3 40) 使用 line 4 键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=l4 41) 使用 line 5 键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=l5 42) 使用 line 6 键 : http://10.1.4.22/cgi-bin/configmanapp.com?key=l6 43) 使用 DSS 键 1: http://10.1.4.22/cgi-bin/configmanapp.com?key=d1 44) 使用 DSS 键 2: http://10.1.4.22/cgi-bin/configmanapp.com?key=d2 45) 使用 DSS 键 3: http://10.1.4.22/cgi-bin/configmanapp.com?key=d3 46) 使用 DSS 键 4: http://10.1.4.22/cgi-bin/configmanapp.com?key=d4 47) 使用 DSS 键 5: http://10.1.4.22/cgi-bin/configmanapp.com?key=d5 6
48) 使用 DSS 键 6: http://10.1.4.22/cgi-bin/configmanapp.com?key=d6 49) 使用 DSS 键 7: http://10.1.4.22/cgi-bin/configmanapp.com?key=d7 50) 使用 DSS 键 8: http://10.1.4.22/cgi-bin/configmanapp.com?key=d8 51) 使用 DSS 键 9: http://10.1.4.22/cgi-bin/configmanapp.com?key=d9 52) 使用 DSS 键 10: http://10.1.4.22/cgi-bin/configmanapp.com?key=d10 53) 拨号 : http://phoneip/cgi-bin/configmanapp.com?number=xxx&outgoing_uri=xxx 其中 phoneip 替换为话机的 IP,number=xxx 替换为想要呼出的号码 (8530), outgoing_uri=xxx 替换为要使用的账号 ( 8532@192.168.1.199 ) 例如 : http://10.1.4.22/cgi-bin/configmanapp.com?number=8530&outgoing_uri=8532@19 2.168.1.199 上面的 uri 表示号码为 8532,IP 为 10.1.4.22 的话机向和号码 8530 的话机拨号. 192.168.1.199 为 8532 注册的服务器地址. 7