IBM Cloud Docs
電話統合構成

電話統合構成

IBM Cloud

アシスタントの電話統合をセットアップした後に、電話統合の設定を変更して通話の動作をカスタマイズできます。

通話および転送の失敗を処理

電話接続が何らかの理由で失敗した場合に、電話をかけてきた相手をオペレーターに転送するように電話統合を設定することができます。 電話をかけてきた人を自動的にオペレーターに転送するには、電話統合設定の 「詳細設定」タブに移動し、以下の設定を選択します

  • 呼び出しが失敗した場合の SIP ターゲット (SIP target when a call fails): サポート・エージェント・サービスの SIP エンドポイントを追加します。 要求を他のキューにリダイレクトできる汎用呼び出しキューを表す SIP URI または電話 URI を指定します。 詳しくは、 バックアップ・サービス・デスク・ソリューションの構成 を参照してください。

  • コール失敗メッセージ :オペレーターが電話を実際のオペレーターに転送する前に、発信者に伝えるメッセージを追加します。

人間に電話を転送した後、何らかの理由でオペレーターとの接続に失敗した場合に、どうするかを設定することができます。

  • 転送失敗メッセージ :オペレーターへの転送に失敗した場合に、アシスタントが発信者に伝えるメッセージを入力します。 メッセージは最大150文字までです。

  • 転送失敗時に通話を切る (Disconnect call on transfer failure): 失敗メッセージの後に通話を切るかどうかを選択します。 デフォルトでは、このオプションは有効です。 このオプションが無効になっている場合に、通話転送が失敗すると、アシスタントは通話を切ったり別のアクションを処理したりできます。

    転送が失敗しても通話を接続したままにすることを選択した場合、 watsonx Assistant は次のステップを決定するために新しいターンを開始します。 このシナリオを処理できるアクションまたは Webhook を使用して Assistant を構成することが重要です。

電話統合は、サービス障害が発生したときにライブ・エージェントに通話を転送するのではなく別のリージョンに高速でフェイルオーバーできるようにすることで、災害復旧をサポートします。 これは、通話のセットアップ時に障害が発生した場合に通話をライブ・エージェントに自動的に差し向けるのではなく、SIP 503 応答をアップストリーム SIP トランキング・プロバイダーに送信することによって、実現されます。 この 503 応答は、SIP トランキング・プロバイダーが通話を別のリージョンに転送するために使用できます。 この機能を使用する場合は、災害復旧を必要とする watsonx Assistant サービス・インスタンスに対してサービス・チケットをオープンします。

電話接続の保護

電話接続にセキュリティーを追加するには、電話統合設定の**「拡張オプション」**タブに移動し、以下のオプションの一方または両方を選択します。

  • セキュア・トランキングの強制: このオプションは、Secure Real-Time Transfer Protocol (SRTP) を使用して、電話で送信される音声を保護する場合に選択します。 RTP について詳しくは、呼び出しルーティングの詳細を参照してください。

  • SIP 認証を有効にする: SIP ダイジェスト認証を要求する場合は、このオプションを選択します。

    SIP 認証が必要な場合、すべてのインバウンド・トラフィック (SIP プロバイダーからアシスタントへの要求を意味します) は SIP ダイジェスト認証を使用して認証され、Transport Layer Security (TLS) を使用して送信する必要があります。 このオプションを選択する場合は、SIP ダイジェストのユーザー名とパスワードを構成する必要があります。また、アシスタントへの接続に使用する SIP トランクは、TLS のみを使用するように構成する必要があります。

    Twilio を SIP トランクプロバイダとして使用している場合、 watsonx Assistant への発信用SIPトランクでSIP認証を有効にすることはできません。

拡張 SIP トランク構成設定の適用

アシスタントが外部プロバイダーから SIP トランクと対話する仕組みを構成するには、電話統合設定の**「SIP トランク (SIP trunk)」タブに移動し、「SIP トランキング統合 (SIP trunking integration)」**セクションにおいて以下のオプションを更新します。

  • 抽出する SIP INVITE ヘッダー (SIP INVITE headers to extract): アシスタントで使用するヘッダーをリストします。

    SIP INVITE 要求には、抽出してコンテキスト変数でアシスタントに送信できる通話に関するメタデータをヘッダーで組み込めます。 例えば、多くの企業は、SIP ヘッダーを使用することによって着信呼び出しについての情報を渡す対話式音声応答 (IVR) システムを使用しています。 それらのヘッダーを使用する場合は、ヘッダー名のリストをここに入力してください。

    指定されたヘッダーは、要求に含まれている場合は、SIP INVITE から自動的に抽出された他の関連メタデータとともに、コンテキスト変数 sip_custom_invite_headers に保管されます。 この変数は、以下の例のように、各キー/値のペアが要求からのヘッダーを表す配列です。

    {
      "input": {
        "text": "",
          ...
      },
      "context" : {
        "global" : {...},
        "skills" : {...},
        "integrations" : {
          "voice_telephony": {
            "private":{
              "user_phone_number":"+18594213456",
            },  
            "sip_call_id": "Aob2-2743-5678-1234",
            "assistant_phone_number":"+18882346789",
            "sip_custom_invite_headers": {
              "X-customer-name": "my_name",
              "X-account-number": "12345"
            }
          }
        }
      }
    }
    

    その結果、アシスタントで当該ヘッダーを参照できます。 例えば、ステップ条件のヘッダー値を確認すれば、次のステップを決定できます。 当該ヘッダーは、アシスタント・ログ内を検索するときにも使用できます。例えば、カスタム・ヘッダーを検索して、特定アカウントに関連付けられているメッセージをすべて見つけることができます。

  • アシスタントに連絡している間、発信者に聞こえる呼び出し音を無効にする: アシスタントに連絡中であることを示す信号を発信者に聞かせるかどうかを選択します。

    着信した呼び出しの招待をアシスタントで処理しているときには、180 Ringing 応答がアシスタントから SIP トランク・プロバイダーに送信して返されます。 デフォルトでは、Ringing 応答が送信されます。

  • ライブ・エージェントへの転送中に発信者を保留にしない (Don't place callers on hold while transferring to a live agent): 電話統合で発信者を保留にするかどうかを選択します。

    SIP トランク・プロバイダーが保留に対応する場合は、この機能を無効にしてください。 例えば、SIP トランク・プロバイダー自身で呼び出しを保留にできるように、アシスタントから SIP REFER 要求を送信してほしいというプロバイダーも存在します。

SIPプロトコルに関する詳細は RFC 3261を、RTPプロトコルに関する詳細は RFC 3550 を参照してください。

バックアップ・サービス・デスク・ソリューションの構成

電話サポートを顧客対応の第一線として使用する場合、オペレーターによるバックアップを用意しておくのが望ましいでしょう。 電話接続が失敗した場合またはユーザーが誰かと話すことを要求した場合に通話を人に転送するようにアシスタントを設計できます。

貴社では、適切なオペレーターが対応できるまで、電話を保留しておくことができる自動コールディスパッチャー(ACD)に接続された電話番号をすでに1つ以上お持ちかもしれません。 そうでない場合は、バックアップとして使用するサービスデスクソリューションを選択します。

ある統合タイプから別の統合タイプに会話を転送することはできません。 例えば、サービス・デスク・サポートとの Web チャット統合を使用する場合は、Web チャット用にセットアップされたサービス・デスクに電話を転送することはできません。

使用するサービス・デスク・サポート・ソリューションのサービス・デスク SIP URI を指定する必要があります。 この情報は、ダイアログ・ノードまたはアクション・ステップから通話転送を有効にする場合にアシスタントにおいて指定する必要があります。 詳しくは、 ライブ・エージェントへの通話の転送 を参照してください。

電話による対話用にアクションを最適化

優れた顧客エクスペリエンスを提供するために、電話統合の機能を念頭において、次のようにダイアログを設計してください。

  • アクション応答に HTML エレメントを含めないでください。 書式設定を追加するには、Markdown を使用します。 詳しくは、応答のフォーマット設定を参照してください。

  • 検索拡張機能を使用すれば、電話統合で読み取られる検索結果をアクションに組み込めます。 検索結果が返されると、電話統合で概要メッセージ (例えば、I found this information that might be helpful) が読み取られ、次に最初の検索結果のみの本文が読み取られます。

    検索応答全体 (つまり、概要メッセージと、最初の検索結果の本文) の長さは 5,000 文字未満でなければなりません。そうでないと、応答はまったく読み取られません。 必ず、返される検索結果をテストし、使用するデータ・コレクションを適宜キュレートしてください。

検索統合の使用について詳しくは、既存のヘルプ・コンテンツの活用を参照してください。

ダイアログから一般的なアクションを実行する方法について詳しくは、電話対話の処理を参照してください。

SIP トランクの作成

無料電話番号を生成するオプションを使用しない場合は、電話統合で使用するSIPトランクを設定する必要があります。 プロバイダーを見つけて SIP トランク・アカウントを作成します。このアカウントは使用量ごとに支払う必要があります。

SIP トランクは、以下の方法でセットアップできます。

Twilio SIP トランクの設定

Twilio SIP Trunk のセットアップを開始する前に、以下の前提条件ステップを実行します。

既に SIP トランクを作成している場合は、 SIP トランクの構成 の手順に従ってください。

SIP トランクの作成

  1. Twilioコンソールにログインし 、Elastic SIP Trunkingセクションに移動します。

    :Elastic SIP Trunking が表示されない場合は、次の手順を行ってください

    1. 検索バーElastic SIP Trunking を検索します。
    2. 「Elastic SIP Trunking Dashboard」 をクリックします。
  2. 左側のナビゲーションメニューで 「概要」 に移動し 、「開始」 をクリックします。

  3. トランクナビゲーションバー「新しいトランクを作成」 をクリックします。

  4. 「フレンドリー名」フィールドにSIPトランクの名前を入力します。

  5. **「作成」**ボタンをクリックします。 トランクSID は、新しいトランクを作成すると割り当てられます。

SIP トランクの構成については、 SIP トランクの構成 の手順に従ってください。

SIP トランクの構成

SIP トランクを構成するには、以下を実行します。

  1. 「Elastic SIP Trunking Dashboard」 ページから、 「Elastic SIP Trunking」 に移動します。

  2. 左側のナビゲーションメニューで 「管理」 をクリックします。

  3. 「トランク」 をクリックし、作成した SIP トランクを選択します。

  4. 「オリジネーション」 をクリックして設定を構成します。

  5. 発信SIP URIを追加するには 、「Add new Origination URI」ボタンをクリックし、以下のフィールドに値を入力します

    • 発信SIP URI- watsonx Assistant の電話統合設定ページで、電話統合用のSIP URIを取得できます。 これを watsonx Assistant で行うには、ツールと Create Assistant を起動します。 「統合の追加」 を選択し、 「電話」 を選択します。 アシスタントから 「SIP URI」 をコピーして、Twilio の 「発信元 SIP URI (Origination SIP URI)」 フィールドに貼り付けます。
    • 優先順位-優先順位は URI の重要度をランク付けします。 数値が小さいほど、最も高い重要度を表します。
    • 重み付け-重み付けは、複数の URI が同じ優先順位を持つ場合に、負荷の分担を決定するために使用されます。 値が大きいほど、URI の負荷が高くなります。
    • 有効- 「有効」 トグルを Yes に切り替える必要があります。 これは、発信元 SIP URI が有効であることを意味します。
  6. 通話中転送をサポートする予定の場合は、SIP トランクで通話転送 (SIP REFER) を有効にします。 通話を公衆交換電話網 (PSTN) に転送する予定の場合は、トランクで PSTN 転送も有効にします。

  7. SIPトランクのナビゲーションバーから 「Numbers」 を選択し、以下のいずれかの操作を行います

    1. 「数値の追加」 をクリックしてから、 「数値の購入」* をクリックします。
    2. 既に数値がある場合は、 「数値の追加」 をクリックしてから、 *「既存の数値の追加」*をクリックできます。

テスト目的でライトまたはトライアルの Twilio アカウントを使用する場合は、転送ターゲットを必ず確認してください。 詳細については、 Twilioのドキュメントを参照してください。

Twilio を SIP トランク・プロバイダーとして選択した場合は、SIP 認証を有効にすることができません。 Twilio は、発信呼び出しの SIPS をサポートしていません。

その他のサード・パーティー・プロバイダーの使用方法

サポート要求を開き、別の SIP トランク・プロバイダーでアカウントをセットアップするための支援を要請することができます。

IBM は、以下の SIP トランク・プロバイダーとの関係を確立しています。

SIP トランク・プロバイダーは、音声トラフィックのために SIP トランクをセットアップし、許可された IP アドレスからのアクセスを管理します。 主要な SIP トランク・プロバイダーのほとんどは、IBM との既存の関係を持っています。 したがって、SIP トランク接続をサポートするために必要なネットワーク構成は、通常、最小限の労力で処理できます。

  1. IBM Cloud ケースを作成します。

  2. 「トピック」 フィールドに、 watsonx Assistant と入力します。

  3. 「サブトピック」 ドロップダウン・リストで、 Phone & SMS Integration を選択します。

  4. 「件名」 フィールドに SIP trunk provider setup for watsonx Assistant と入力します。

  5. 説明には以下の情報を含めます。

    • 会社名
    • IBM Cloud のアカウント ID
    • watsonx Assistant サービスの名前
    • IP アドレスまたは SIP トランク・プロバイダー情報が含まれるネットワーク図

独自の SIP トランクの持ち込み

IBM との関係が確立されていない SIP トランク・キャリアを使用することを選択した場合は、使用することができます。

SIP 接続に使用される完全修飾ドメイン名と IP アドレスを以下の表にリストします。

SIP ネットワーク情報
Location ドメイン名 IP アドレス
ダラス public.0001.voip.us-south.assistant.watson.cloud.ibm.com
public.0002.voip.us-south.assistant.watson.cloud.ibm.com
public.0003.voip.us-south.assistant.watson.cloud.ibm.com
67.228.108.82
169.63.5.162
150.239.30.146
フランクフルト public.0001.voip.eu-de.assistant.watson.cloud.ibm.com
public.0002.voip.eu-de.assistant.watson.cloud.ibm.com
public.0003.voip.eu-de.assistant.watson.cloud.ibm.com
161.156.178.162
169.50.56.146
149.81.86.82
ロンドン public.0001.voip.eu-gb.assistant.watson.cloud.ibm.com
public.0002.voip.eu-gb.assistant.watson.cloud.ibm.com
public.0003.voip.eu-gb.assistant.watson.cloud.ibm.com
158.176.120.162
141.125.102.34
158.175.99.34
ソウル public.0001.voip.kr-seo.assistant.watson.cloud.ibm.com
シドニー public.0001.voip.au-syd.assistant.watson.cloud.ibm.com
public.0002.voip.au-syd.assistant.watson.cloud.ibm.com
public.0003.voip.au-syd.assistant.watson.cloud.ibm.com
168.1.47.2
135.90.86.50
168.1.106.130
東京 public.0001.voip.jp-tok.assistant.watson.cloud.ibm.com
public.0002.voip.jp-tok.assistant.watson.cloud.ibm.com
public.0003.voip.jp-tok.assistant.watson.cloud.ibm.com
165.192.69.82
128.168.105.178
161.202.149.162
ワシントン DC public.0001.voip.us-east.assistant.watson.cloud.ibm.com
public.0002.voip.us-east.assistant.watson.cloud.ibm.com
public.0003.voip.us-east.assistant.watson.cloud.ibm.com
52.116.100.158
169.61.70.162
169.59.136.194

Voice Agent with Watson からのマイグレーション

IBM® Voice Agent with Watson サービス・インスタンスを IBM Cloud で作成して、顧客が電話でアシスタントにつなげられるようにした場合は、代わりに電話統合を使用することを検討してください。 電話統合で Voice Agent with Watson で使用するために構成したものと同じ SIP アカウントと電話番号を使用できます。

電話統合により、アシスタントとのよりシームレスな統合が実現します。 ただし、統合では現在、以下の機能はサポートされていません。

  • アウトバウンド・コール
  • バックアップ・ロケーションの構成
  • イベント転送により、 IBM Cloudant for IBM Cloud データベースサービスにコール詳細レポートを保存
  • 使用状況の要約ページを確認します。 代わりに IBM Log Analysis を使用してください。 詳しくは、ログの表示を参照してください。

Voice Agent with Watson から watsonx Assistant 電話統合にマイグレーションするには、以下のステップを実行します。

  1. Voice Agent with Watson ページから、SIP アカウントに使用した 1 つ以上の電話番号をコピーします。

  2. watsonx Assistant 電話統合をセットアップするときに、前のステップでコピーした電話番号または番号のセットを追加します。

  3. 電話統合セットアップ・ページから SIP Uniform Resource Identifier (URI) をコピーします。

  4. SIP トランク・アカウントで、前のステップで指定した Voice Agent with Watson URI を、前のステップで電話統合セットアップ・ページからコピーした URI に置き換えます。

    例えば、Twilio SIP トランクを使用する場合は、アシスタントの SIP Uniform Resource Identifier (URI) を Twilio の**「起点 SIP URI」**フィールドに追加します。

  5. マイグレーション先の watsonx Assistant リージョンで SIP トランク・プロバイダーがまだ許可リストに登録されていない場合は、以下の指示に従って SIP トランクにアクセスします。

呼び出しルーティングの詳細

アシスタントへの着信呼び出しがたどるパスを次に示します。

  1. 顧客が、Session Initiation Protocol (SIP) トランク・プロバイダー管理のカスタマー・サポート電話番号を呼び出します。

  2. SIP トランクサービスは、お客様の電話アシスタントの電話統合に SIP INVITE リクエストを送信して接続を確立します。

  3. 電話統合が、対話をサポートするために必要な音声サービスに接続します。

  4. 各サービスの準備が整うと、接続が確立され、音声が Real-time Transport Protocol (RTP) を使用して送信されます。

    RTP は、音声と動画を IP ネットワークで配信するためのネットワーク・プロトコルです。

  5. アシスタントの挨拶アクションが処理されます。 応答テキストが Text to Speech サービスに送信されて音声に変換され、その音声が発信者に送信されます。

  6. 顧客が何かを言うと、その音声は Speech to Text サービスによってテキストに変換され、評価のためにアシスタントに送信されます。

  7. アシスタントは入力を処理し、最適な応答を計算します。 アシスタントからの応答テキストが Text to Speech サービスに送信されて音声に変換され、その音声が既存の接続を通じて発信者に返送されます。

  8. 発信者が人と話すことを求めた場合、アシスタントは、発信者をコール・センターに転送することができます。 SIP REFER 要求が SIP トランク・プロバイダーに送信されるので、プロバイダーが、転送アクションが構成されたダイアログ・ノードに指定されているコール・センターの SIP URI に通話を転送することができます。

  9. 通話の参加者の一人が電話を切ると、SIP BYE リクエストが他の参加者に送信されます。