Yeastar P 系列软件版 83.22.0.134 Beta

本文介绍固件版本 83.22.0.134 从公测 (Beta) 到正式发布 (GA) 的发布历史。

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

固件 83.22.0.134-beta1

发布日期：2026年3月30日

发布类型：公测版

基线版本：83.22.0.17

新功能

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

更多信息，请参见 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，可返回预约通话报告的发送状态。

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

本地代理网关 (Onsite Proxy)
Yeastar P 系列软件版 提供 本地代理网关 功能。通过在远程 IP 话机所在的同一子网中部署 Yeastar 提供的本地代理网关软件，可在 PBX 与这些话机之间建立安全的通信通道，使其通过公网也能像在本地网络中一样，轻松实现自动部署和访问，且无需繁琐的端口转发配置。

更多信息，请参见 本地代理网关概述。

此外，此功能引入以下相关更新：

  • 支持通过本地代理网关自动配置远程 IP 话机。

    更多信息，请参见 自动配置远程 IP 话机(PnP 方式) 和 自动配置远程 IP 话机 (DHCP 方式)。

  • 新增事件通知 本地代理网关异常 (路径：系统 > 事件通知 > 事件类型 > 系统)。当 PBX 与本地代理网关之间的连接中断，或本地代理网关的系统资源利用率超过指定阈值时将触发该通知。

    更多信息，请参见 事件通知概述。

  • 新增本地代理网关 API 接口，可实现如下：
    • 查询本地代理网关实例列表。
    • 搜索特定本地代理网关实例。
    • 查询一到多个本地代理网关实例信息。
    • 查询或重置本地代理网关实例的密钥。
    • 添加、编辑或删除本地代理网关实例。
    更多信息，请参见 开发者手册 - 本地代理网关。

功能优化和 Bug 修复

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

    注：
  • 支持通过导入文件更新分机信息 (路径：分机和中继 > 分机 > 导入)。
    导入文件时，若系统中已存在该分机号，将自动根据文件数据更新分机设置。
    注： 仅系统超级管理员支持此功能。
分机组
提升分机组的数量上限至 256。
通讯录
企业联系人信息中新增以下字段，以便更全面地记录联系人详情 (路径：通讯录 > 企业联系人)：

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

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

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

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

通话流程设计
修复 HTTP 请求组件问题：无法从 HTTP 响应中获取完整数据。
呼叫功能
提升以下呼叫功能的数量上限至 256：
  • 响铃组
  • IVR
  • 呼入队列
速拨码
支持为速拨码添加备注 (路径：呼叫功能 > 速拨码)。

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

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

邮件模板

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

事件通知
新增 通话并发数过高 事件通知 (路径：系统 > 事件通知 > 事件类型 > 系统)，当通话并发达到 PBX 上限时将触发该通知。
消息渠道
修复消息渠道问题：使用 NAT 映射的域名配置 Twilio SMS 短信渠道后，用户无法通过该渠道接收消息。
SIP 设置
支持自定义 SDP 会话参数，包括会话名称 (s= 行) 以及会话发起者 (o= 行) 中的 <username> 部分，以满足特定运营商或设备要求 (路径：PBX设置 > SIP设置 > 会话 > 会话参数配置)。

更多信息，请参见 SIP 设置。
SNMP
新增字段 EngineID，用于展示 SNMP 实体 (即 PBX) 的唯一标识符。该值为固定值，无法修改。

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

    更多信息，请参见 对接 Yeastar P 系列软件版 与 Microsoft Entra ID。

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

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

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

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

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

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 参数，可用于查询或设置企业联系人的对应信息。

    更多信息，请参见 开发者手册 - 通讯录。
    自动配置
    • phone/search、phone/get 和 phone/batchcreate 新增 onsite_proxy_uuid 参数，可用于查询或指定本地代理网关的 UUID。
    • phone/get 和 phone/batchcreate 接口的 provisioning_method 参数新增有效值 pnp_via_onsite_proxy 和 dhcp_via_onsite_proxy，可用于查询或指定自动配置话机时与本地代理网关相关的配置方式。
    呼入路由 呼入路由 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) 通话状态变更。