發布虛擬工作助理的事件

代理程式轉接程式可以使用瀏覽器的 postMessage() API，將事件傳送至父項 iFrame。父項 iFrame 中的 JavaScript 可以使用這些事件，並在自訂顧客關係管理系統實作中採取各種動作。如要這麼做，應用程式必須在父項視窗中監聽 MessageEvent。應用程式可根據這些事件觸發動作，例如開啟特定工作階段 ID 的票證分頁。通話和即時通訊轉接程式都有特定事件，可用於強化 CRM 功能。

Contact Center 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：表示必須在虛擬工作助理的 POST 事件中傳遞顧客工作階段變數酬載中傳回的值。
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 酬載

發布虛擬工作助理的事件