设置同步 Microsoft SQL 联系人

通过将 Microsoft SQL 联系人同步到 Yeastar P 系列软件版，分机用户可以更为便捷地通过 Linkus 客户端给这些联系人拨打电话。此外，系统还可以根据企业联系人群组匹配结果，自动将 Microsoft SQL 联系人的来电路由到指定目的地。

限制条件

下表展示系统支持的最大企业联系人数量和企业联系人群组数量。

PBX 支持创建的分机数量 (N) N ＜ 1000 N ≥ 1000
企业联系人 (总量) 200,000 500,000
企业联系人群组 200 500

前提条件

你已映射 Yeastar P 系列软件版 和 Microsoft SQL 的联系人字段。

操作步骤

  1. 在 Microsoft SQL 配置界面，滚动到 联系人同步 栏。
  2. 启用并配置从 Microsoft SQL 数据库同步联系人。
    1. 打开 联系人同步 开关。
    2. 完成以下配置。

      项目 说明
      同步到企业联系人群组 选择同步数据库联系人存储的位置。
      • 新建：新建一个企业联系人群组来存储同步的联系人。

        如果你选择此项，在 企业联系人群组名称 中填写企业联系人群组的名称。

      • 读取特定的属性值并新建： 根据联系人表中指定列的属性值新建一个企业联系人群组来存储同步的联系人。
        如果选择此选项，在 属性名称 中输入联系人表中指定列的名称。
        注： 这可以帮助你基于通讯录查询结果将 Microsoft SQL 联系人的来电智能路由到 PBX 的指定目的地。

        例如，数据库有一列 belongto，该列指定为联系人提供服务的部门 (如 销售和 技术支持)。在此字段中输入 belongto ，系统将在保存设置后创建 销售 和 技术支持 这两个企业联系人群组，并在配置了正确的呼入路由后，根据通讯录查询结果将来电路由到联系人对应的负责团队。

      • {existing_phonebook}：选择一个现有的空的企业联系人群组来存储同步的联系人。
        注： 现有的空的企业联系人群组从 通讯录 > 企业联系人群组 中同步。
      数据同步频率 选择同步联系人的频率，然后在其后面的字段设置时间。
      注： 同步大量的联系人将影响系统的性能，建议在非办公时间同步联系人。
      反馈邮箱地址
      可选。填写邮箱地址以接收联系人同步结果的通知。
      注： 最多支持 5 个邮箱地址；使用分号 ; 分隔多个邮箱地址。
      同步联系人过滤条件
      填写用于从 Microsoft SQL 同步联系人的 SELECT 语句，格式为 select ${MAP} from {schema_name}.{table_name}。
      注： 不支持 TOP 子句。

      示例：select ${MAP} from testpbx.contacts order by id desc
      • select ${MAP}：指定数据表列名，对应的联系人信息字段值将同步到 PBX。
        注： ${MAP} 将被替换为 PBX 字段匹配 中已启用字段 相应的字段值。
      • from testpbx.contacts：指定数据表，将从此表中查询并同步联系人到 PBX。

        必须包含两部分名称 (schema 名称和表名称)，格式为 {schema_name}.{table_name}。

      • order by id desc：将查询结果按 ID 降序排列。
      删除以前同步的但本次同步不存在的联系人 如果启用，默认情况下将删除最后一次成功同步但不存在于当前同步中的联系人。
    3. 点击 保存。
  3. 点击 立即同步 以立即同步联系人到 PBX。

执行结果

  • 网页显示已成功同步至 PBX 的联系人的数量。

  • 你可以在 通讯录 > 企业联系人/企业联系人群组 中查看已同步的联系人和与其相关联的企业联系人群组，群组会被标识为 。

  • 授权分机用户可以通过 Linkus 客户端查看并呼叫联系人。
    注： 要实现此功能，你需要授予分机用户查看相关企业联系人群组的权限 (路径：分机和中继 > 客户端权限 > 联系人可见性)，同时分机用户需要将 Linkus 客户端升级到指定版本，如下所示：
    • Linkus iOS：5.7.3 或更高版本
    • Linkus 安卓：5.7.4 或更高版本
    • Linkus Windows 桌面端：1.7.3 或更高版本
    • Linkus Mac 桌面端：1.7.3 或更高版本

后续操作

如果你想要根据通讯录查询结果将来电路由到指定目的地，你需要配置呼入路由，通过匹配不同的企业联系人群组中的联系人来实现智能路由来电。

更多信息，请参见 根据群组联系人路由外部来电。