建立通訊面板相關的動作呼叫

文章
03/10/2022

Omnichannel for Customer Service 提供一套擴充 Dynamics 365 Customer Service Enterprise 能力的組件，讓組織能立即橫跨數位傳訊管道與客戶建立連線並進行互動。存取 Omnichannel for Customer Service 需要額外的授權。如需詳細資訊，請參閱 Dynamics 365 Customer Service 定價概觀和 Dynamics 365 Customer Service 定價方案頁面。

本主題示範如何在 Unified Service Desk for Dynamics 365 Customer Service 中建立通訊面板相關的動作呼叫。

先決條件

您必須具備必要的 Dynamics 365 Customer Service 權限，才能設定 Unified Service Desk 和存取必要的 Dynamics 365 Customer Service 實體。其他資訊： Unified Service Desk 的存取管理
您必須已完成在 Unified Service Desk 中建立專員和監督員設定、步驟 1：建立通訊面板實體搜尋以及步驟 2：建立通訊面板託管控制項。您已完成的設定是本主題所需的設定。
您必須熟悉Unified Service Desk的下列概念：
- Unified Service Desk 託管控制項
- 這三種類型的託管控制項：連線管理員、全域管理員和面板配置。其他資訊： Unified Service Desk 中的託管控制項類型、動作及事件參考
- 使用Unified Service Desk篩選存取。其他資訊：使用 Unified Service Desk 設定管理存取

建立動作呼叫

登入 Dynamics 365 執行個體。
選取 Dynamics 365 旁的向下鍵。
選取 Unified Service Desk 系統管理員。
選取 動作呼叫，然後選取 + 新增。
在新頁面中，指定下列詳細資料：

定位字元	欄位	Value
一般	名字	啟動通訊面板
一般	託管控制項	通訊面板
一般	Action	預設

儲存動作呼叫。
重複步驟 3 到 6，建立下列額外的動作呼叫。

全通路清除實體清單

定位字元	欄位	Value
一般	名字	全通路清除實體清單
一般	訂單	1
一般	託管控制項	CRM 全域管理員
一般	Action	ClearEntityList

全通路擷取即時工作資料流

定位字元	欄位	Value
一般	名字	全通路擷取即時工作資料流
一般	訂單	2
一般	託管控制項	CRM 全域管理員
一般	Action	DoSearch
一般	資料	name=LiveWorkStreamSearch global=True

全通路擷取服務端點

定位字元	欄位	Value
一般	名字	全通路擷取服務端點
一般	訂單	2
一般	託管控制項	CRM 全域管理員
一般	Action	DoSearch
一般	資料	name=ServiceEndPointSearch global=True

全通路儲存設定資料

定位字元	欄位	Value
一般	名字	全通路儲存設定資料
一般	訂單	3
一般	託管控制項	通訊面板
一般	Action	OmnichannelSaveConfigurationData

更新全通路設定

定位字元	欄位	Value
一般	名字	更新全通路設定
一般	託管控制項	CRM 全域管理員
一般	Action	SaveSetting
一般	資料	name=OmniChannelConfig value=[[OCConfig]+]

全通路 AAD 驗證失敗

定位字元	欄位	Value
一般	名字	全通路 AAD 驗證失敗
一般	託管控制項	通訊面板
一般	Action	OmnichannelAADAuthenticationFailure
一般	資料	PostData=[[PostData]+]

全通路啟用工作階段

定位字元	欄位	Value
一般	名字	全通路啟用工作階段
一般	託管控制項	工作階段索引標籤
一般	Action	SwitchSession
一般	資料	sessionid=[[SessionTabId]+]
進階	條件	'[[CanActivateSession]+]' == 'True'

全通路解除凍結交談

定位字元	欄位	Value
一般	名字	全通路解除凍結交談
一般	託管控制項	通訊面板
一般	Action	OmnichannelSwitchSessionsTabs
一般	資料	SessionTabId=[[SessionTabId]+]
進階	條件	'[[CanActivateSession]+]' == 'True'

建立客戶工作階段

定位字元	欄位	Value
一般	名字	建立客戶工作階段
一般	訂單	10
一般	託管控制項	CRM 全域管理員
一般	Action	CreateSession
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+] && '[[CanActivateSession]+]' != 'True'

顯示工作階段指派快顯通知

定位字元	欄位	Value
一般	名字	顯示工作階段指派快顯通知
一般	訂單	10
一般	託管控制項	全通路快顯通知
一般	Action	顯示
一般	資料	formname=ToastNotification top=85 left=82 timeout=7 stack=true stackHeight=56 placementmode=absolute ToastNotificationText=[[$Resources.SessionAssignmentToastNotification]+] NotificationIcon=new_omni_toast_tick_icon
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] >= [[$Global.maxNumberOfSessions]+] && '[[CanActivateSession]+]' != 'True'

設定 IsCaseSession 為 False

定位字元	欄位	Value
一般	名字	設定 IsCaseSession 為 False
一般	訂單	11
一般	託管控制項	CRM 全域管理員
一般	Action	CopyToContext
一般	資料	IsCaseSession=False
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+]

全通路工作階段被接受

定位字元	欄位	Value
一般	名字	全通路工作階段被接受
一般	訂單	15
一般	託管控制項	通訊面板
一般	Action	OmnichannelSessionAccepted
一般	資料	ConversationId=[[cid]] SessionTabId=[[$Session.ActiveSession]] From=[[from]] CanActivateSession=[[CanActivateSession]+]
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+] \|\| '[[CanActivateSession]+]' == 'True'

關閉快顯通知

定位字元	欄位	Value
一般	名字	關閉快顯通知
一般	託管控制項	全通路快顯通知
一般	Action	關閉

展開右窗格

定位字元	欄位	Value
一般	名字	展開右窗格
一般	託管控制項	自訂面板
一般	Action	SetVisualProperty
一般	資料	elementName=RightPanelExpander propertyname=IsExpanded value=true

全通路工作階段被接受

定位字元	欄位	Value
一般	名字	全通路工作階段被接受
一般	訂單	10
一般	託管控制項	CRM 全域管理員
一般	Action	OmnichannelSessionAccepted
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+] && '[[CanActivateSession]+]' != 'True'

在上下文中設定實體工作階段屬性

定位字元	欄位	Value
一般	名字	在上下文中設定實體工作階段屬性
一般	訂單	11
一般	託管控制項	CRM 全域管理員
一般	Action	CopyToContext
一般	資料	ISENTITYSESSION=True CRMCONTACTID=010101
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+]

摺疊左面板

定位字元	欄位	Value
一般	名字	摺疊左面板
一般	訂單	12
一般	託管控制項	自訂面板
一般	Action	SetVisualProperty
一般	資料	elementname=LeftPanelParent propertyname=Visibility value=$Expression('[[$Context.IsCaseSession]+]'=='True' \|\| '[[$Context.ISENTITYSESSION]+]'=='True' \|\| '[[$Session.IsGlobal]+]'=='True' \|\| '[[$Context.cticallincoming]+]'=='1'? "Collapsed" : "Visible")
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+]

載入案例工作階段專員底稿

定位字元	欄位	Value
一般	名字	載入案例工作階段專員底稿
一般	訂單	20
一般	託管控制項	代理程式指令碼
一般	Action	GotoTask
一般	資料	結案底稿
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+]

Hinweis

載入案例工作階段專員底稿 動作呼叫是選用的。

實體的載入表單

定位字元	欄位	Value
一般	名字	實體的載入表單
一般	訂單	30
一般	託管控制項	實體頁面
一般	Action	Open_CRM_Page
一般	資料	LogicalName=[[EntityLogicalName]+] id=[[EntityId]+]
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+]

實體的載入表單

定位字元	欄位	Value
一般	名字	實體工作階段的全通路設定工作階段索引標籤 ID
一般	訂單	40
一般	託管控制項	通訊面板
一般	Action	OmnichannelSetSessionTabIdForEntitySession
一般	資料	ConversationId=[[ConversationId]] SessionTabId=[[$Session.ActiveSession]]
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] < [[$Global.maxNumberOfSessions]+]

聚焦在知識搜尋

定位字元	欄位	Value
一般	名字	聚焦在知識搜尋
一般	託管控制項	CRM 全域管理員
一般	Action	ShowTab
一般	資料	知識庫搜尋

顯示訊息動作

定位字元	欄位	Value
一般	名字	顯示訊息動作
一般	託管控制項	CRM 全域管理員
一般	Action	DisplayMessage
一般	資料	text=通訊面板中發生錯誤。重新啟動 Unified Service Desk，然後再試一次。 (錯誤碼 - [[TEXT]+]) caption=錯誤

全通路結束交談

定位字元	欄位	Value
一般	名字	全通路結束交談
一般	託管控制項	通訊面板
一般	Action	OmnichannelEndConversation
一般	資料	ChatPayLoad=[[PostData]]

全通路目前狀態的狀態更新

定位字元	欄位	Value
一般	名字	全通路目前狀態的狀態更新
一般	訂單	240
一般	託管控制項	通訊面板
一般	Action	OCPresenceUpdate
進階	條件	[[$GlobalDictionary.CurrentSessionCount]+] <= [[$Global.maxNumberOfSessions]+]

全通路接收工作階段要求

定位字元	欄位	Value
一般	名字	全通路接收工作階段要求
一般	訂單	17
一般	託管控制項	通訊面板
一般	Action	OmnichannelIncomingSessionRequest
一般	資料	ChatPayLoad=[[PostData]]

載入專員首頁

定位字元	欄位	Value
一般	名字	載入專員首頁
一般	訂單	1
一般	託管控制項	全通路專員儀表板
一般	Action	Navigate
一般	資料	url=/main.aspx?pagetype=dashboard&id=e8fb53c5-2f79-e811-8162-000d3aa3ef73&_canOverride=false HideNavigationBar=True

全通路通訊面板已載入

定位字元	欄位	Value
一般	名字	全通路通訊面板已載入
一般	訂單	17
一般	託管控制項	通訊面板
一般	Action	OmnichannelConversationControlReady

全通路將連絡人 ID 複製至上下文

定位字元	欄位	Value
一般	名字	全通路將連絡人 ID 複製至上下文
一般	訂單	2
一般	託管控制項	CRM 全域管理員
一般	Action	CopyToContext
一般	資料	contactIds = [[contact]+]

全通路擷取上下文連絡人

定位字元	欄位	Value
一般	名字	全通路擷取上下文連絡人
一般	訂單	3
一般	託管控制項	CRM 全域管理員
一般	Action	DoSearch
一般	資料	ContextContactSearch global=True
進階	條件	$Expression('[[$Context.contactIds]+]' == '' ? "false" : "true")

全通路儲存上下文實體

定位字元	欄位	Value
一般	名字	全通路儲存上下文實體
一般	訂單	4
一般	託管控制項	通訊面板
一般	Action	OmnichannelSaveContextEntities
一般	資料	LiveWorkItemId = [[LiveWorkItemId]+] SessionId = [[SessionId]+] RequestType = [[RequestType]+] LiveWorkStreamId = [[LiveWorkStreamId]+] ChatId=[[ChatId]+]

全通路清除上下文實體

定位字元	欄位	Value
一般	名字	全通路清除上下文實體
一般	訂單	1
一般	託管控制項	CRM 全域管理員
一般	Action	ClearEntityList
一般	資料	global=True

全通路擷取上下文連絡人

定位字元	欄位	Value
一般	名字	全通路擷取上下文連絡人
一般	訂單	3
一般	託管控制項	CRM 全域管理員
一般	Action	DoSearch
一般	資料	ContextContactSearch global=True
進階	條件	$Expression('[[$Context.contactIds]+]' == '' ? "false" : "true")

全通路更新時儲存上下文實體

定位字元	欄位	Value
一般	名字	全通路更新時儲存上下文實體
一般	訂單	4
一般	託管控制項	通訊面板
一般	Action	OmnichannelSaveUpdatedContextEntities
一般	資料	LiveWorkItemId = [[LiveWorkItemId]+]

初始化全通路上下文 - 視窗變數 - 客戶摘要

定位字元	欄位	Value
一般	名字	初始化全通路上下文 - 視窗變數 - 客戶摘要
一般	訂單	5
一般	託管控制項	客戶摘要
一般	Action	RunScript
一般	資料	function initOCContext() { var ocConfig = JSON.parse('[[$Settings.OmniChannelConfig]+]'); var session = JSON.parse(JSON.stringify([[$Context.SessionParameters]+])); ocConfig.config.sessionParams = session; window.ocContext = ocConfig; } initOCContext();

重新整理客戶摘要控制項

定位字元	欄位	Value
一般	名字	重新整理客戶摘要控制項
一般	訂單	6
一般	託管控制項	客戶摘要
一般	Action	RunScript
一般	資料	function refreshControls() { MscrmControls.FormInitiator.FormInitiatorControl.updateLinkedRecords(); } refreshControls();

全通路通知通訊面板錯誤

定位字元	欄位	Value
一般	名字	全通路通知通訊面板錯誤
一般	託管控制項	通訊面板
一般	Action	OmnichannelNotifyConversationControlError
一般	資料	PostData=[[PostData]+]

全通路 Proxy 回覆

定位字元	欄位	Value
一般	名字	全通路 Proxy 回覆
一般	託管控制項	通訊面板
一般	Action	OmnichannelProxyResponse
一般	資料	ChatPayLoad=[[PostData]]

全通路工作階段轉移已起始

定位字元	欄位	Value
一般	名字	全通路工作階段轉移已起始
一般	託管控制項	通訊面板
一般	Action	OmnichannelSessionTransferInitiated
一般	資料	ChatPayLoad=[[PostData]]

聚焦在全通路專員儀表板

定位字元	欄位	Value
一般	名字	聚焦在全通路專員儀表板
一般	訂單	2
一般	託管控制項	CRM 全域管理員
一般	Action	ShowTab
一般	資料	全通路專員儀表板

更新設定中舊的目前狀態的狀態

定位字元	欄位	Value
一般	名字	更新設定中舊的目前狀態的狀態
一般	訂單	10
一般	託管控制項	CRM 全域管理員
一般	Action	SetReplacementParameter
一般	資料	appname=$GlobalDictionary param=OCOLDPRESENCESTATE value=[[$GlobalDictionary.OCCURRENTPRESENCESTATE]] global=true

更新設定中目前的目前狀態的狀態

定位字元	欄位	Value
一般	名字	更新設定中目前的目前狀態的狀態
一般	訂單	20
一般	託管控制項	CRM 全域管理員
一般	Action	SetReplacementParameter
一般	資料	appname=$GlobalDictionary param=OCCURRENTPRESENCESTATE value=[[CURRENT_PRESENCE_STATE]+] global=true

更新設定中所有目前狀態的狀態

定位字元	欄位	Value
一般	名字	更新設定中所有目前狀態的狀態
一般	託管控制項	CRM 全域管理員
一般	Action	SetReplacementParameter
一般	資料	appname=$GlobalDictionary param=OCALLPRESENCESTATE value=[[CURRENT_PRESENCE_STATE]+] global=true

顯示案例實體通知

定位字元	欄位	Value
一般	名字	顯示案例實體通知
一般	訂單	10
一般	託管控制項	全通路快顯通知
一般	Action	顯示
一般	資料	formname=EntityNotification top=85 left=82 timeout=60 stack=true stackHeight=56 EntityDisplayName=[[EntityDisplayName]+] EntityLogicalName=[[EntityLogicalName]+] EntityId=[[EntityId]+] ConversationId=[[ConversationId]+] placementmode=absolute NotificationIcon=new_omni_foonotification_case_icon
進階	條件	'[[EntityLogicalName]+]' == 'incident'

顯示預設實體通知

定位字元	欄位	Value
一般	名字	顯示預設實體通知
一般	訂單	10
一般	託管控制項	全通路快顯通知
一般	Action	顯示
一般	資料	formname=EntityNotification top=85 left=82 timeout=60 stack=true stackHeight=56 EntityDisplayName=[[EntityDisplayName]+] EntityLogicalName=[[EntityLogicalName]+] EntityId=[[EntityId]+] ConversationId=[[ConversationId]+] placementmode=absolute NotificationIcon=new_omni_foonotification_default_icon
進階	條件	'[[EntityLogicalName]+]' != 'incident'

全通路未讀訊息動作

定位字元	欄位	Value
一般	名字	全通路未讀訊息動作
一般	訂單	10
一般	託管控制項	通訊面板
一般	Action	OmnichannelUnreadMessage
一般	資料	ChatPayLoad=[[PostData]]

全通路更新目前狀態

定位字元	欄位	Value
一般	名字	全通路更新目前狀態
一般	託管控制項	通訊面板
一般	Action	OmnichannelUpdatePresence
一般	資料	ChatPayLoad=[[PostData]+]

更新字典中的工作階段計數

定位字元	欄位	Value
一般	名字	更新字典中的工作階段計數
一般	託管控制項	CRM 全域管理員
一般	Action	SetReplacementParameter
一般	資料	appname=$GlobalDictionary param=CurrentSessionCount value=[[CurrentSessionCount]+] global=true

下一個主題：步驟 4：附加通訊面板相關的動作呼叫至事件

請參閱

Hinweis

是否能請您告知您偏好的慣用文件語言？請填寫問卷。 (請注意，本問卷為英文版)

完成問卷大約需要七分鐘。本問卷將不會收集個人資料 (隱私權聲明)。

步驟 3：建立通訊面板相關的動作呼叫

先決條件

建立動作呼叫

全通路清除實體清單

全通路擷取即時工作資料流

全通路擷取服務端點

全通路儲存設定資料

更新全通路設定

全通路 AAD 驗證失敗

全通路啟用工作階段

全通路解除凍結交談

建立客戶工作階段

顯示工作階段指派快顯通知

設定 IsCaseSession 為 False

全通路工作階段被接受

關閉快顯通知

展開右窗格

全通路工作階段被接受

在上下文中設定實體工作階段屬性

摺疊左面板

載入案例工作階段專員底稿

實體的載入表單

實體的載入表單

聚焦在知識搜尋

顯示訊息動作

全通路結束交談

全通路目前狀態的狀態更新

全通路接收工作階段要求

載入專員首頁

全通路通訊面板已載入

全通路將連絡人 ID 複製至上下文

全通路擷取上下文連絡人

全通路儲存上下文實體

全通路清除上下文實體

全通路擷取上下文連絡人

全通路更新時儲存上下文實體

初始化全通路上下文 - 視窗變數 - 客戶摘要

重新整理客戶摘要控制項

全通路通知通訊面板錯誤

全通路 Proxy 回覆

全通路工作階段轉移已起始

聚焦在全通路專員儀表板

更新設定中舊的目前狀態的狀態

更新設定中目前的目前狀態的狀態

更新設定中所有目前狀態的狀態

顯示案例實體通知

顯示預設實體通知

全通路未讀訊息動作

全通路更新目前狀態

更新字典中的工作階段計數

請參閱

意見反映