Logo
Logo
CTRLK

共有コンポーネント

インバウンド トラフィック ルートの選択

インバウンドトラフィック用のルート選択

コールルーティングは、インバウンドトラフィックに適用するルートを次の2つの方法のいずれかで決定します。

  1. 静的ダイヤルイン方式 (DID) ルート選択: コールルーティングは、指定されたNTT CPaaSのDID番号のインバウンドトラフィックに常に同じ指定ルートを適用します。
  2. フィルターベースのルート選択: コールルーティングは、フィルター基準に基づいてインバウンドトラフィックに適用されるルートを選択します。

静的DIDルート選択 [#static-did-route-selection-inbound-traffic-route-selection]

ルートは、NTT CPaaS DIDルートに静的に割り当てられます。このDIDに到達するすべてのコールには、常に同じ指定ルートが選択されます。

サポートされているDIDまたは番号の種類は次のとおりです:

  • 音声対応の NTT CPaaS VLN または TFN。
  • WhatsApp Business Calling機能が有効になっているWhatsApp送信者。
  • Viberの音声番号。

この構成は、 Webインターフェイスまたは音声番号セットアップAPI を使って完了できます。

Web インターフェイスを使用して DID を設定するには:

  1. アカウントにログインします。
  2. Channels and Numbers (チャネルと番号) > Channels (チャネル) > Voice and WebRTC (VoiceとWebRTC) に移動します。
  3. 取得した音声番号のいずれかを選択すると、新しいタブでその番号の音声構成設定が開きます。

インバウンド構成を次のように編集します

  • アクションタイプForward to Call Routingを選択します。
  • ドロップダウンリストから、この番号に割り当てるルートを選択します。

API 経由のインバウンドコールのルーティングアクションをセットアップするには、下記のAPIメソッドに使用します:

  • 購入した番号のnumberKeyを取得します。 これは リストの一覧表示メソッドを使ってアクセスする参照先から取得できます。
手記

NUMBERタイプのリソースを一覧表示し、その表示結果からnumberKeyを取得する必要があります。

  • 以下を指定して、音声セットアップを作成します:
    • 取得した numberKey
    • アクションタイプFORWARD_TO_CALL_ROUTING
    • この番号に割り当てたいルートのrouteId
手記

APIメソッドは、Viberの音声番号やWhatsApp Business Calling機能が有効になっている送信者には対応していません。

フィルタベースのルート選択 [#filter-based-route-selection-inbound-traffic-route-selection]

フィルターを使用すると、定義された基準と合致するコールのみを評価することで、ルートの細分化をさらに進めることができます。フィルター基準は、ルート作成時に任意で定義できます。

特定のフィルターを使用することで、様々な種類のインバウンドトラフィックを管理できます。同じルートに複数のフィルターを定義すると、それらは論理的なOR 演算によって連結され、フィルター基準のいずれかが満たされれば、そのルートがトリガーされます。

PHONEフィルター

フィルターは、 from または to 番号のいずれか、または両方を使って指定できます。fromto 番号の両方が指定されている場合、それらは論理AND演算を使って結合されます。

fromto番号の両方に指定する値は、完全に定義された数値または正規表現にすることができます。例えば:

  • from 値が 13124567890PHONE フィルターを持つルートは、この正確な番号からコールを受信した場合にのみトリガーされます。
  • from 値が ^1(312|773|872)\d{5}90$PHONE フィルターを持つルートは、シカゴのプレフィックスを持ち、数字90で終わる米国の番号からのインバウンドコールに対してのみトリガーされます。

コールルーティングでフィルターを使用する場合、NTT CPaaS DIDに特定のルートを割り当てる必要がなくなりました。番号に Forward to Call Routing (コールルーティングへの転送) アクションを割り当てると、システムはすべてのルートの呼び出し先を評価します。一致するフィルターを持つ最初のルートがトリガーされます。

たとえば、NTT CPaaS 番号13124567890があるとします。シカゴの市外局番 (312773、および 872) からのコールを 1 つの宛先にルーティングし、ネイパービルの市外局番 (630) からのコールを別の宛先にルーティングします。その方法は次のとおりです。

  1. From フィルター ^1(312|773|872).* を使ってルートを作成し、そのルート内で目的の呼び出し先を設定します。
  2. From フィルター ^1(630).* を使って2つ目のルートを作成し、そのルート内で目的の呼び出し先を設定します。
  3. ルートを指定せずに、Forward to Call Routing (コールルーティングへの転送)13124567890 に割り当てます。

着信コールが到着すると、コール ルーティングは発信者の番号に一致する最初のルート フィルタを自動的に適用します。

次の表は、正規表現を使用したPHONEフィルター定義の例を幾つか示しています。

目的正規表現正規表現の説明
英国の番号から着信するすべてのコールに対してルートをトリガーさせたい。from番号に次の正規表現を設定します:^44\d{10}$
  • ^:行頭の位置を表します。
  • 44:文字列44と文字通り一致します。
  • \d:桁と一致します ([0-9]と同等)。
  • $:行末の位置を表します。
シカゴの発信者からのインバウンドコールに対してこのルートをトリガーしたい場合from番号に次の正規表現を設定します:^1(312|773|872)\d{7}$
  • ^:行頭の位置を表します。
  • 1:数字の1と文字通り一致します。
  • 第1キャプチャー群 (312|773|872):
    • 第1代替数字312:文字通り312と一致します。
    • 第2代替数字773:文字通り773と一致します。
    • 第3代替数字872:文字通り872と一致します。
  • \d:桁と一致します ([0-9]と同等)。
  • {7}:前のトークンと完全に7回一致します。
  • $:行末の位置を表します。
NTT CPaaSを通じて登録した米国のフリーダイヤル番号に着信するインバウンドコールに対して、このルートをトリガーしたい場合to番号に次の正規表現を設定します:^1(800|888|877|866|855|844|833)\d{7}$上記と同じ構造の説明をここでも用います。
このルートを、どこから発信されたかを問わず、番号シーケンス"1234"を含むすべてのインバウンドコールに対してトリガーしたい場合from番号に次の正規表現を設定します:^\d*1234\d*$
  • ^:行頭の位置を表します。
  • \d*:シーケンス"1234"より前の任意の桁数 (0の桁を含む) と一致します。
  • 1234:特定のシーケンス"1234"と一致します。
  • \d*:シーケンス"1234"より後の任意の桁数 (0の桁を含む) と一致します。
  • $:一致を文字列の末尾に固定します。

SIPフィルター

このフィルターを使えば、インバウンドのSession Initiation Protocol (SIP)トラフィックに基づいてルートをアクティブ化できます。SIPフィルターは、以下に基づいて定義できます:

  • トラフィックの発信元のトランクの参照:指定されたトランクから発信したすべてのトラフィックで、この正確なルートをトリガーする必要があります。特定のSIPトランクが指定されていない場合、アクティブなSIPトランクからのインバウンドSIPトラフィックに対してフィルターが有効になります。
  • fromフィールドの値。
  • toフィールドの値。
  • 指定されたカスタムヘッダーの値。
手記

ヘッダー名は完全に指定する必要があり、ヘッダー値には正規表現を含めることができます。

次の表は、正規表現を使用したSIPフィルターの例を示しています:

正規表現

目的

正規表現の説明

To / From フィルター基準

上記の電話フィルターの例と同様です。

NOTE

これらの値の一部は、特定の ユーザー名 (例えば、oliverjones のような文字列) など、数値ではありません。

Header value - ヘッダー X-IB-AGENTCONTEXT に sales が含まれている場合に、このルートをアクティブにしたいとします。その場合:ヘッダー値フィルターを .*sales.* に設定します。
  • .*:部分文字列 sales の前のいずれかの文字と幾つか (なしを含む) 一致します。
  • sales:部分文字列 sales と完全に一致します。
  • .*:部分文字列 sales の後のいずれかの文字と幾つか (なしを含む) 一致します。
Header value - ヘッダー X-IB-WHATEVERxyz で始まり 001 で終わる場合、このルートをアクティブにしたいとします。その場合:ヘッダー値を ^xyz.*001$ に設定します。
  • ^:一致範囲の始まりを文字列の先頭に固定します。
  • xyz:先頭の部分文字列 xyz と完全に一致します。
  • .*:その間のいずれかの文字と幾つか (なしを含む) 一致します。
  • 001:末尾の部分文字列 001 と完全に一致します。
  • $:一致範囲の終わりを文字列の末尾に固定します。

WEBRTCフィルター

このフィルターは、Web リアルタイム通信 (WebRTC) から発信されたトラフィックのルート実行をトリガーします。WebRTC クライアント アプリケーションでは、CALL_ROUTING アプリケーションに対して applicationCall を行う必要があります。オプションで、from パラメーター ( コール ルーティング API を使用している場合は identity) に値 (完全表現または正規表現) を設定でき、ルートはその特定の WebRTC ID からの呼び出しに対してのみトリガーされます。

大事な

ルート優先度の影響

複数のルートにインバウンドトラフィックと合致するフィルターがある場合、コールルーティングは優先度番号が最も小さいルートを選択します (1 が選択優先度が高い)。