Yeastar P 系列硬件版 37.22.0.134-beta1

发布日期：2026年3月30日

发布类型：公测版


本文介绍固件 37.22.0.134 第 1 个公测版中的新功能与优化。

  • 如需体验本次更新的功能，请通过 PBX 网页检查新版本或 从官网下载固件 并升级 PBX。
  • 如需了解 Linkus UC 客户端 及 'Yeastar Linkus for Google' 谷歌插件 的更新内容，请参见 Linkus 更新日志。

新功能

AI 接待员
Yeastar P 系列云 PBX 提供 AI 接待员 功能，可作为 24 × 7 全天候的虚拟语音助手，自动应答来电，问候来电者，根据自定义的知识库回复咨询，并智能地将通话转接至合适的目的地，从而减少重复性人工操作，同时确保一致的服务体验。

更多信息，请参见 AI 接待员概述。

此外，此功能引入以下相关更新：
  • 新增以下附加订阅服务，用于扩展 AI 接待员功能的分钟数 (路径：订阅服务 > 附加订阅)。

    订阅服务 说明
    AI接待员 (一次性容量) 该服务为 PBX 提供一次性 AI 接待员服务分钟数。额度用尽后需另行购买。
    AI接待员 (月容量包) 每个容量包每月提供 200 分钟 AI 接待员服务分钟数，你可以按需订阅一个或多个包。
    注： 容量包中的分钟数每月重置，未使用时长不结转至次月。
    注： PBX 提供了 60 分钟的一次性免费时长，用于体验 AI 接待员功能。你可以根据需要订阅更多时长。
    • 如需订阅，请联系你的服务提供商。
    • 你可以按需订阅一个或多个月容量包，购买一次性容量，或同时订阅两种服务。若同时订阅，系统将优先从月容量包中扣除分钟数。
  • 新增通话报告 AI 接待员通话活动 (路径：通话记录和录音 > 通话报告 > 默认报告 > AI报告)，提供了 AI 接待员的通话活动和统计数据的概览。

    更多信息，请参见 AI 接待员通话活动报告。

  • 新增以下 AI 接待员功能相关的事件通知 (路径：系统 > 事件通知 > 事件类型)。
    事件通知 说明
    AI接待员通话线路异常 AI 接待员所使用的通话线路出现异常，无法接收来电时触发。
    AI接待员通话线路恢复正常 AI 接待员所使用的通话线路已恢复正常，可正常接收来电时触发。
    AI接待员时长即将用尽 AI 接待员的一次性容量或月容量包的使用率 (已使用的分钟数 / 总分钟数) 已达到预设的阈值时触发。
    AI接待员时长已用尽 AI 接待员的总分钟数 (包含一次性容量和月容量包) 已用尽时触发。
    更多信息，请参见 事件通知概述。
自定义通话报告

支持创建 自定义报告 以满足你的业务需求。你可以选择内置的自定义报告或系统默认的通话报告作为数据集，按需选取指标、维度和筛选条件来定义自己的报告数据筛选条件，从而轻松生成自定义的通话报告。

更多信息，请参见 创建自定义通话报告。

此外，此功能引入以下相关更新：
  • 新增 我的报告 管理页面 (路径：通话记录和录音 > 通话报告)，你可以在该页面下创建和管理自定义报告，并快速访问添加至此列表的默认通话报告。
    注： 你可以基于分配给用户的角色，控制 我的报告 中的通话报告的访问权限 (路径：分机和中继 > 角色)。

  • PBX 默认的通话报告已移至 默认报告 页面并分类。

  • 新增以下自定义通话报告 (路径：通话记录和录音 > 通话报告 > 我的报告)。

    通话报告 说明
    呼入队列活动分析

    此报告提供队列在队列通话处理中的详细数据分析。

    更多信息，请参见 呼入队列活动分析报告。
    呼入队列记录

    此报告提供了选定时间段内每个呼入队列的通话活动的数据概览。

    更多信息，请参见 呼入队列记录报告。
    坐席活动分析

    此报告提供坐席在队列通话处理中的详细数据分析。

    更多信息，请参见 坐席活动分析报告。
    坐席的呼入队列记录

    此报告提供了选定时间段内每个坐席的通话活动的数据概览。

    更多信息，请参见 坐席的呼入队列记录报告。
  • 优化以下默认通话报告 (路径：通话记录和录音 > 通话报告 > 默认报告)。
    通话报告 说明
    分机通话统计 / 分机通话活动 新增报告指标 放弃，显示在分机接听前呼叫者主动放弃的通话数量，不包含分机作为队列坐席或响铃组成员时收到的来电。
    分机通话计费详情
    • 新增筛选条件 PIN码，可通过指定 PIN 码筛选通话报告数据。

    • 新增报告指标 PIN码，显示通过受限呼出路由呼出时所使用的 PIN 码。
    DID/去电号码活动 新增筛选条件 DID 和 DOD，可通过指定 DID 和去电显示号码筛选通话报告数据。
    坐席未接通报告 新增报告指标 队列，显示收到来电的队列。
    坐席业绩 支持指定多个队列以筛选数据。

  • 支持在通话报告中执行以下快捷操作：

    • 自定义下载设置：点击 下载 旁的 以快速自定义通话报告下载设置。

      更多信息，请参见 通过 PBX 网页下载通话报告。
    • 添加到我的报告：将常用报告添加到 我的报告 列表中，以便快速访问。
    • 创建预约报告：快速创建定时任务，以通过电子邮件自动发送报告。
  • 支持自定义报告数据显示：

    • 可通过点击字段旁边的 ，拖拽字段调整其在报告中的显示位置。
    • 可通过点击字段旁边的 ，将其拖拽到 左侧 (固定列) 或 右侧 (固定列)，以固定对应数据列的显示位置。
  • 优化预约报告。
    • 优化预约报告设置 (路径：通话记录和录音 > 通话报告 > 预约报告 > 添加报告 > 预约信息)：
      设置 说明
      格式 支持以 HTML 格式下载通话报告。
      时间格式 支持指定时间相关字段的显示格式。
      含详情 支持设置是否包含通话详情数据，并设置详情数据的下载方式。

      注： 此项仅适用于含通话详情的通话报告 (如 IVR 报告或队列业绩报告)。

      更多信息，请参见 预约自动发送通话报告到邮箱。

    • 支持在预约记录列表中显示预约通话报告的发送状态 (路径：通话记录和录音 > 通话报告 > 预约记录)。

  • 优化通话报告 API：
    • 新增 myreport/list 接口，可用于查询自定义通话报告列表以及被添加到 我的报告 以快速访问的默认通话报告。

      更多信息，请参见 开发者手册 - 查询我的报告列表。

    • 优化现有通话报告 API 接口：
      • call_report/list、call_report/detail 和 call_report/download 接口新增参数，用于查询以下通话报告。
        通话报告 说明
        自定义通话报告 新增 my_report_id 参数，用于查询自定义通话报告以及被添加到 我的报告 以快速访问的默认通话报告的具体数据。
        AI 接待员通话活动 type 参数新增有效值 aireceptionistcallactivity，且新增参数 ai_receptionist_id_list，可用于查询 AI 接待员通话活动 报告。
        分机通话计费详情 新增参数 pin_list，可通过指定 PIN 码筛选通话报告数据。
        DID/去电号码活动 新增参数 did_num_list 和 dod_num_list，可通过指定 DID 和去电显示号码筛选通话报告数据。
      • call_report/download 接口新增以下参数，用于通话报告的下载设置。
        参数 说明
        detail_type 指定报告文件中相关通话详情的下载方式。
        format 指定文件下载格式。
        duration_format 指定时间相关字段的显示格式。
      • call_schedule_report/list 接口新增响应参数 status，可返回预约通话报告的发送状态。

      更多信息，请参见 开发者手册 - 通话报告。

功能优化和 Bug 修复

分机
  • 支持为分机设置可同时登录的 Linkus UC 客户端最大数量 (路径：分机和中继 > 分机 > 用户 > 分机信息)。
    注： 要实现多设备同时登录 Linkus，Linkus 客户端需要满足以下版本要求：
    • Linkus 桌面端：1.21.2 或更高版本
    • Linkus 手机端：5.24.13 (iOS) / 5.24.7 (安卓) 或更高版本
  • 支持查看分机所有已登录的 Linkus 客户端并管理其关联设备，如为设备添加备注，或从指定设备中远程登出分机 (路径：分机和中继 > 分机 > Linkus客户端 > 当前已登录设备)。

    注：
  • 支持通过导入文件更新分机信息 (路径：分机和中继 > 分机 > 导入)。
    导入文件时，若系统中已存在该分机号，将自动根据文件数据更新分机设置。
    注： 仅系统超级管理员支持此功能。
中继
支持以下共享中继设置：
注： 由于共享中继在 Yeastar 统一管理平台 (PBX 管理平台) 中集中配置和管理，这些设置在 PBX 管理网页中仅可查看，无法修改。
  • SIP注册定时器：指定注册中继的注册尝试次数和默认注册有效期 (路径：分机和中继 > 中继 > (共享中继) 注册中继 > 基本)。

  • 自定义SIP头：指定通过该中继外呼时，SIP INVITE 消息中将包含的自定义 SIP 头及其取值 (路径：分机和中继 > 中继 > 共享中继 > SIP 头域)。

通讯录
企业联系人信息中新增以下字段，以便更全面地记录联系人详情 (路径：通讯录 > 企业联系人)：

  • 组织
  • 职位
  • 岗位
  • 行业
  • 上级
自动配置
修复以下资源库问题：
  • 上传 IP 话机固件时，网页提示 “上传失败”，操作未成功。
  • 上传带后缀的型号 (如 X5U-V2) 固件后，后续上传固件时，对应基础型号 (如 X5U) 不再显示在 型号 下拉列表中。
时间条件

提升以下功能中可添加的自定义办公时间和时间段的数量 (从 10 个增加至 20 个)：

功能 说明
呼入路由 当启用了 基于时间条件路由来电 且 时间类型 设置为 使用自定义办公时间 或 配置自定义时间段 时，最多可添加 20 条时间设置，且每条时间设置中最多可添加 20 个自定义时间。
办公时间和假期 当配置时区的办公时间时，每条时间设置中最多可添加 20 个 办公时间 和 20 个 休息时间。
通话流程设计 当 办公时间组件 的 时间类型 设置为 使用自定义办公时间 时，最多可添加 20 个 办公时间 和 20 个 休息时间。
IVR 当 IVR 的按键事件启用了 基于时间条件路由来电，且 时间类型 设置为 使用自定义办公时间 或 配置自定义时间段 时，最多可添加 20 条时间设置，且每条时间设置中最多可添加 20 个自定义时间。
呼入路由

修复呼入路由问题：呼入路由设置为 配置自定义时间段 的路由模式，拨打特定自定义时间段的特征码时未能切换至对应目的地，而其他特征码可以正常使用。

通话流程设计
修复 HTTP 请求组件问题：无法从 HTTP 响应中获取完整数据。
速拨码
支持为速拨码添加备注 (路径：呼叫功能 > 速拨码)。

当用户拨打速拨码呼出时，该备注将与电话号码一同显示，以便于识别。
AI

内置 AI 功能 (AI 文本生成语音、通话转写 和 语音留言转写 功能) 的入口已从 应用对接 > AI 移至 AI > AI工具箱。

AI 转写
  • 新增以下附加订阅服务，用于扩展 AI 转写功能的分钟数 (路径：订阅服务 > 附加订阅)。

    订阅服务 说明
    AI转写 (一次性容量) 即原有的 AI转写 服务。该服务为 PBX 提供一次性的 AI 转写分钟数。额度用尽后需另行购买。
    AI转写 (月容量包) 每个容量包每月提供 500 分钟 AI 转写分钟数，可根据需要订阅一个或多个包。
    注： 容量包中的分钟数每月重置，未使用时长不结转至次月。
    注： PBX 提供了一次性免费转写时长，可用于体验 AI 转写功能 (企业版 为 120 分钟，旗舰版 为 240 分钟)。你可以根据需要订阅更多时长。
    • 如需订阅，请联系你的服务提供商。
    • 你可以按需订阅一个或多个月容量包，购买一次性容量，或同时订阅两种服务。若同时订阅，系统将优先从月容量包中扣除分钟数。
  • 优化以下 AI 转写事件通知 (路径：系统 > 事件通知 > 事件类型 > 提醒)。
    事件 说明
    AI转写时长即将用尽 支持分别为一次性容量和月容量包设置容量告警阈值。

    当 AI 转写的一次性容量或月容量包的使用率达到预设的容量阈值时，将触发该通知。
    AI转写时长已用尽

    当 AI 转写总时长 (包含一次性容量和月容量包) 全部用完时，将触发该通知。
邮件模板

修复邮件模板问题：编辑 预约通话记录 邮件模板时设置了 CDR 下载链接的显示文本，PBX 自动在 URL 前添加了 http://，导致链接带有重复前缀而无法访问。

事件通知
新增以下事件通知 (路径：系统 > 事件通知 > 事件类型 > 系统)。
事件 说明
通话并发数过高 当通话并发达到 PBX 上限时将触发该通知。
与共享中继失去连接 当共享中继失去连接时将触发该通知。
SIP 设置
支持自定义 SDP 会话参数，包括会话名称 (s= 行) 以及会话发起者 (o= 行) 中的 <username> 部分，以满足特定运营商或设备要求 (路径：PBX设置 > SIP设置 > 会话 > 会话参数配置)。

更多信息，请参见 SIP 设置。
Microsoft Entra ID (Azure AD) 对接
  • 简化对接流程。现仅需从 PBX 发起集成，并登录 Microsoft 账户进行权限授权，PBX 便会自动在 Microsoft Entra ID 中创建连接所需的应用程序，无需手动配置。
    注： 使用旧方式对接的现有集成仍可继续使用，不受影响。

    更多信息，请参见 对接 Yeastar P 系列云 PBX 与 Microsoft Entra ID。

  • 优化用户同步设置。
    • 新增配置项 用户头像同步。若勾选，用户的头像将同步至 PBX 分机。

    • 支持修改同步用户的分机信息。

      若禁用了特定字段或所有字段的匹配，相应信息将不再同步，你可以直接在 PBX 上编辑这些分机信息。

    更多信息，请参见 从 Microsoft Entra ID 同步用户到 Yeastar P 系列云 PBX。
  • 优化联系人同步设置：若使用简化方式 进行对接，则进行 Outlook 联系人同步时只需在 PBX 上完成相应配置，无需再在 Microsoft 中配置相关权限。
    注： 使用旧方式的现有集成不受影响，仍需在 Microsoft 侧完成权限配置。

    更多信息，请参见 同步 Microsoft Outlook 联系人到 Yeastar P 系列云 PBX。

API
  • 优化以下功能的 API 接口：
    功能 说明
    系统
    • system/get_menuoptions 接口的 menu 参数新增有效值 ai_receptionist，可用于查询 PBX 中已存在的 AI 接待员。
    • 支持使用 system/capacity 接口查询一次性或月度 AI 转写和 AI 接待员分钟数的总量和已使用量。

      更多信息，请参见 开发者手册 - 查询 PBX 容量。
    分机 extension/get、extension/query、 extension/create 和 extension/update 新增 max_clients 参数，可用于查询或设置分机可同时登录的 Linkus 客户端的最大数量。
    通讯录 联系人 API 接口 (company_contact/delete 除外) 新增 organization、job_title、position、industry 和 supervisor 参数，可用于查询或设置企业联系人的对应信息。

    更多信息，请参见 开发者手册 - 通讯录。
    中继 trunk/get 和 trunk/query 接口新增以下参数，可用于查询共享中继的对应设置：
    • registration_attempts：中继注册失败时系统的重试次数。
    • default_registration_time：默认注册有效期 (单位：秒)。
    • custom_sip_headers：通过该中继外呼时，SIP INVITE 消息中包含的自定义 SIP 头及其取值。
    呼入路由 呼入路由 API 接口 (inbound_route/delete 除外) 的目的地参数新增有效值 ai_receptionist，可用于查询或将 AI 接待员设置为路由目的地。
    IVR ivr/get、ivr/query、ivr/create 和 ivr/update 接口的目的地参数新增有效值 ai_receptionist，可用于查询或将 AI 接待员设置为目的地。
    录音 recording/playtoextension 接口新增请求参数 file，可在向分机播放录音时通过文件名来指定要播放的录音文件。
  • 优化 (30011) 通话状态变更 API 事件：在 members 数组中新增 internal 对象，其返回了内部通话的信息。

    更多信息，请参见 开发者手册 - (30011) 通话状态变更。

通话记录
修复通话记录下载问题：无法下载 CSV 和 XLS 格式的通话记录文件。