目录同步Webex Cisco BroadWorks 用户可以使用 Webex 应用程序中的 Webex 目录从 BroadWorks 服务器呼叫任何主叫实体。此功能将非用户设置一部分的 BroadWorks 呼叫信息同步到 Webex目录。

Webex Cisco BroadWorks 用户设置中，已更新 Webex 目录，为 Cisco BroadWorks 用户更新 Webex 的呼叫详细信息（主电话号码、移动电话号码、分机），但省略外部呼叫记录。但是，当目录同步打开时，此功能还会将以下呼叫记录同步到Webex目录。

• 仅 BroadWorks 呼叫用户（未加入 Webex）

• 非用户呼叫实体（例如，会议室电话、传真寻线组号码）

• BroadWorks 电话列表条目

下表总结了 BroadWorks 呼叫记录，并显示了如何将记录添加到 Webex目录。

目录同步条件

• 合作伙伴管理员必须在合作伙伴级别启用此功能。合作伙伴管理员可以在一次操作中为多个客户组织开启或关闭此功能。

• 缺省情况下，初始同步会在启用同步后的下一周执行（所选的同步开始时间是随机的）。但是，客户组织可以使用立即同 步选项绕过一周的等待期，并为给定的客户组织触发立即同步。

• 缺省情况下，每个客户的目录同步每周运行一次。每次同步都会在上次同步后一周进行，不管上次同步是安排还是通过“立即同步”手动 触发。

• 每个 BroadWorks 集群的最大同步数为 2：一个已安排的同步和一个按需同步（通过 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 App 上手动添加的联系人。一个用户最多可以添加 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—设置为空值。

  • globalDirectoryTransactionLimit—设置为空值。

  建议您将 userDirectoryTransactionLimit 和 globalDirectoryTransactionLimit 设置为空值。但是，如果您决定分配值，则每个值都必须设置为至少五倍于 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 应用程序上开启此功能。只需完成一次。

developer.webex.com 上提供了公共 API，允许合作伙伴管理员执行以下操作：更新其管理的客户组织的目录同步设置、触发即时同步，或者获取同步状态信息。目录同步方法分组到 BroadWorks 企业：

• 列出BroadWorks企业—使用此API方法获取指定服务提供商的企业列表和每个企业的 ID。您必须输入配置中分配的 spEnterpriseId 。

• 更新BroadWorks Enterprise的目录同步—输入企业ID 以更新该企业的目录系统状态，启用或禁用目录同步。

• 为企业触发目录同步—如果要为给定企业id触发即时同步，请使用此API方法。对于 syncStatus，输入 SYNC_NOW 命令。

• 获取企业目录同步状态—输入企业ID 并运行，以获取最新同步的状态和跟踪ID 。您可以使用 跟踪ID 通过Kibana和Grafana等工具运行其他分析。

此外，管理员可以为单个 用户 API 触发目录同步来为单个用户触发按需目录同步。

有关 API 文档的详细信息，请参阅 https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide。

您需要登录到 https://developer.webex.com/docs/api/v1/broadworks-subscribers 以阅读 API 规范。

以下错误代码适用于目录同步。

下表对本文的更新进行了总结。