概要
このドキュメントでは、BroadWorks Application Server(AS)がディジットの収集とアナウンスの再生のためにMedia Server(MS)と通信する方法について説明します。
.
背景説明
アナウンスは通常、コール処理の間に使用されます。たとえば、番号の収集を求めるプロンプト(PIN番号の後ろにシャープ(#)を付けて入力)や、コールの失敗を発信者に通知する場合に使用できます(コールはダイヤルどおりに完了できません)。BroadWorksソリューションでは、Media Serverがアナウンスの再生を担当しますが、メディアファイルはApplication Serverに保存されます。アプリケーション・サーバは、再生するファイルをメディア・サーバに指示する責任があります。同様に、MSはオーディオストリームからユーザ入力を抽出できるため、ASは適切なコール処理アクションを実行できます。
アナウンスメントファイルは、ASサーバの次の場所に保存されます。/usr/local/broadworks/apps/MediaFiles_<SW_version>/sysprompts/<language code>/。たとえば、AS R24の米国英語アナウンスは、/usr/local/broadworks/apps/MediaFiles_24.0_1.944/sysprompts/enディレクトリにあります。Session Initiation Protocol(SIP)メッセージ/usr/local/broadworks/apps/MediaFiles_24.0_1.944/sysprompts/en/ロケーションはhttps://<AS_addres>/media/en/にマッピングされます。
Broadworksで利用可能なアナウンスの詳細については、『Cisco BroadWorks Announcement Guide』を参照してください。
前提条件
要件
次の項目に関する知識があることが推奨されます。
- SIPシグナリング。
- BroadWorksでの基本的な自動応答の設定。
使用するコンポーネント
このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。
- ASバージョン:R24
- MSバージョン:RI_2022.08
ただし、他のソフトウェアバージョンの動作も同様です。
このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期(デフォルト)設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。
ネットワークトポロジとコールフロー
簡単にするために、このドキュメントでは基本的なコールシナリオを使用します。
- ソフトフォンアプリケーションはASに直接登録されます。
- ユーザ(内線番号2011)がAuto Attendant(内線番号2010)にダイヤルし、数字5を押します。次のスクリーンキャプチャに示すように、このユーザ入力によってコール切断がトリガーされます。
- ユーザと自動応答が同じグループに属している。
SIPメッセージフローの説明
注:分かりやすくするため、関連するSIPメッセージのみがリストされています。
ユーザが2010をダイヤルし、ソフトフォンがASにInviteメッセージを送信します。
2023.01.26 16:51:41:106 CET | Info | Sip | Call Half Input Adapter 5 | 2966060 | +15403362011 | callhalf-58591:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 1111 SIP Bytes IN from 10.61.205.219:58300
INVITE sip:2010@mleus.lab SIP/2.0
Via: SIP/2.0/UDP 10.61.205.219:58300;rport;branch=z9hG4bKPjgINPvPUvoBT57iTOBPsgCfEqE5GX1aj7
Max-Forwards: 70
From: "Marek Leus"
;tag=6fU.VlLrWc6WI3JU8jWKS.25yeoWEhpc To: sip:2010@mleus.lab Contact: "Marek Leus"
Call-ID: dTUVBWON9UjmftpGCOoJzhLfbajBm11C CSeq: 6492 INVITE Route:
Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS Supported: replaces, 100rel, norefersub User-Agent: Telephone 1.6 Content-Type: application/sdp Content-Length: 480 v=0 o=- 3883737105 3883737105 IN IP4 10.61.205.219 s=pjmedia b=AS:117 t=0 0 a=X-nat:0 m=audio 4012 RTP/AVP 96 9 8 0 101 102 c=IN IP4 10.61.205.219 b=TIAS:96000 a=rtcp:4013 IN IP4 10.61.205.219 a=sendrecv a=rtpmap:96 opus/48000/2 a=fmtp:96 useinbandfec=1 a=rtpmap:9 G722/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:0 PCMU/8000 a=rtpmap:101 telephone-event/48000 a=fmtp:101 0-16 a=rtpmap:102 telephone-event/8000 a=fmtp:102 0-16 a=ssrc:2039250127 cname:43ec7f3b5b951d53
内線2010は自動応答に属するため、ASはコールをMSに拡張します。
2023.01.26 16:51:41:117 CET | Info | Sip | Sip EncodeQ 0 | 2966113 | +15403362010 | callhalf-58599:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 1044 SIP Bytes OUT to 10.48.93.18:5060
INVITE sip:ivr@10.48.93.18 SIP/2.0
Via:SIP/2.0/UDP 10.48.93.126;branch=z9hG4bKBroadWorks.-iom24c-10.48.93.18V5060-0-929269663-1018158145-1674748301117-
From:
;tag=1018158145-1674748301117- To:
Call-ID:BW165141117260123-861893333@10.48.93.126 CSeq:929269663 INVITE Contact:
X-BroadWorks-Correlation-Info:7492cbd3-b8a1-4c10-a543-b01f275be0b0 Allow:ACK,BYE,CANCEL,INFO,INVITE,OPTIONS,PRACK,REFER,NOTIFY Supported: Max-Forwards:10 Content-Type:application/sdp Content-Length:469 v=0 o=BroadWorks 14605 1 IN IP4 10.61.205.219 s=- b=AS:117 t=0 0 a=X-nat:0 m=audio 4012 RTP/AVP 96 9 8 0 101 102 c=IN IP4 10.61.205.219 b=TIAS:96000 a=rtcp:4013 IN IP4 10.61.205.219 a=sendrecv a=rtpmap:96 opus/48000/2 a=fmtp:96 useinbandfec=1 a=rtpmap:9 G722/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:0 PCMU/8000 a=rtpmap:101 telephone-event/48000 a=fmtp:101 0-16 a=rtpmap:102 telephone-event/8000 a=fmtp:102 0-16 a=ssrc:2039250127 cname:43ec7f3b5b951d53
MSがコールに応答します。
2023.01.26 16:51:41:128 CET | Info | SipMedia | Call Half Input Adapter 2 | 2966114 | +15403362010 | callhalf-58599:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 673 SIP Bytes IN from 10.48.93.18:5060
SIP/2.0 200 OK
Via: SIP/2.0/UDP 10.48.93.126;branch=z9hG4bKBroadWorks.-iom24c-10.48.93.18V5060-0-929269663-1018158145-1674748301117-
From:
;tag=1018158145-1674748301117- To:
;tag=213817675 Call-ID: BW165141117260123-861893333@10.48.93.126 CSeq: 929269663 INVITE Contact:
Content-Type: application/sdp Allow: INVITE, ACK, BYE, INFO, OPTIONS, CANCEL Content-Length: 205 v=0 o=BroadWks 20 0 IN IP4 10.48.93.18 s=Media Server SDP t=0 0 m=audio 10234 RTP/AVP 8 102 c=IN IP4 10.48.93.18 a=rtpmap:8 PCMA/8000 a=rtpmap:102 telephone-event/8000 a=fmtp:102 0-15 a=ptime:20
ASはソフトフォンに200 OKメッセージを拡張します。
2023.01.26 16:51:41:132 CET | Info | Sip | Sip EncodeQ 1 | 2966146 | +15403362011 | callhalf-58591:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 864 SIP Bytes OUT to 10.61.205.219:58300
SIP/2.0 200 OK
Via:SIP/2.0/UDP 10.61.205.219:58300;branch=z9hG4bKPjgINPvPUvoBT57iTOBPsgCfEqE5GX1aj7;rport
From:"Marek Leus"
;tag=6fU.VlLrWc6WI3JU8jWKS.25yeoWEhpc To:
;tag=749498253-1674748301131 Call-ID:dTUVBWON9UjmftpGCOoJzhLfbajBm11C CSeq:6492 INVITE Supported: Contact:
P-Asserted-Identity:"GroupB1 AA"
Privacy:none Call-Info:
;appearance-index=1 Allow:ACK,BYE,CANCEL,INFO,INVITE,OPTIONS,PRACK,REFER,NOTIFY,UPDATE Accept:application/media_control+xml,application/sdp,multipart/mixed Content-Type:application/sdp Content-Length:195 v=0 o=BroadWorks 14606 1 IN IP4 10.48.93.18 s=- t=0 0 m=audio 10234 RTP/AVP 8 102 c=IN IP4 10.48.93.18 a=rtpmap:8 PCMA/8000 a=rtpmap:102 telephone-event/8000 a=fmtp:102 0-15 a=ptime:20
この時点で、ソフトフォンとMSの間で直接の双方向オーディオストリームが確立されます。このコールでは、G711aコーデックと着信DTMFがネゴシエートされます。SIPシグナリングは、引き続きASによって処理されます。
ASは、デフォルトの自動応答グリーティング(AAdefaultBusinessHoursGreeting.wav)を再生し、ディジットを収集するようにMSに指示します(自動応答メニュー設定では、0 ~ 5のディジットのみ許可されます)。
2023.01.26 16:51:41:248 CET | Info | Sip | Sip EncodeQ 0 | 2966172 | +15403362010 | callhalf-58599:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 934 SIP Bytes OUT to 10.48.93.18:5060
INFO sip:10.48.93.18:5060 SIP/2.0
Via:SIP/2.0/UDP 10.48.93.126;branch=z9hG4bKBroadWorks.-iom24c-10.48.93.18V5060-0-929269664-1018158145-1674748301117-
From:
;tag=1018158145-1674748301117- To:
;tag=213817675 Call-ID:BW165141117260123-861893333@10.48.93.126 CSeq:929269664 INFO Contact:
Max-Forwards:10 Content-Type:application/mediaservercontrol+xml Content-Length:470
グリーティング中に、ユーザは数字5を押します。これはオーディオストリーム内で送信されるため、MSは音声からディジットを抽出し、情報メッセージでASに送信します。
2023.01.26 16:51:43:878 CET | Info | SipMedia | Call Half Input Adapter 2 | 2966183 | +15403362010 | callhalf-58599:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 703 SIP Bytes IN from 10.48.93.18:5060
INFO sip:10.48.93.126:5060 SIP/2.0
Via: SIP/2.0/UDP 10.48.93.18:5060;branch=z9hG4bK-BroadWorks-MS-325794538
From:
;tag=213817675 To:
;tag=1018158145-1674748301117- Call-ID: BW165141117260123-861893333@10.48.93.126 CSeq: 2037464779 INFO Content-Type: application/mediaservercontrol+xml Max-Forwards: 70 Content-Length: 305
自動応答は、数字5を受信したときにコールを切断するように設定されています。使いやすくするために、MSに「Thank you for calling」メッセージを最初に再生するように指示します。
2023.01.26 16:51:43:880 CET | Info | Sip | Sip EncodeQ 0 | 2966197 | +15403362010 | callhalf-58599:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 712 SIP Bytes OUT to 10.48.93.18:5060
INFO sip:10.48.93.18:5060 SIP/2.0
Via:SIP/2.0/UDP 10.48.93.126;branch=z9hG4bKBroadWorks.-iom24c-10.48.93.18V5060-0-929269665-1018158145-1674748301117-
From:
;tag=1018158145-1674748301117- To:
;tag=213817675 Call-ID:BW165141117260123-861893333@10.48.93.126 CSeq:929269665 INFO Contact:
Max-Forwards:10 Content-Type:application/mediaservercontrol+xml Content-Length:248
MSは、アナウンスの再生が完了したことをASに通知します。
2023.01.26 16:51:45:294 CET | Info | SipMedia | Call Half Input Adapter 2 | 2966207 | +15403362010 | callhalf-58599:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 632 SIP Bytes IN from 10.48.93.18:5060
INFO sip:10.48.93.126:5060 SIP/2.0
Via: SIP/2.0/UDP 10.48.93.18:5060;branch=z9hG4bK-BroadWorks-MS-30863660
From:
;tag=213817675 To:
;tag=1018158145-1674748301117- Call-ID: BW165141117260123-861893333@10.48.93.126 CSeq: 2037464780 INFO Content-Type: application/mediaservercontrol+xml Max-Forwards: 70 Content-Length: 235
再生が完了すると、ASは両方のコールレッグを切断します。
2023.01.26 16:51:45:296 CET | Info | Sip | Sip EncodeQ 0 | 2966228 | +15403362010 | callhalf-58599:0 |
7492cbd3-b8a1-4c10-a543-b01f275be0b0
udp 378 SIP Bytes OUT to 10.48.93.18:5060
BYE sip:10.48.93.18:5060 SIP/2.0
Via:SIP/2.0/UDP 10.48.93.126;branch=z9hG4bKBroadWorks.-iom24c-10.48.93.18V5060-0-929269666-1018158145-1674748301117-
From:
;tag=1018158145-1674748301117- To:
;tag=213817675 Call-ID:BW165141117260123-861893333@10.48.93.126 CSeq:929269666 BYE Max-Forwards:10 Content-Length:0 2023.01.26 16:51:45:297 CET | Info | Sip | Sip EncodeQ 1 | 2966238 | +15403362011 | callhalf-58591:0 | 7492cbd3-b8a1-4c10-a543-b01f275be0b0 udp 404 SIP Bytes OUT to 10.61.205.219:58300 BYE sip:5403362011@10.61.205.219:58300;ob SIP/2.0 Via:SIP/2.0/UDP 10.48.93.126;branch=z9hG4bKBroadWorks.-iom24c-10.61.205.219V58300-0-929269658-749498253-1674748301131 From:
;tag=749498253-1674748301131 To:"Marek Leus"
;tag=6fU.VlLrWc6WI3JU8jWKS.25yeoWEhpc Call-ID:dTUVBWON9UjmftpGCOoJzhLfbajBm11C CSeq:929269658 BYE Max-Forwards:10 Content-Length:0