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

ルート実行

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

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

メモ

新しく追加または変更されたルートが有効になり、その定義がシステムキャッシュに伝播されるまでに最大 5 分かかる場合があります。

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

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

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

トランスポートの種類	エンドユーザーの状態	SIP OPTIONSが有効	再ルーティング遅延	トランクがサービス停止状態にあると見なす期間
UDP	SIPトランクが到達可能	偽	N/A	N/A
UDP	SIPトランクが到達不能	偽	コールごとに4秒	一度もない
UDP	SIPトランクが到達不能	真	コールごとに4秒	最短：32秒 (SIPタイマー) 最長：32秒 + SIP OPTIONSのping間隔 (60秒)
UDP	SIPトランクが到達不能	真	0秒	N/A
TLS	SIPトランクが到達不能	偽	N/A	N/A
TLS	SIPトランクが到達不能	偽	コールごとに4秒	一度もない
TLS	SIPトランクが到達不能	真	コールごとに4秒	最短：28秒 (TCPタイマー) 最長：28秒 + ping間隔 (30秒) のSA構成
TLS	SIPトランクが到達不能	真	0秒	N/A

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

宛先を SIP トランク、PHONE 番号、または WebRTC ユーザーに設定する場合、その宛先のタイムアウトを定義できます。このパラメータは、到達可能な宛先にのみ適用され、接続タイムアウトではなく応答タイムアウトとして機能します。

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

トランクに到達できない場合( SIP trunk destinations を参照)、タイムアウトは効果がなく、ルート実行は優先度と重みに基づいて次の宛先に進みます。
トランクに到達して 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のリクエストは、パーティBから発信され、パーティBがSIPトランキングを介して接続されている場合にのみ受け入れられ、処理されます。
パーティBがSIP REFERを開始してコールをパーティCに転送すると、パーティCが接続された後も、パーティBのコールレッグはアクティブなままになります。必要に応じて、お使いのSIPユーザーエージェントがパーティBのコールレッグを終了するようにしたい場合は、お客様の責任でそのように設定してください。
パーティCがコールを拒否するか、到達できない場合、すべてのコールレッグ(A、B、C) は終了し、元のパーティAとパーティBは接続されたままになりません。

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

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

ルートに 乗り継ぎ専用ルート としてフラグを立てることができます。これにより、フィルター基準に一致する着信 SIP REFER でのみルートがアクティブ化され、SIP INVITE メッセージがフィルター基準(SIP トランク ID、宛先/送信元、またはヘッダー値)に一致する場合でも、SIP INVITE メッセージではアクティブ化されません。

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

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

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

電話
SIP
WEBRTC

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

メモ

ルートを追加または変更すると、シミュレーションで変更が有効になるまでに最大5分かかる場合があります。

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

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

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

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

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

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

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

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

通話履歴の取得 [#retrieving-call-logs-route-execution]

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

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

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

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

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

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

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

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

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

コールルーティングの録音にアクセスする

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

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

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

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