如何在客服人員關閉 Amazon Connect CCP 時自動將其狀態設定為「離線」？

簡短說明

使用 Amazon Connect Streams API 和客服人員 API，將 CCP 整合至聯絡中心的自訂應用程式中。

如需自訂 CCP 設定的範例，請參閱如何在 Amazon Connect 快顯視窗中顯示來電者聯絡人屬性？

注意事項：使用預設的 Amazon Connect CCP 時，將其關閉並不會將客服人員的狀態從可用變更為離線。客服人員必須手動變更其狀態。

解決方法

**重要事項：**下列說明提供基本範例和資源。您必須確定如何為您自己的使用案例和聯絡中心需求實施 Streams API 並開發 JavaScript 用戶端程式碼。

在自訂 Web 應用程式中設定 Amazon Connect 執行個體的 CCP

如需指示，請參閱 GitHub 上的 Amazon Connect Streams 文件。

更新應用程式程式碼

將下列 Streams API 呼叫整合至您的 Web 應用程式中：

1. 使用 connect.agent() 來訂閱客服人員事件並擷取客服人員物件。

let mAgent;
connect.agent(function(agent) {
 mAgent = agent;
});

2. 在 onbeforeunload 事件處理常式中呼叫 agent.setState()，以變更客服人員狀態。

window.addEventListener("beforeunload", function(event) {
 if (mAgent != null) {
 let states = mAgent.getAgentStates();
 // "states" is an array of changeable states. You can filter the desired state to change by name.
 let offlineState = states.filter(state => state.name === "Offline")[0];
 // Change agent state
 mAgent.setState(offlineState, {
 success: function() {
 console.log("SetState succeeded");
 },
 failure: function() {
 console.log("SetState failed");
 }
 });
 }
});

防範錯誤的設計

如果 API 呼叫失敗且聯絡人進入聯絡流程的錯誤分支，則客服人員狀態可能不會如預期般變更。請確認在自訂程式碼中包含邏輯，以應對可能的情況。

例如： 您可以在再次嘗試 API 呼叫時延遲頁面卸載。或者，您可以在頁面卸載之前，在強制回應對話方塊中輸入「呼叫失敗」警告訊息。

---

相關資訊

新增自訂客服人員狀態

提供對聯絡人控制面板的存取

監控指標並執行報告