• 產品與解決方案
  • 行業解決方案
  • 服務
  • 支持
  • 合作夥伴
  • 關於我們

12-語音命令參考

目錄

09-可定製IVR命令

本章節下載 09-可定製IVR命令  (175.82 KB)

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保留在沒有任何通知或提示的情況下對資料內容進行修改的權利!

BOB登陆
官網
聯係我們