目  录

1 可定制IVR配置命令

1.1 可定制IVR配置命令

1.1.1 call-normal

1.1.2 description

1.1.3 dial-prefix

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.7 entity ivr

1.1.8 extension

1.1.9 input-error

1.1.10 ivr-input-error

1.1.11 ivr-root

1.1.12 ivr-system

1.1.13 ivr-timeout

1.1.14 media-file

1.1.15 media-play

1.1.16 node

1.1.17 operation

1.1.18 select-rule operation-order

1.1.19 set-media

1.1.20 timeout

1.1.21 user-input

 

1 可定制IVR配置命令

 

1.1  可定制IVR配置命令

1.1.1  call-normal

【命令】

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

1.1.2  description

【命令】

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

1.1.3  dial-prefix

【命令】

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#

1.1.4  display voice ivr call-info

【命令】

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：当前节点执行状态处于呼叫状态

 

1.1.5  display voice ivr media-play

【命令】

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地址

 

1.1.6  display voice ivr media-source

【命令】

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	此文件对应的缓冲区编号

 

1.1.7  entity ivr

【命令】

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

1.1.8  extension

【命令】

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

1.1.9  input-error

【命令】

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

1.1.10  ivr-input-error

【命令】

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

1.1.11  ivr-root

【命令】

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

1.1.12  ivr-system

【命令】

ivr-system

【视图】

语音视图

【缺省级别】

2：系统级

【参数】

无

【描述】

ivr-system命令用来进入IVR管理视图。

【举例】

# 进入IVR管理视图。

<Sysname> system-view

[Sysname] voice-setup

[Sysname-voice] ivr-system

[Sysname-voice-ivr]

1.1.13  ivr-timeout

【命令】

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

1.1.14  media-file

【命令】

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]

1.1.15  media-play

【命令】

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

1.1.16  node

【命令】

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]

1.1.17  operation

【命令】

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

1.1.18  select-rule operation-order

【命令】

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

1.1.19  set-media

【命令】

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

1.1.20  timeout

【命令】

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

1.1.21  user-input

【命令】

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