ルートの実行とトラブルシューティング

ルート実行

ルート内の呼び出し先への呼び出しは、そこに正常に接続できるようになるまで、または呼び出し先リストの末尾に達するまで、優先度と重みに基づいて順番に試行されます。

ルートの実行は、エラー条件とタイムアウトに基づいて、ある呼び出し先から次の呼び出し先に進みます。

SIPトランクの呼び出し先 [#sip-trunk-destinations-route-execution]

次の表は、UDPとTLS両方のSIPトランクでルートの進行がどのように処理されるかをまとめたものです。

SIPトランクの呼び出し先がAdministrative Downステータスの場合、または使用停止中と見なされる場合 (トランクがSIP OPTIONSを使用するように設定され、SIP OPTIONSのポーリングによってトランクが使用停止中であると判断された場合)は、直ちにスキップされます。

呼び出し先のタイムアウト [#destination-timeouts-route-execution]

呼び出し先をSIPトランク、PHONE番号、または WebRTCユーザーに設定する場合、その呼び出し先でのタイムアウトを定義できます。このパラメーターは、到達可能な呼び出し先に対してのみ作動するため、タイムアウトを接続タイムアウト ではなく、応答タイムアウト として理解する必要があります。

例として、タイムアウトが15秒に設定されたSIPトランクの呼び出し先について考えてみます：

• トランクに到達できない場合(詳細はSIP トランクの呼び出し先 と題したセクションを参照)、タイムアウトは効果がなく、ルートが実行され、優先度と重みに基づいて次の呼び出し先に進みます。
• トランクに到達でき、SIP INVITEに応答する場合、コールに応答しない場合、ルートの実行は15秒後に進みます。

SIP REFERによる再ルーティング [#rerouting-with-sip-refer-route-execution]

コールルーティングは、SIP REFER メソッドを使用したアクティブな接続コールの動的再ルーティングをサポートします。この機能は、最初の発信者を切断せずに新しい呼び出し先にコールを転送する必要がある場合に便利です。

典型的なフローは次のとおりです：

• NTT CPaaS番号 (パーティA) でインバウンドコールが受信され、コールルーティングで事前定義されたルートがトリガーされます。
• ルートは、ルートの宛先リスト(パーティ B)で指定された SIP トランクを介して、着信コールを発信コールにブリッジします。
• 通話中の任意の時点で、セッションを終了する代わりに、リモートSIPユーザー エージェント (パーティB) は、新しい呼び出し先 (パーティC) を指定して、NTT CPaaSへのSIP REFERのリクエストを開始することができます。
• コールルーティングは、元のインバウンドコールを維持し、新しくリクエストされた呼び出し先 (パーティC) にシームレスにブリッジして、通信が中断されないようにします。

この再ルーティング機能は、元のコールレッグをアクティブに保ちながら、発信者を別の部門、エージェント、または外線番号に転送するなど、柔軟なコール処理シナリオへの対応を可能にします。

コール ルーティングは、SIP REFER メッセージを受信すると、基準タイプがSIPに設定されたフィルタを持つルートのみを考慮します。このフィルタで指定された「宛先」値は、SIP REFER で要求された新しい宛先と一致する必要があります。

(任意) フィルター定義に特定のSIPトランクIDを設定して、実行ロジックをさらに絞り込むことができます。

Route Simulator (ルートシミュレーター) [#route-simulator]

コールルーティングのRoute Simulator (ルートシミュレーター) 機能を使用すると、どのルートが選択されて実行されるかを、ライブトラフィックを送信せずにテストできます。

ルートシミュレーター機能を使用すると、次の種類のインバウンドトラフィックのシミュレーションが可能になります：

• 電話
• SIP
• WEBRTC

シミュレーションの対象になる各トラフィックタイプには、fromおよびto値、ヘッダー、カスタムデータ値などの追加の適格データを含めることができます。また、無効なルートをシミュレーションに含めることも選択できるため、ライブトラフィックに影響を与えずにルート設定をテストできます。

ルートシミュレーターは、 WebインターフェイスならびにAPI を通じて使用できます。

NTT CPaaSのWebインターフェイスを通じて使用するルートシミュレーターの活用法：

1. コールルーティングのアプリケーションのメイン画面に移動します。
2. **Simulate Route (ルートのシミュレーション)**を選択します。
3. シミュレーションの対象にしたいトラフィックのタイプを選択します。

APIを通じて使用するルートシミュレーターの活用法：

API を使用してルート選択をシミュレートするには：

1. Simulate Route Selection (ルート選択シミュレーション) エンドポイントに POSTリクエストを送信します。
2. リクエスト本文に、次のような項目を含むインバウンドトラフィックの詳細を指定します：
   • endpoint.type (PHONE、SIPまたはWEBRTC)。
   • from と to の値 (該当する場合)。
   • SIPトランク情報とカスタムヘッダー (SIPシミュレーション用)。
   • useDisabledRoutes を使用して、無効なルートも評価対象に含めます。

シミュレーターは、実際のインバウンドコールであるかのようにリクエストを処理し、次のことを行います：

• 一致するすべてのルートを評価します。
• 選択するルートを決定します。
• 一致した基準と呼び出し先のリストを実行順に返します。

コールログの取得 [#retrieving-call-logs-route-execution]

コールログは、コールルーティングによって処理されたすべてのコールレッグに対して作成されます。

• インバウンドコールレッグ。
• コールルーティングがブリッジを試みる各アウトバウンドコールレッグ (呼び出し先が無効状態のSIPトランクの場合を除く)。

正常にブリッジされたコールレッグのログエントリーは、共通の同一 相関識別子 によって照合することができます。

詳細レポートの取得 [#retrieving-detailed-reports-route-execution]

コールルーティングの詳細レポートを取得するには、次の手順に従います：

1. アカウントにログインします。
2. Analyze (アナライズ) > Reports (レポート) に移動します。

方向、期間、請求期間、通話の費用など、通話に関するすべての詳細を含む新しい詳細レポートをリクエストします。詳細なレポートには、SIP トランク名、SIP トランク ID、相関識別子、およびdialogIdも含まれます。

ダウンロードしたら、CALL_ROUTINGのFeature (機能) 列をフィルタリングします。

NTT CPaaS レポートの使用方法の詳細については、Analyze Reports (レポートの分析) セクションをご参照ください。

コールルーティングのレコーディングへのアクセス

コールルーティングによって実行されるレコーディングには、APIまたはNTT CPaaSのWebインターフェイスからアクセスできます。

NTT CPaaSのWebインターフェイスからコールルーティングのレコーディングを検索してダウンロードするには：

1. Voice チャネルアプリケーション内の[Recording (レコーディング)]タブに移動します。
2. サブナビゲーションバーで Call Routing (コールルーティング) を選択します。
3. レコーディングエントリーを展開し、関連ファイル (結合または非結合) のリストを確認します。
4. 当社のクラウドストレージから利用可能なファイルならびに関連のメタデータJSONファイルをダウンロードします。

コールルーティングのレコーディングは、ルート、参加者タイプまたはID (ユーザー名や電話番号など) で検索できます。