Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

仮想タスクアシスタントのイベントを投稿する

エージェントアダプターは、ブラウザの postMessage() API を使用して、親 iFrame にイベントを送信できます。これらのイベントは、親 iFrame の JavaScript で使用して、カスタム CRM 実装でさまざまなアクションを実行できます。そのためには、アプリで親ウィンドウの MessageEvent をリッスンする必要があります。イベントに基づいて、特定のセッション ID のチケットタブを開くなどのアクションをトリガーできます。通話アダプターとチャットアダプターには、CRM の機能を強化するために使用できる特定のイベントがあります。

コンタクトセンター AI プラットフォームは、次の仮想タスクアシスタントイベントをサポートしています。

仮想タスクアシスタントが参加した
仮想タスクアシスタントが退出した
仮想タスクアシスタントのカスタムセッション変数が受信された

エージェントアダプターに関連する投稿イベントの完全なリストについては、エージェントアダプターをご覧ください。

仮想タスクアシスタントが参加した

このイベントは、仮想タスクアシスタントがセッションに参加したときに渡されます。

データフィールド

call_id: 音声（IVR）セッションの ID。
chat_id: ウェブまたはモバイルのチャットセッションの ID。
campaign_id: キャンペーン通話の ID。
campaign_name: キャンペーンの名前。
virtual_agent_id: 仮想タスクアシスタントの ID。
virtual_agent_name: 仮想タスクアシスタントの名前。
participant_id: 仮想タスクアシスタントの参加者 ID。
queue_id: セッションの発生元のキューの ID。この ID は、セッションがキューから発生した場合にのみ含まれます。
queue_path: セッションの発生元のキューのパス。この ID は、セッションがキューから発生した場合にのみ含まれます。
queue_language_id: セッションの発生元のキューの言語。この ID は、セッションがキューから発生した場合にのみ含まれます。
session_type: セッションのタイプ（ウェブチャット経由のメッセージングインバウンドなど）。
conversation_id: 会話プロファイルを使用する仮想エージェントセッションの ID。
session_id: 会話プロファイルを使用しない仮想エージェントセッションの ID。
timestamp: イベントの日時。
data_parameters: CCAI プラットフォームポータルで構成され、仮想タスクアシスタントに送信される変数。

ペイロードのサンプル

{
 "type": "Task_VA_Joined",
 "data": {
   "chat_id": 103646,
   "campaign_id": 1432,// omitted if not available
   "campaign_name": "Survey Movie", // omitted if not available
   "virtual_agent_id": 1,
   "virtual_agent_name": "name",
   "participant_id": 1,
   "queue_id": 8469, // omitted if not available
   "queue_path": "Developers / James", // omitted if not available
   "queue_language_id": "en", // omitted if not available
   "session_type": "Messaging Inbound (SMS)",
   "conversation_id": "12345",
   "session_id": "78534G4RT4284", // omitted if not available
   "timestamp": "1727853575",
   "data_parameters": {
     "param1": "one",
     "param2": "two"
   }
 }
}

仮想タスクアシスタントが退出した

このイベントは、仮想タスクアシスタントがセッションを退出したときに渡されます。

データフィールド

call_id: 音声（IVR）セッションの ID。
chat_id: ウェブまたはモバイルのチャットセッションの ID。
campaign_id: キャンペーン通話の ID。
campaign_name: キャンペーンの名前。
virtual_agent_id: 仮想タスクアシスタントの ID。
virtual_agent_name: 仮想タスクアシスタントの名前。
participant_id: 仮想タスクアシスタントの参加者 ID。
queue_id: セッションの発生元のキューの ID。この ID は、セッションがキューから発生した場合にのみ含まれます。
queue_path: セッションの発生元のキューのパス。この ID は、セッションがキューから発生した場合にのみ含まれます。
queue_language_id: セッションの発生元のキューの言語。この ID は、セッションがキューから発生した場合にのみ含まれます。
session_type: セッションのタイプ（ウェブチャット経由のメッセージングインバウンドなど）。
conversation_id: 会話プロファイルを使用する仮想エージェントセッションの ID。
session_id: 会話プロファイルを使用しない仮想エージェントセッションの ID。
timestamp: イベントの日時。
finish_reason: 仮想エージェントセッションが終了した理由。
data_parameters: CCAI プラットフォームポータルで構成され、仮想タスクアシスタントに送信される変数。
captured_variables: 仮想タスクアシスタントによってキャプチャされたセッション変数。

ペイロードのサンプル

{
 "type": "Task_VA_Left",
 "data": {
   "chat_id": 103646,
   "campaign_id": 1432, // omitted if not available
   "campaign_name": "Survey Movie", // omitted if not available
   "virtual_agent_id": 1,
   "virtual_agent_name": "name",
   "participant_id": 1,
   "queue_id": 8469, // omitted if not available
   "queue_path": "Developers / James", // omitted if not available
   "queue_language_id": "en", // omitted if not available
   "session_type": "Messaging Inbound (SMS)",
   "conversation_id": "12345",
   "session_id": "78534G4RT4284", // omitted if not available
   "timestamp": "1727853575",
   "finish_reason": "Task VA failed", // Finish reason passed when the VTA session ends 
   "data_parameters": {
     "param1": "one",
     "param2": "two"
   },
   "captured_variables": [
     {
       "intent_name": null,
       "variables": {
           "testkey": "testvalue"
       },
       "captured_at": "2024-11-15 16:46:31 UTC",
       "timestamp": "1727853575"
     },
     {
       "intent_name": null,
       "variables": {
           "testkey2": "testvalue2"
       },
       "captured_at": "2024-11-15 16:46:31 UTC",
       "timestamp": "1727853575"
     }
   ]
 }
}

仮想タスクアシスタントのセッション変数が受信された

仮想タスクアシスタントがカスタムセッション変数ペイロードを送信すると、この値が渡されます。

データフィールド

call_id: 音声（IVR）セッションの ID。
chat_id: ウェブまたはモバイルのチャットセッションの ID。
campaign_id: キャンペーン通話の ID。
campaign_name: キャンペーンの名前。
virtual_agent_id: 仮想タスクアシスタントの ID。
virtual_agent_name: 仮想タスクアシスタントの名前。
queue_id: セッションの発生元のキューの ID。この ID は、セッションがキューから発生した場合にのみ含まれます。
queue_path: セッションの発生元のキューのパス。この ID は、セッションがキューから発生した場合にのみ含まれます。
queue_language_id: セッションの発生元のキューの言語。この ID は、セッションがキューから発生した場合にのみ含まれます。
session_type: セッションのタイプ（ウェブチャット経由のメッセージングインバウンドなど）。
conversation_id: 会話プロファイルを使用する仮想エージェントセッションの ID。
session_id: 会話プロファイルを使用しない仮想エージェントセッションの ID。
timestamp: イベントの日時。
data_parameters: CCAI プラットフォームポータルで構成され、仮想タスクアシスタントに送信される変数。
captured_variables: 仮想タスクアシスタントによってキャプチャされたセッション変数。

ペイロードのサンプル

{
 "type": "Task_VA_Variables_Received",
 "data": {
   "chat_id": 103646,
   "campaign_id": 1432, // omitted if not available
   "campaign_name": "Survey Movie", // omitted if not available
   "virtual_agent_id": 1,
   "virtual_agent_name": "name",
   "participant_id": 1,
   "queue_id": 8469, // omitted if not available
   "queue_path": "Developers / James", // omitted if not available
   "queue_language_id": "en", // omitted if not available
   "session_type": "Messaging Inbound (SMS)",
   "conversation_id": "12345",
   "session_id": "78534G4RT4284", // omitted if not available
   "timestamp": "1727853575",
   "data_parameters": {
     "param1": "one",
     "param2": "two"
   },
   "captured_variables": [
     {
       "intent_name": null,
       "variables": {
           "testkey_1": "testvalue"
       },
       "captured_at": "2024-11-15 16:46:31 UTC",
       "timestamp": "1727853575"
     },
     {
       "intent_name": null,
       "variables": {
           "testkey_2": "testvalue2"
       },
       "captured_at": "2024-11-15 16:46:31 UTC",
       "timestamp" : "1727853575"
     }
   ]
 }
}

カスタムセッション変数の Dialogflow ペイロード

Dialogflow のカスタムセッション変数ペイロードは、仮想タスクアシスタントの投稿イベントをサポートしています。

顧客セッション変数ペイロードで使用できるプロパティは次のとおりです。

capture_type:event: 顧客セッション変数ペイロードで返される値は、仮想タスクアシスタントの投稿イベントで渡す必要があることを示します。
capture_type:agent: 顧客セッション変数ペイロードで返される値は、エージェントアダプターに渡す必要があることを示します。
capture_type:comment: 顧客セッション変数ペイロードで返される値は、コメントとして CRM レコードに渡す必要があることを示します。
invisible_to_adapter_events: このプロパティで指定されたキーの値は、仮想タスクアシスタントの投稿イベントから除外する必要があります。

ペイロードのサンプル

{
 "ujet": {
   "session_variable": {
     "payload": {
       "key_two": "$session.params.favfood",
       "key_three": "$session.params.budget",
       "key_one": "$session.params.location",
       "key_four": "$session.params.startdate",
       "key_five": "$session.params.enddate"
     },
     "capture_type": [
       "comment",
       "agent",
       "event"
     ],
     "capture_target": "payload",
     "invisible_to_agent": [
       "key_one",
       "key_two"
     ],
     "invisible_to_adapter_events": [
       "key_three",
       "key_two"
     ]
    }
  }
}

仮想タスク アシスタントのイベントを投稿する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

仮想タスク アシスタントが参加した

仮想タスク アシスタントが退出した

仮想タスク アシスタントのセッション変数が受信された

カスタム セッション変数の Dialogflow ペイロード

仮想タスクアシスタントのイベントを投稿する

仮想タスクアシスタントが参加した

仮想タスクアシスタントが退出した

仮想タスクアシスタントのセッション変数が受信された

カスタムセッション変数の Dialogflow ペイロード