国家 / 地区

12-语音命令参考

09-可定制IVR命令

本章节下载  (175.82 KB)

docurl=/cn/Service/Document_Software/Document_Center/Routers/Catalog/MSR/MSR_50/Command/Command_Manual/H3C_MSR_CR(V5)-R2516-V1.16/12/201807/1093976_30005_0.htm

09-可定制IVR命令


1 可定制IVR配置命令

说明

MSR800、MSR 900、MSR900-E、MSR 930、MSR 2600、MSR 30-11、MSR 30-11E、MSR 30-11F和MSR3600-51F路由器不支持语音功能。

 

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-systemset-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-operation2nd-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

 

 

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!