适用于 Cisco BroadWorks 的 Webex 中的目录同步

目录同步确保Webex for Cisco BroadWorks用户可以使用Webex应用程序中的Webex目录从BroadWorks服务器呼叫任何呼叫实体。 此功能将不属于用户预配置一部分的BroadWorks呼叫信息同步到Webex目录。

Webex for Cisco BroadWorks用户预配置将更新Webex for Cisco BroadWorks用户的呼叫详细信息（主电话号码、移动电话号码、分机），但忽略外部呼叫记录。 但是，当目录同步开启时，该功能还会将以下呼叫记录同步到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 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 企业的目录同步 - 输入企业 id 以更新该企业的目录同步状态，从而启用或禁用目录同步。

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

• 获取企业的目录同步状态 - 输入企业 id 并运行，以获取最新同步的状态和 trackingId 。 您可以使用 trackingID 通过 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 规范。

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

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