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

目錄同步可確保 Cisco BroadWorks 使用者的 Webex 可以使用 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 聯絡人。同步專案會新加入以下聯絡人類型之一：

• 組織聯絡人 — 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 更新該企業的目錄同步狀態，啟用或停用目錄同步。

• 觸發企業的目錄同步— 如果您想要為給定企業觸發立即同步，請使用此API方法id 。對於同步狀態，輸入同步_現在 命令。

• 取得企業的目錄同步狀態— 進入企業id 並執行以取得狀態和追踪 ID 最後一次同步的日期。您可以使用追踪 ID 透過 Kibana 和 Grafana 等工具執行其他分析。

此外，管理員可以使用 單一使用者 API 的觸發目錄同步來觸發單一使用者的按需目錄同步。

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

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

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

下表彙總了本文的更新。