Customer Service 全通路提供一組展現 Dynamics 365 Customer Service Enterprise 強大威力的功能套件，讓組織可以立即與不同數位傳訊管道中的客戶進行聯繫和互動。 存取 Customer Service 全通路需要額外的授權。 如需詳細資訊，請參閱 Dynamics 365 Customer Service 定價概觀和 Dynamics 365 Customer Service 定價方案頁面。
根據路由規則擷取佇列的代理程式可用性。 全通路開發人員可以使用此 API 來判斷客戶是否應該看到開始交談選項，以及顯示等待時間和佇列中的位置等資訊。
備註
- 在呼叫即時聊天 SDK 方法之前，先接聽即時聊天所引發的 lcw：ready 事件。 在引發 lcw：ready 事件之後，可以叫用即時聊天方法。 您可以在視窗物件上新增自己的事件接聽程式，以監聽此事件。
- 當客戶輸入變更時，可以從用戶端呼叫此方法多次。 用戶端快取會每 2 分鐘重新整理一次，或在客戶內容參數變更時重新整理一次。
- 每個組織每分鐘只能呼叫此方法100次。 如果超過限制，您會看到 http 429 回應狀態碼，指出您在指定的時間內傳送了太多請求。
語法
Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
參數
None
返回值
| 名稱 | 類型 | Description |
|---|---|---|
queueId |
繩子 | 根據路由規則配置和輸入資料（提供作為路由規則一部分的實體值和環境定義）路由請求的目標佇列。 |
isQueueAvailable |
布林值 | 顯示： - 如果佇列在營業時間內，則為 TRUE。 - 如果佇列在營業時間之外，則為 FALSE。 |
StartTimeOfNextOperatingHour |
DateTime | 佇列的營業時間開始時間 （UTC） （如果排隊位於營業時間之外）。 在工作時間內，會傳回值 01-01-0001。 |
EndTimeOfNextOperatingHour |
DateTime | 如果佇列在營業時間之外，則佇列的營業時間結束的時間 （UTC）。 在工作時間內，會傳回值 01-01-0001。 |
nexttransitiontime |
DateTime | 如果佇列在工作時間之外，則再次運作的時間 （UTC）。 佇列無法運作的時間會在作業時間內顯示。 |
positionInQueue |
Number | 在同一佇列中等待的顧客在其他顧客後面的佇列位置。 |
isAgentAvailable |
布林值 | 顯示： - 如果佇列中的客服專員目前可以根據工作流的已設定路由和指派規則接受請求，則為 TRUE。 如果機器人附加到工作流或佇列，API 也會傳回 true。 我們建議在機器人存在時不要使用此 API。 - 如果客服人員無法接受請求，則為 FALSE。 |
averageWaitTime |
Number | 根據過去 48 小時資料，目標佇列中客戶的平均等待時間 （以分鐘為單位）。 |
Example
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
// Gets the agent availability
Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
});
傳遞函式的自訂內容值，以確保收到內容
這個方法會執行對 setContextProvider 函式的內部呼叫，然後同步呼叫 getAgentAvailability，以確保在繼續之前已設定內容。 由於個別使用函數時的功能具有非同步性質，因此當諮詢代理程式可用時，環境定義可能尚未備妥。
備註
在呼叫 getAgentAvailability 之前，您不需要呼叫 setContextProvider 方法。
以下是示範如何使用該 setContextProvider 方法的範例程式碼。
// To set the custom context, pass the custom context object as input parameter to agent availability
// provider as part of the logic, so there is no need to set custom context before this call.
Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability({
customContext : {
'jwtToken': {'value':'token','isDisplayable':true},
'Email': {'value':'test@test.com','isDisplayable':true},
'client': {'value':'true','isDisplayable':true},
'Emailing': {'value':'true','isDisplayable':true}
}
}
);