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

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

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

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

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

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

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

データフィールド

call_id。音声（IVR）セッションの識別子。
chat_id。ウェブまたはモバイルのチャットセッションの ID。
campaign_id: キャンペーン通話の識別子。
campaign_name: キャンペーンの名前。
virtual_agent_id: 仮想タスクアシスタントの識別子。
virtual_agent_name: 仮想タスクアシスタントの名前。
participant_id: 仮想タスクアシスタントの参加者 ID。
queue_id: セッションの送信元キューの識別子。この識別子は、セッションがキューから開始された場合にのみ含まれます。
queue_path: セッションの送信元キューのパス。この識別子は、セッションがキューから開始された場合にのみ含まれます。
queue_language_id: セッションの送信元となったキューの言語。この識別子は、セッションがキューから開始された場合にのみ含まれます。
session_type: セッションのタイプ（ウェブチャット経由のメッセージングインバウンドなど）。
conversation_id: 会話プロファイルを使用する仮想エージェントセッションの識別子。
session_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）セッションの識別子。
chat_id。ウェブまたはモバイルのチャットセッションの ID。
campaign_id: キャンペーン通話の識別子。
campaign_name: キャンペーンの名前。
virtual_agent_id: 仮想タスクアシスタントの識別子。
virtual_agent_name: 仮想タスクアシスタントの名前。
participant_id: 仮想タスクアシスタントの参加者 ID。
queue_id: セッションの送信元キューの識別子。この識別子は、セッションがキューから開始された場合にのみ含まれます。
queue_path: セッションの送信元キューのパス。この識別子は、セッションがキューから開始された場合にのみ含まれます。
queue_language_id: セッションの送信元となったキューの言語。この ID は、セッションがキューから開始された場合にのみ含まれます。
session_type: セッションのタイプ（ウェブチャット経由のメッセージングインバウンドなど）。
conversation_id: 会話プロファイルを使用する仮想エージェントセッションの識別子。
session_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）セッションの識別子。
chat_id。ウェブまたはモバイルのチャットセッションの ID。
campaign_id: キャンペーン通話の識別子。
campaign_name: キャンペーンの名前。
virtual_agent_id: 仮想タスクアシスタントの識別子。
virtual_agent_name: 仮想タスクアシスタントの名前。
queue_id: セッションの送信元キューの識別子。この識別子は、セッションがキューから開始された場合にのみ含まれます。
queue_path: セッションの送信元キューのパス。この識別子は、セッションがキューから開始された場合にのみ含まれます。
queue_language_id: セッションの送信元となったキューの言語。この識別子は、セッションがキューから開始された場合にのみ含まれます。
session_type: セッションのタイプ（ウェブチャット経由のメッセージングインバウンドなど）。
conversation_id: 会話プロファイルを使用する仮想エージェントセッションの識別子。
session_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 ペイロード