適用於 Cisco BroadWorks 的 Webex 中的目錄同步

目錄同步可確保Cisco BroadWorksWebex使用者可以使用Webex應用程式中的Webex目錄從 BroadWorks 伺服器上呼叫任何呼叫實體。 此功能將不屬於使用者佈建一部分的 BroadWorks 通話資訊同步到Webex目錄。

適用於Cisco BroadWorks 的Webex使用者佈建使用Cisco BroadWorks 使用者的Webex的通話詳細資料（主要電話號碼、行動電話號碼、分機號）來更新Webex目錄，但會忽略外部通話記錄。 但是，當開啟目錄同步時，該功能還將以下通話記錄同步到Webex目錄。

• 純 BroadWorks 通話使用者（未加入Webex的使用者）

• 非使用者呼叫實體（例如會議室電話、傳真機、搜尋群組號碼）

• BroadWorks 電話清單項目

下表總結了 BroadWorks 通話記錄，並顯示瞭如何將其新增至Webex目錄。

目錄同步情況

• 合作夥伴管理員必須在合作夥伴層級啟用該功能。 合作夥伴管理員可以透過單一作業為多個客戶組織開啟或關閉該功能。

• 預設情況下，首次同步會在啟用同步後的一週內進行（選擇啟動同步的時間是隨機的）。 但是，客戶組織可以使用立即同步選項來繞過一周的等待期，並為給定的客戶組織觸發立即同步。

• 依預設，每個客戶每週執行目錄同步一次。 每次同步都會在最後一次同步之後的一個星期發生，而不必考慮最後一次同步是排定還是手動觸發立即同步。

• 每個 BroadWorks 叢集的數目上限同步同步數為兩個： 一個排定的同步和一個隨選同步（透過API或 Partner Hub GUI）。 但是，管理員無法從同一個 BroadWorks 同時執行兩個隨選同步。 無論同步是透過API還是透過立即同步Partner Hub 中的選項。 此外， Webex不會排定兩個已排定的同步同時從同一個 BroadWorks 執行。

• 如果發生同步失敗， Webex會每隔 24 小時自動重新嘗試同步，直到下一次排定的同步為止。

• 同步會忽略沒有電話號碼的使用者。

• 在 Partner Hub 中，您可以檢視給定客戶的同步狀態資訊。 此外，您還可以將上次同步的相關詳細資訊匯出到 CSV 記錄。 CSV記錄提供比 Control Hub 顯示更多的詳細資料，可以協助進行疑難排解、分析和稽核。

• Webex以加密的格式儲存使用者聯絡人。 僅擁有該聯絡人的使用者有權存取解密金鑰。

• 對於純 BroadWorks 通話使用者和非使用者通話實體，此功能從 BroadWorks 同步以下電話號碼類型：

  • 主要電話號碼

  • 行動電話號碼

  • 擴充功能

  但是，如果主要電話號碼或分機號都不存在，則同步會將純 BroadWorks 通話使用者和非使用者通話實體排除在同步之外。

  不支援將 BroadWorks 使用者層級隱私服務設定作為目錄同步的一部分。

BroadWorks 電話清單和聯絡人上限

目錄同步還將 BroadWorks 電話清單項目同步到Webex Contacts。 同步的項目會新增至以下其中一個聯絡人類型：

• 組織聯絡人— Webex針對組織儲存這些聯絡人。 每個使用者都可以存取其組織的組織聯絡人。 最多可以有 30000 個聯絡人。

• 使用者聯絡人— Webex儲存針對使用者的這些聯絡人。 僅擁有該聯絡人的使用者可以存取該聯絡人項目。 最多為 2000 個聯絡人（1500 個同步聯絡人 + 500 個手動輸入聯絡人）。

下表將Webex聯絡人類型與聯絡人來源 (從 BroadWorks 電話清單同步或手動新增) 對應：

在目錄同步如何處理聯絡人數上限方面適用下列條件：

• 如果組織超過同步允許的聯絡人數上限（每個群組 30000 個組織聯絡人或 30000 個群組普通聯絡人），目錄同步會排除超過最大臨界值的項目。 同步或遺漏的聯絡人不會套用特定順序。

• 如果您的一個客戶超過任一類別中允許的聯絡人人數上限，我們建議您向Cisco報告案例，將該組織排除在目錄同步之外。

• 手動聯絡人是使用者手動在 Webex 應用程式上新增的聯絡人。 使用者最多可以新增 500 個手動聯絡人。 手動聯絡屬於Webex上較大的使用者聯絡類別，但不會包含在同步中。

• 組織聯絡 (30000) 和群組聯絡 (每個群組 30000) 的整體組合限制為 200000。

更新

下面介紹 Webex 目錄如何處理更新：

• 如果 BroadWorks 上的聯絡人姓名變更，則會從Webex目錄中刪除現有的聯絡人，並建立新的聯絡人。

• 如果 BroadWorks 上的聯絡人號碼變更， Webex會使用新號碼更新Webex目錄中的現有聯絡人。

管理員更新 BroadWorks 上的聯絡人之後，以下情況概述更新何時顯示在使用者的Webex應用程式中：

• 如果更新適用於純 BroadWorks 呼叫使用者或非使用者呼叫實體，則在後續目錄同步之後，更新會立即顯示在使用者的Webex應用程式中。

• 如果更新是針對 BroadWorks 電話清單項目：

  • 對於使用者聯絡人 - 在後續目錄同步之後，更新立即顯示在使用者的Webex應用程式中。

  • 對於群組聯絡人 - 在後續目錄同步之後，立即在使用者Webex應用程式中顯示更新。

  • 對於組織聯絡人 — 在後續目錄同步時會更新Webex目錄，但使用者在重新啟動Webex應用程式或本地 72 小時快取計時器到期之前不會在Webex應用程式中看到變更。

我們建議您使用以下設定：

• 速率限制值 — 設定下列 OverloadControl 系統屬性 (XSP_CLI/Applications/Xsi-Actions/OverloadControl)：

  • userDirectoryTransactionLimit — 設為 Null 值。

  • globalDirectoryTransactionLimit — 設為 Null 值。

  建議您將 userDirectoryTransactionLimit 和 globalDirectoryTransactionLimit 設定為 Null 值。 但是，如果您決定要指定值，每個值必須至少設定為 transactionLimitPeriodSeconds 值的五倍（應該為 1）。

• 交易限制 — 設定下列值 (XSP_CLI/System/CommunicationUtility/DefaultSettings)：

  • userTransactionLimit — 至少設為 100。

  • transactionLimitPeriodSecs — 設為 1。

• 傳呼值 — 設定傳呼系統屬性 (XSP_CLI/Applications/Xsi-Actions/Paging)：

  • defaultPageSize — 設為 50

  • availableUserMaxLimit — 設為 100

• CTI 介面 — 確保將該 Webex CA 憑證上傳至 CTI 介面信任存放區，並啟用 CTI 介面上的用戶端驗證。

此外，根據 BroadWorks 發行版，建議您先將下列系統修補程式套用至 BroadWorks 部署，然後再啟用此功能：

• 若版本為 R22： AP.as.22.0.1123.ap368517

• 若版本為 R23： AP.as.23.0.1075.ap368517

• 若版本為 R24： 不需要修補程式

合作夥伴管理員可以在建立新範本時為客戶範本啟用目錄同步。 指派給該範本的任何新客戶組織都將啟用目錄同步。 如需瞭解詳情，請參閱在 Partner Hub 中設定您的合作夥伴組織（位於《Webex for Cisco BroadWorks 的解決方案指南》）中的「設定客戶範本」。

後續動作

請務必讓使用者知道，必須至少按一次 Webex 應用程式上的聯絡人標籤才能在 Webex 應用程式上開啟該功能。 此動作只需完成一次。

公用 API 在 developer.webex.com 中有提供，可讓合作夥伴管理員更新其管理的客戶組織的目錄同步設定、觸發立即同步或取得同步狀態資訊。 目錄同步方法可分為以下幾類： BroadWorks 企業：

• 列出 BroadWorks 企業 — 使用此 API 方法來取得給定服務提供者下的企業清單以及每個企業的 id 。 您必須按佈建指定的那樣輸入 spEnterpriseId 。

• 更新用於 BroadWorks 企業的目錄同步 — 輸入企業 id 以更新該企業的目錄系統狀態，啟用或停用目錄同步。

• 針對企業觸發目錄同步 — 如果您想要針對給定企業 id 。 對於 syncStatus ，請輸入 SYNC_NOW 指令。

• 取得企業的目錄同步狀態 — 輸入企業 id 並執行以取得最新同步的狀態和 trackingId 。 您可以使用 trackingID 透過諸如 Kibana 和 Ganaana 等工具執行其他分析。

此外，管理員還可以使用為單個使用者觸發目錄同步用於為單一使用者觸發隨選目錄同步的API 。

如需獲取詳細的 API 文件，請參閱 https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide。

您需要登入才能閱讀 API 規格（載於 https://developer.webex.com/docs/api/v1/broadworks-subscribers）。

下列錯誤代碼適用於目錄同步。

下表彙總了本文的更新。