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