インバウンド トラフィック ルートの選択
インバウンドトラフィック用のルート選択
コールルーティングは、インバウンドトラフィックに適用するルートを次の2つの方法のいずれかで決定します。
- 静的ダイヤルイン方式 (DID) ルート選択: コールルーティングは、指定されたNTT CPaaSのDID番号のインバウンドトラフィックに常に同じ指定ルートを適用します。
- フィルターベースのルート選択: コールルーティングは、フィルター基準に基づいてインバウンドトラフィックに適用されるルートを選択します。
静的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 を設定するには:
- アカウントにログインします。
- Channels and Numbers (チャネルと番号) > Channels (チャネル) > Voice and WebRTC (VoiceとWebRTC) に移動します。
- 取得した音声番号のいずれかを選択すると、新しいタブでその番号の音声構成設定が開きます。
インバウンド構成を次のように編集します:
- アクションタイプ
ForwardtoCall 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 番号のいずれか、または両方を使って指定できます。fromとto 番号の両方が指定されている場合、それらは論理AND演算を使って結合されます。
from と to番号の両方に指定する値は、完全に定義された数値または正規表現にすることができます。例えば:
from値が13124567890のPHONEフィルターを持つルートは、この正確な番号からコールを受信した場合にのみトリガーされます。from値が^1(312|773|872)\d{5}90$のPHONEフィルターを持つルートは、シカゴのプレフィックスを持ち、数字90で終わる米国の番号からのインバウンドコールに対してのみトリガーされます。
コールルーティングでフィルターを使用する場合、NTT CPaaS DIDに特定のルートを割り当てる必要がなくなりました。番号に Forward to Call Routing (コールルーティングへの転送) アクションを割り当てると、システムはすべてのルートの呼び出し先を評価します。一致するフィルターを持つ最初のルートがトリガーされます。
たとえば、NTT CPaaS 番号13124567890があるとします。シカゴの市外局番 (312、773、および 872) からのコールを 1 つの宛先にルーティングし、ネイパービルの市外局番 (630) からのコールを別の宛先にルーティングします。その方法は次のとおりです。
Fromフィルター^1(312|773|872).*を使ってルートを作成し、そのルート内で目的の呼び出し先を設定します。Fromフィルター^1(630).*を使って2つ目のルートを作成し、そのルート内で目的の呼び出し先を設定します。- ルートを指定せずに、Forward to Call Routing (コールルーティングへの転送) を
13124567890に割り当てます。
着信コールが到着すると、コール ルーティングは発信者の番号に一致する最初のルート フィルタを自動的に適用します。
次の表は、正規表現を使用したPHONEフィルター定義の例を幾つか示しています。
| 目的 | 正規表現 | 正規表現の説明 |
|---|---|---|
| 英国の番号から着信するすべてのコールに対してルートをトリガーさせたい。 | from番号に次の正規表現を設定します:^44\d{10}$ |
|
| シカゴの発信者からのインバウンドコールに対してこのルートをトリガーしたい場合 | from番号に次の正規表現を設定します:^1(312|773|872)\d{7}$ |
|
| NTT CPaaSを通じて登録した米国のフリーダイヤル番号に着信するインバウンドコールに対して、このルートをトリガーしたい場合 | to番号に次の正規表現を設定します:^1(800|888|877|866|855|844|833)\d{7}$ | 上記と同じ構造の説明をここでも用います。 |
| このルートを、どこから発信されたかを問わず、番号シーケンス"1234"を含むすべてのインバウンドコールに対してトリガーしたい場合 | from番号に次の正規表現を設定します:^\d*1234\d*$ |
|
SIPフィルター
このフィルターを使えば、インバウンドのSession Initiation Protocol (SIP)トラフィックに基づいてルートをアクティブ化できます。SIPフィルターは、以下に基づいて定義できます:
- トラフィックの発信元のトランクの参照:指定されたトランクから発信したすべてのトラフィックで、この正確なルートをトリガーする必要があります。特定のSIPトランクが指定されていない場合、アクティブなSIPトランクからのインバウンドSIPトラフィックに対してフィルターが有効になります。
fromフィールドの値。toフィールドの値。- 指定されたカスタムヘッダーの値。
ヘッダー名は完全に指定する必要があり、ヘッダー値には正規表現を含めることができます。
次の表は、正規表現を使用したSIPフィルターの例を示しています:
正規表現 | 目的 | 正規表現の説明 |
|---|---|---|
To / From フィルター基準 | 上記の電話フィルターの例と同様です。 NOTE これらの値の一部は、特定の ユーザー名 (例えば、 | |
Header value - ヘッダー X-IB-AGENTCONTEXT に sales が含まれている場合に、このルートをアクティブにしたいとします。その場合: | ヘッダー値フィルターを .*sales.* に設定します。 |
|
Header value - ヘッダー X-IB-WHATEVER が xyz で始まり 001 で終わる場合、このルートをアクティブにしたいとします。その場合: | ヘッダー値を ^xyz.*001$ に設定します。 |
|
WEBRTCフィルター
このフィルターは、Web リアルタイム通信 (WebRTC) から発信されたトラフィックのルート実行をトリガーします。WebRTC クライアント アプリケーションでは、CALL_ROUTING アプリケーションに対して applicationCall を行う必要があります。オプションで、from パラメーター ( コール ルーティング API を使用している場合は identity) に値 (完全表現または正規表現) を設定でき、ルートはその特定の WebRTC ID からの呼び出しに対してのみトリガーされます。
ルート優先度の影響
複数のルートにインバウンドトラフィックと合致するフィルターがある場合、コールルーティングは優先度番号が最も小さいルートを選択します (1 が選択優先度が高い)。