09-可定制IVR命令
本章节下载: 09-可定制IVR命令 (175.82 KB)
1.1.4 display voice ivr call-info
1.1.5 display voice ivr media-play
1.1.6 display voice ivr media-source
1.1.18 select-rule operation-order
MSR800、MSR 900、MSR900-E、MSR 930、MSR 2600、MSR 30-11、MSR 30-11E、MSR 30-11F和MSR3600-51F路由器不支持语音功能。
【命令】
call-normal { length number-length | matching | terminator character }
undo call-normal
【视图】
Call节点视图
【缺省级别】
2:系统级
【参数】
length number-length:匹配号码的长度,取值范围为1~31。
matching:随时匹配号码进行呼叫,即只要被匹配到拨入号码,就立即进行二次呼叫。
terminator character:结束符,取值范围为0~9、*、#。
【描述】
call-normal命令用来配置普通二次呼叫的号码匹配策略。undo call-normal命令用来取消已有配置。
缺省情况下,没有配置普通二次呼叫的号码匹配策略。
【举例】
# 配置普通二次呼叫,采用#为结束符。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 call
[Sysname-voice-ivr-node1] call-normal terminator #
# 配置普通二次呼叫,匹配号码的长度为7。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 call
[Sysname-voice-ivr-node1] call-normal length 7
# 配置普通二次呼叫,采用随时匹配用户输入的号码。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 call
[Sysname-voice-ivr-node1] call-normal matching
【命令】
description text
undo description
【视图】
Call/Jump/Service节点视图
【缺省级别】
2:系统级
【参数】
text:节点的描述信息,为1~80个字符,可以包含空格,区分大小写。
【描述】
description命令用来配置节点的描述信息。undo description命令用来取消节点的描述信息。
缺省情况下,没有配置节点描述信息。
【举例】
# 配置Jump节点的描述信息。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 jump
[Sysname-voice-ivr-node1] description first-node
【命令】
dial-prefix string
undo dial-prefix
【视图】
Call节点视图
【缺省级别】
2:系统级
【参数】
string:前缀码,为1~31个字符的字符串,字符串可以由“0123456789”、“#”或“*”进行组合。各符号的含义如表1-1所示:
表1-1 参数string中的符号含义
符号 |
含义 |
0-9 |
一位数字表示一位号码,0到9之间的数字 |
#或* |
表示一位有效号码 |
【描述】
dial-prefix命令用来配置Call节点下所拨电话号码的前缀号码,即在被叫号码前加上所配置的前缀号码。undo dial-prefix命令用来删除已配置的拨号前缀号码。
缺省情况下,没有配置前缀号码。
当添加前缀号码后,号码总长度超过31位时,只保留前31位号码。
【举例】
# 配置“*21#”作为Call节点下的号码前缀。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 call
[Sysname-voice-dial-node1] dial-prefix *21#
【命令】
display voice ivr call-info [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2:系统级
【参数】
|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。
begin:从包含指定正则表达式的行开始显示。
exclude:只显示不包含指定正则表达式的行。
include:只显示包含指定正则表达式的行。
regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。
【描述】
display voice ivr call-info命令用来查看IVR呼叫情况。
【举例】
# 查看IVR呼叫情况。
<Sysname> display voice ivr call-info
Index Called-Number Caller-Number Entity Node-Id Status
-------------------------------------------------------------------------
1 101 100 101 1 PLAY MEDIA
2 406 200 201 3 WAIT INPUT
3 606 300 301 6 CALL
4 806 400 401 9 IDLE
表1-2 display voice ivr call-info命令显示信息描述表
字段 |
描述 |
Index |
呼叫信息索引 |
Called-Number |
被叫号码 |
Caller-Number |
主叫号码 |
Entity |
被叫号码对应的IVR实体号 |
Node-Id |
正在执行的节点号 |
Status |
当前执行所处的状态: · IDLE:当前节点执行状态处于空闲状态 · PLAY MEDIA:当前节点执行状态处于播放媒体状态 · WAIT INPUT:当前节点执行状态处于等待按键状态 · CALL:当前节点执行状态处于呼叫状态 |
【命令】
display voice ivr media-play [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2:系统级
【参数】
|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。
begin:从包含指定正则表达式的行开始显示。
exclude:只显示不包含指定正则表达式的行。
include:只显示包含指定正则表达式的行。
regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。
【描述】
display voice ivr media-play命令用来查看IVR放音信息。
【举例】
# 查看放音情况。
<Sysname> display voice ivr media-play
Index Codec Media-Id Play-Times Status Type
--------------------------------------------------------------------------
1 g729r8 1001 3 play PSTN:1/0
2 g711alaw 1002 2 stop IP:100.1.1.1
3 g711ulaw 1003 2 stop IP:100.1.1.1
4 g723r53 1004 2 stop IP:100.1.1.1
表1-3 display voice ivr media-play命令显示信息描述表
描述 |
|
Index |
放音信息索引 |
Codec |
放音编解码类型,包括g729r8、g711alaw、g711ulaw和g723r53四种编解码类型 |
Media-Id |
媒体文件ID |
Play-Times |
媒体文件总共要播放的次数 |
Status |
当前的放音状态: · play · stop |
Type |
当前的放音类型: · PSTN:从PSTN接入,此例中的1/0表示从语音用户线1/0呼入 · IP:对端IP地址 |
【命令】
display voice ivr media-source [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2:系统级
【参数】
|:使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍,请参见“基础配置指导”中的“CLI”。
begin:从包含指定正则表达式的行开始显示。
exclude:只显示不包含指定正则表达式的行。
include:只显示包含指定正则表达式的行。
regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。
【描述】
display voice ivr media-source命令用来查看媒体资源文件的读取信息。
【举例】
# 查看媒体资源文件的读取信息。
<Sysname> display voice ivr media-source
Codec Media-Id source Size (Bytes) Read-Number Cache-Number
--------------------------------------------------------------------------
g729r8 1000 cfa0:/wav/g7 69304 1 1
29r8/0.wav
g711alaw 1006 MOH1/1 Real-Time 2 4
表1-4 display voice ivr media-source命令显示信息描述表
字段 |
描述 |
Codec |
文件使用的编解码类型 |
Media-Id |
媒体文件ID |
Source |
媒体资源: · 如果是媒体文件,显示文件名 · 如果是MOH音频输入端口,则显示格式为:MOH端口号 |
Size (Bytes) |
媒体资源大小,以字节为单位 · 如果是媒体文件,显示文件大小 · 如果是MOH音频输入端口,则显示Real-Time |
Read-Number |
此文件对应的读控制块编号 |
Cache-Number |
此文件对应的缓冲区编号 |
【命令】
entity entity-number ivr
undo entity { entity-number | all | ivr }
【视图】
语音拨号策略视图
【缺省级别】
2:系统级
【参数】
entity-number:表示一个IVR语音实体,取值范围为1~2147483647。
all:表示所有的实体类型,包括VoIP、POTS、VoFR、IVR。
ivr:表示实体类型为IVR。
【描述】
entity ivr命令用来创建IVR语音实体,并进入IVR语音实体视图。undo entity ivr命令用来删除IVR语音实体。
缺省情况下,没有创建IVR语音实体。
关于VoFR语音实体的详细介绍请参见“语音配置指导”中的“VoFR”,关于VoIP、POTS语音实体的详细介绍请参见“语音配置指导”中的“语音实体”。
【举例】
# 创建IVR语音实体100。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 100 ivr
【命令】
extension extension-number call corresponding-number
undo extension extension-number
【视图】
Call节点视图
【缺省级别】
2:系统级
【参数】
extension-number:用户输入的号码,取值范围为0~9、*、#,最大长度为31位。
corresponding-number:扩展的电话号码,取值范围为0~9、*、#,最大长度为31位。
【描述】
extension命令用来配置用户进行二次呼叫的电话号码,一个Call节点下最多可以配置10条扩展二次呼叫。undo extension命令用来取消已有配置。
缺省情况下,没有配置扩展二次呼叫。
【举例】
# 配置扩展二次呼叫,按0表示呼叫号码5000。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 call
[Sysname-voice-ivr-node1] extension 0 call 5000
【命令】
input-error { end-call | goto-pre-node | goto-node node-id } [ media-play media-id [ play-times ] | repeat repeat-times ] *
undo input-error
【视图】
Jump/Call节点视图
【缺省级别】
2:系统级
【参数】
end-call:输入错误次数到达设定值后结束呼叫。
goto-pre-node:输入错误次数到达设定值后返回上一级节点。
goto-node node-id:输入错误次数到达设定值后跳到的节点。
media-play media-id:输入错误时重新执行当前节点前播放的提示音的媒体资源ID,取值范围为0~2147483647。
play-times:播放提示音的次数,取值范围为1~255,缺省值为1。
repeat repeat-times:允许输入错误的次数,每次输入错误将重新执行该节点的功能,当输入错误次数到达设定的值后按配置的处理方式进行处理,输入错误次数取值范围为0~255,缺省值为3。
【描述】
input-error命令用来配置节点下用户输入错误的处理策略。undo input-error命令用来取消已有配置。
缺省情况下,没有设置节点下输入错误的处理策略。
【举例】
# 配置Jump节点下等待用户输入错误处理策略:结束呼叫,媒体资源ID为1000,播放错误提示音6次,允许输入错误5次。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 jump
[Sysname-voice-ivr-node1] input-error end-call media-play 1000 6 repeat 5
# 配置Jump节点下等待用户输入错误处理策略:返回上一级节点,媒体资源ID为1001,播放错误提示音1次,允许输入错误3次。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 jump
[Sysname-voice-ivr-node1] input-error goto-pre-node media-play 1001 1 repeat 3
# 配置Jump节点下等待用户输入错误处理策略:跳转到节点20,媒体资源ID为1002,播放错误提示音3次,允许输入错误5次。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr ] node 1 jump
[Sysname-voice-ivr-node1 ] input-error goto-node 20 media-play 1002 3 repeat 5
【命令】
ivr-input-error { media-play media-id [ play-times ] | repeat repeat-times } *
undo ivr-input-error
【视图】
IVR管理视图
【缺省级别】
2:系统级
【参数】
media-play media-id:配置输入错误时重新执行当前节点前播放的提示音的媒体资源ID,取值范围为0~2147483647。
play-times:播放提示音的次数,取值范围为1~255,缺省值为1次。
repeat repeat-times:允许的输入错误的次数,每次输入错误后将重新执行该节点的功能,当输入错误次数超过设定的值后将结束呼叫。取值范围为0~255,缺省值为3次。
【描述】
ivr-input-error命令用来配置全局IVR用户输入错误的处理策略。undo ivr-input-error命令用来恢复缺省情况。
缺省情况下,允许输入错误次数为3次,无放音,达到输入错误次数后结束呼叫。
【举例】
# 配置全局IVR用户输入错误处理策略:媒体资源Id为10002,播放错误提示音2次,允许输入错误5次。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] ivr-input-error media-play 10002 2 repeat 5
【命令】
ivr-root node-id
undo ivr-root
【视图】
IVR语音实体视图
【缺省级别】
2:系统级
【参数】
node-id:IVR根节点号,取值范围为1~256。
【描述】
ivr-root命令用来配置IVR实体的根节点,即IVR执行的第一个节点。 undo ivr-root命令用来取消IVR实体的根节点。
缺省情况下,没有配置实体根节点。
【举例】
# 配置IVR实体的根节点。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 100 ivr
[Sysname-voice-dial-entity100] ivr-root 1
【命令】
ivr-system
【视图】
语音视图
【缺省级别】
2:系统级
【参数】
无
【描述】
ivr-system命令用来进入IVR管理视图。
【举例】
# 进入IVR管理视图。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr]
【命令】
ivr-timeout { expires seconds | media-play media-id [ play-times ] | repeat repeat-times } *
undo ivr-timeout
【视图】
IVR管理视图
【缺省级别】
2:系统级
【参数】
expires seconds:超时时间,取值范围为1~255,单位为秒,缺省值为10秒。
media-play media-id:配置超时后重新执行当前节点前播放的提示音的媒体资源ID,取值范围为0~2147483647。
play-times:播放提示音的次数,取值范围为1~255,缺省值为1次。
repeat repeat-times:允许的超时次数,每次超时将重新执行该节点的功能,当超时次数超过设定的值后将结束呼叫。取值范围为0~255,缺省值为3次。
【描述】
ivr-timeout命令用来配置全局IVR输入超时的处理策略。undo ivr-timeout命令用来恢复缺省情况。
缺省情况下,超时时间为10秒,超时次数为3次,无放音,达到超时次数后结束呼叫。
【举例】
# 配置IVR的全局等待用户输入超时处理策略:超时时间为20秒,媒体资源ID为100001,播放超时提示音1次,允许超时2次。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] ivr-timeout expires 20 media-play 100001 1 repeat 2
【命令】
media-file { g711alaw | g711ulaw | g723r53 | g729r8 }
【视图】
IVR管理视图
【缺省级别】
2:系统级
【参数】
g711alaw:进入g711alaw编码类型视图。
g711ulaw:进入g711ulaw编码类型视图。
g723r53:进入g723r53编码类型视图。
g729r8:进入g729r8编码类型视图。
【描述】
media-file命令用来进入语音媒体资源管理视图。
相关配置可参考命令ivr-system和set-media。
【举例】
# 进入编码类型为g729r8的媒体资源管理视图。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] media-file g729r8
[Sysname-voice-ivr-g729r8]
【命令】
media-play media-id [ play-times ] [ force ]
undo media-play
【视图】
Jump/Call节点视图
【缺省级别】
2:系统级
【参数】
media-id:表示媒体资源ID,取值范围为0~2147483647。
play-times:重复播放次数,取值范围为1~255,缺省值为1。
force:表示进入节点后,播放提示音结束后用户按键才有效。缺省为不强制,即表示在提示音播放过程中用户按键有效。
【描述】
media-play命令用来配置节点下等待用户按键播放的提示音。undo media-play命令用来恢复缺省情况。
缺省情况下,没有配置等待用户按键播放的提示音。
【举例】
# 配置节点下的等待用户按键提示音。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 jump
[Sysname-voice-ivr-node1] media-play 10000 3 force
【命令】
node node-id { call | jump | service }
undo node { node-id | all }
【视图】
IVR管理视图
【缺省级别】
2:系统级
【参数】
node-id:表示一个节点号,取值范围为1~256。
call:表示配置二次呼叫的节点。
jump:表示配置按键选择跳转的节点。
service:表示配置放音、跳转、立即二次呼叫、结束呼叫或播放提示音的节点。
all:所有类型的节点。
【描述】
node命令用来创建并进入一个IVR实体节点或者进入一个已存在的IVR实体节点。undo node命令用来删除IVR实体节点。
【举例】
# 创建Jump节点。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 jump
[Sysname-voice-ivr-node1]
【命令】
operation number { call-immediate call-number | end-call | goto-node node-id | goto-pre-node | media-play media-id [ play-times ] }
undo operation number
【视图】
Service节点视图
【缺省级别】
2:系统级
【参数】
number:执行配置的顺序,取值范围为1~3。
call-immediate call-number:立即二次呼叫,call-number为立即二次呼叫的电话号码。
end-call:结束呼叫。
goto-node node-id:跳到指定节点,取值范围为1~256。
goto-pre-node:返回上级节点。
media-play media-id:配置播放提示音的媒体资源ID,取值范围为0~2147483647。
play-times:播放提示音的次数,取值范围为1~255,缺省值为1次。
【描述】
operation命令用来配置节点操作功能。undo operation命令用来取消已有配置。
缺省情况下,没有配置任何节点的操作功能。
当某项执行功能为跳转到其他节点,或挂机操作时,将不再执行剩下未执行的功能项。
相关配置可参考命令select-rule operation-order。
【举例】
# 配置Service节点下的功能。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 service
[Sysname-voice-ivr-node1] operation 1 end-call
【命令】
select-rule operation-order 1st-operation 2nd-operation 3rd-operation
undo select-rule operation-order
【视图】
Service节点视图
【缺省级别】
2:系统级
【参数】
1st-operation:第一个执行的操作功能号,取值范围为1~3。
2nd-operation:第二个执行的操作功能号,取值范围为1~3,此参数不能同1st-operation重复。
3rd-operation:第三个执行的操作功能号,取值范围为1~3,此参数不能同1st-operation,2nd-operation重复。
【描述】
select-rule operation-order命令用来配置功能执行顺序。undo select-rule operation-order命令用来恢复缺省情况。
缺省情况下,功能执行顺序为select-rule operation-order 1 2 3。
相关配置可参考命令operation。
【举例】
# 配置节点下的功能执行顺序为1,3,2。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 service
[Sysname-voice-ivr-node1] select-rule operation-order 1 3 2
【命令】
set-media media-id { file filename | moh-interface interface-number }
undo set-media { media-id | all }
【视图】
语音媒体资源管理视图
【缺省级别】
2:系统级
【参数】
media-id:表示一个媒体资源ID,取值范围为1000~2147483647。
file filename:媒体资源文件名,可以包含空格(必须将文件名用双引号括起来),字符串长度最大为136个字节不包括双引号。
moh-interface interface-number:媒体资源对应的MOH音频输入端口号。
all:所有媒体资源ID。
【描述】
set-media命令用来配置某个媒体资源ID与媒体资源文件或MOH音频输入端口的对应关系,每种编码模式最多可以配置256个媒体资源ID。undo set-media命令用来删除已配置的对应关系。
缺省情况下,没有配置任何媒体资源ID。
相关配置可参考命令media-file。
【举例】
# 配置资源ID 10001与媒体资源文件cfa0:/g729/ring.wav的对应关系。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] media-file g729r8
[Sysname-voice-ivr-g729r8] set-media 10001 file cfa0:/g729/ring.wav
【命令】
timeout { end-call | goto-pre-node | goto-node node-id } [ expires seconds | media-play media-id [ play-times ] | repeat repeat-times ] *
undo timeout
【视图】
Jump/Call节点视图
【缺省级别】
2:系统级
【参数】
end-call:结束呼叫。
goto-pre-node:返回上级节点。
goto-node node-id:跳到指定的节点,取值范围为1~256。
expires seconds:超时的时间长度,取值范围为1~255,单位为秒,缺省为10秒。
media-play media-id:配置超时后重新执行当前节点前播放的提示音的媒体资源ID,取值范围为0~2147483647。
play-times:配置播放提示音的次数,取值范围为1~255,缺省为1次。
repeat repeat-times:配置允许的重复超时次数,每次超时将重新执行该节点的功能,当超时次数到达设定的值后按配置的处理方式进行处理,取值范围为0~255,缺省为3次。
【描述】
timeout命令用来配置IVR实体下等待用户输入超时的处理策略。undo timeout命令用来取消IVR实体下等待用户输入超时的处理策略。
缺省情况下,没有设置节点下输入超时的处理策略。
【举例】
# 配置节点下等待用户输入超时处理策略为结束呼叫,重复超时数为3次。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 jump
[Sysname-voice-ivr-node1] timeout end-call repeat 3
【命令】
user-input character { end-call | goto-node node-id | goto-pre-node }
undo user-input character
【视图】
Jump节点视图
【缺省级别】
2:系统级
【参数】
character:用户输入的按键信息,取值范围为0~9、*、#。
end-call:表示结束呼叫。
goto-node node-id:表示跳到指定的节点,取值范围为1~256。
goto-pre-node:表示返回上级节点。
【描述】
user-input命令用来配置根据具体输入执行跳转操作。undo user-input命令用来取消已有配置。
缺省情况下,没有配置跳转操作。
在一个Jump节点下最多可以配置12个这样的命令。
【举例】
# 配置用户按0结束呼叫。
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] ivr-system
[Sysname-voice-ivr] node 1 jump
[Sysname-voice-ivr-node1] user-input 0 end-call
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!