SIPトランクで電話に接続する

SIPトランクを使用してエージェントの電話接続を設定し、IPネットワーク経由で音声通話をルーティングすることで、拡張性を高め、コストを削減します。

プレビュー：この機能は現在、プレビューモードでのみご利用いただけます。

SIP（Session Initiation Protocol）トランクとは、従来の電話回線の代わりにインターネットを介した音声通話を可能にする仮想接続です。 IPベースの技術を使って、電話システムを公衆電話網に接続することができる。このアプローチは、コストを削減し、拡張性を向上させ、音声通信管理を簡素化する。

SIPトランクを使用して電話音声に接続することで、音声通信のためのスケーラブルで費用対効果の高いソリューションを提供します。この方法によって、IPネットワーク上で通話を直接ルーティングすることが可能になり、通話品質が向上し、インフラ管理が簡素化されるため、ユーザーは信頼性が高く効率的な音声サービスを維持することができます。

利用可能範囲： SIPトランクを使用した電話への接続は、 IBM Cloud および AWS の環境において利用可能です。この機能は、現在オンプレミス環境ではサポートされていません。

開始前に

既存のエージェントがあるか、作成する準備ができていることを確認してください。

セットアップの概要

SIPトランクを使用してエージェントと電話を接続するには、以下の手順に従ってください：

環境の選択
SIP接続の設定
接続設定の構成
高度なセキュリティ設定
電話番号の設定

環境の選択

エージェントビルダーでエージェントを開きます。
チャンネルを選択 > SIP対応電話機
SIP電話接続を作成する環境を選択してください。 ドラフトまたはライブ。
新しい電話接続をクリックしてください。
SIPトランクを選択してください。

SIP接続の設定

SIPトランク接続を設定し、この接続を使用してエージェントを電話に接続するには、以下の手順に従います：

接続名を入力してください。
接続の使用目的を説明する説明を入力します。
次へをクリックします。

接続設定の構成

以下の詳細を収集し、サポートされているプロバイダーでSIPトランクを設定します：

SIP URIの値をサービスプロバイダーの発信設定にコピーする。
テナントIDの値をコピーし、SIPプロバイダのアプリケーションに x-tenant-id の値として貼り付けると、コールがテナントに確実にルーティングされます。

x-tenant-id 」の値はテナントごとに同じだが、設定方法は各サービスプロバイダーによって異なる場合がある。詳細については、「サービスプロバイダーのテナント ID の設定」を参照してください。
エージェントに抽出させたい SIP INVITEヘッダーを入力する。ヘッダー名をカンマ区切りで列挙する。

SIP INVITEリクエストは、エージェントが抽出し、コンテキスト変数を使用して送信できる、呼についてのメタデータをヘッダーに含むことができる。たとえば、双方向音声応答（IVR）システムは、SIPヘッダーを使用することで、着信コールの情報を渡す。これらのヘッダーのどれかを使いたい場合は、ここにヘッダー名を列挙してください。

指定されたヘッダーは、要求に含まれている場合は、SIP INVITE から自動的に抽出された他の関連メタデータとともに、コンテキスト変数 custom_invite_headers に保管されます。この変数は配列で、各キーと値のペアは、この例のようにリクエストのヘッダーを表す：
```
    "context" : {
        "channel": {
            "channel_type" : "sip",
            "sip": {
                "call_id": "Aob2-2743-5678-1234",
                "agent_phone_number":"+18885556789",
                "custom_invite_headers": {
                    "From": "ABC",
                    "To": "XYZ"
                },
                "user_phone_number":"+18595553456",
                "request_uri":"sips:+18885557777@public.voip.dl.watson-orchestrate.ibm.com",
                "from_uri":"sips:+18565558576@twilio.com",
                "to_uri":"sips:+18885557777@public.voip.dl.watson-orchestrate.ibm.com"
            }
        }
    }
```
単純なコンテキスト変数と構造化変数（カスタムヘッダー）の両方にアクセスできます。

例えば、 to_uri、 from_uri、 request_uri、 call_id のような単純な変数は、 {to_uri}、 {from_uri}、 {request_uri}、 {call_id} のようなフォーマットでアクセスできます。

SIP INVITEヘッダーのコレクション全体は、 {custom_invite_headers} の書式を使うことでアクセスできる。 X-Trace-Id のような特定のカスタムヘッダには、 {custom_invite_headers["X-Trace-Id"]} という書式でアクセスできます。
AIエージェントとの接続中に着信音を鳴らし、接続を無音にする。デフォルトでは、このオプションが選択され、発信者はAIエージェントがコンタクト中であることを示すトーンを聞く。
Clear SIPサービスプロバイダが保留状態を処理する場合、 ライブエージェントに転送中に通話者を保留状態にします。

注:
現在、通話の転送機能はご利用いただけません。
次へをクリックします。

高度なセキュリティ設定

接続にリンクされているすべてのエージェントに適用される高度なセキュリティ設定を構成します。

Secure Real-time Transport Protocol (SRTP) を使用して電話の音声を保護するには、[ 音声暗号化を有効にする ] を選択します。
認証に使用するSIPダイジェストのユーザー名とパスワードを設定するには、「 Enable SIP authentication（SIP認証を有効にする ）」を選択します。
1. SIPダイジェストユーザー名を入力します。
2. SIPダイジェストパスワードを入力します。
注:
「SIP認証を有効にする」がオンになっている場合、 TLS を使用したSIPトランク接続のみを使用する必要があります。
次へをクリックします。

電話番号の設定

電話番号を1つずつ追加するか、カンマ区切り値（ CSV ）ファイルに保存されている電話番号のセットをインポートし、それらをエージェントに割り当てます。電話番号を追加するには、以下のいずれかの方法を使用します：

CSVのアップロード
電話番号の追加

CSVのアップロード

「 CSV 」をクリックしてアップロードしてください。
電話番号のリストが含まれている CSV ファイルを選択してください。ファイルの各行には、最初の値として電話番号、2番目の値としてオプションの説明が含まれる。
「アップロード」 をクリックして、選択した CSV ファイルをアップロードしてください。

電話番号の追加

電話番号の追加をクリックします。
フィールドに電話番号と説明を入力します。

電話番号は4桁から15桁、プラス記号（+）、マイナス記号（-）、カッコ（）に対応しています。例えば、+1(555) 666-7777。
電話番号を接続するエージェントを選択します。
接続を作成する環境、 ドラフト、またはライブを選択します。
保存をクリックして電話番号を追加します。

Doneをクリックして接続を作成する。

次のタスク

電話の設定を完了するには、エージェントの音声を選択してください。詳細については、「エージェントの音声設定の構成」を参照してください。
エージェント設定ページで「 デプロイ 」をクリックしてエージェントを展開し、本番環境で電話接続を使用します。
SIP用のチャネル固有コンテキスト変数を追加するには、 SIP コンテキスト変数の手順に従ってください。