Yeastar P 系列云 PBX 84.23.0.23 V24.1-Beta

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

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

固件 84.23.0.23-beta1

发布日期:2026年4月23日

发布类型:公测版

基线版本:84.22.0.139

新功能

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

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

此外,此功能引入以下相关更新:

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

    更多信息,请参见 通过本地代理网关自动配置话机

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

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

  • 新增本地代理网关 API 接口,可实现如下:
    • 查询本地代理网关实例列表。
    • 搜索特定本地代理网关实例。
    • 查询一到多个本地代理网关实例信息。
    • 查询或重置本地代理网关实例的密钥。
    • 添加、编辑或删除本地代理网关实例。

    更多信息,请参见 开发者手册 - 本地代理网关

功能优化和 Bug 修复

分机
  • 分机号码的最大长度从 8 位增加到 11 位。
  • 支持一键复制分机在线设备的 IP 地址。

  • 支持在单个或批量创建及编辑分机时上传头像 (路径:分机和中继 > 分机 > 用户 > 用户信息)。
    注: 图片格式必须为 .jpg.png,文件大小不能超过 1 MB。

  • 优化分机呼叫前转设置 (路径:分机和中继 > 分机 > 状态 > 呼叫前转):
    • 新增目的地选项 忙碌。若选择此项且呼入到分机的来电满足前转条件,系统将拒绝此来电,并返回 SIP 响应码 486 Busy Here

    • 优化 忙时 前转条件的呼叫前转行为:当目的地设置为 挂断 且呼入到分机的来电满足前转条件,系统将拒绝此来电,并返回 SIP 响应码 480 Temporarily Unavailable (原为 486 Busy Here)。
  • 支持为分机配置彩铃 (路径:分机和中继 > 分机 > 功能 > 提示音)。当分机接到来电时,系统将在分机用户接听前向主叫方播放该铃声。

    更多信息,请参见 为分机配置彩铃

  • 修复以下分机问题:
    • 禁用分机的 接受来自响铃组的呼叫 设置后,当响铃组来电被转接到分机所在队列时,该分机无法接收到该来电。
    • 通过 API 编辑分机时将其手机号设置为 null,导致系统中需要选择成员的功能 (队列、响铃组、分机组、呼出路由等) 的成员选择列表无法显示任何分机。
Linkus 服务器
支持分机用户使用分机号登录 Linkus 客户端。你可以通过 Linkus客户端登录模式 设置启用此登录模式 (路径:分机和中继 > 分机 > Linkus服务器 > 基本)。

客户端权限
新增权限控制设置项 上传头像 (路径:分机和中继 > 客户端权限 > 客户端设置 > 配置项),可用于控制指定分机用户是否可在 Linkus UC 客户端上自行上传分机头像。

注: 对于 Linkus 手机端,用户需将其 Linkus 升级至以下版本:
  • Linkus iOS 端5.25.15 或更高版本
  • Linkus 安卓端5.25.12 或更高版本
中继
  • 新增 SIP 中继配置项 支持SIP REFER (路径:分机和中继 > 中继 > 高级 > VoIP设置)。启用后,可指定允许的转接目的地类型为 内部号码 和/或 外部号码。PBX 将处理通过此中继接收到的 REFER 请求,并按照其指示将通话转接至相应目的地。
    注:
    • 对于外部号码,PBX 在转接通话时会在 REFER 请求的目标号码前添加配置的前缀。
    • 仅支持盲转。

  • 修复通话问题:当通过启用 SRTP 的 SIP 中继外呼时,通话 15 分钟后出现单通,主叫无法听到被叫的声音。
自动配置
  • 新增自动配置选项 启用Yealink话机配置文件加密 (路径:自动配置 > 话机 > 选项),用于决定在自动配置过程中 PBX 是否对亿联 (Yealink) 话机的配置文件进行加密。

  • 支持在列表中一键复制 IP 话机的 IP 地址。

  • 为自动配置的 Mitel 话机新增 区别振铃 设置 (路径:自动配置 > 话机 > ),可配置Alert Info (提示信息) 和对应铃声。

  • 兼容 IP 话机的 48kHz Opus 采样率。PBX 能够正确处理来自 IP 话机使用此采样率的 RTP 音频流,提供更清晰的通话音质。
    注: 此兼容性不仅适用于通过自动配置部署的 IP 话机,同样适用于手动注册分机 (非自动配置) 的 IP 话机。
  • 修复自动配置问题:自动配置 Avaya IP 话机时将话机语言设置为 J169/J179 French 时,保存配置失败。
呼入路由
修复呼入路由问题:呼入路由名称过长,导致通过该路由送入的来电均失败。
呼叫队列
  • 优化队列管理员权限设置:新增以下队列通话记录相关配置项 (路径:呼叫功能 > 队列 > 队列面板权限 > 管理员

    配置项 说明
    队列呼入来电 启用后,队列管理员可查看队列中所有已接来电的通话记录。
    注: 仅支持查看 84.21.0.117 或更高版本中生成的通话记录,不支持此版本之前的历史队列通话记录。
    删除队列呼入来电 启用后,队列管理员可删除队列中的已接来电的通话记录。
    注: 若删除,该队列的所有坐席及管理员均无法查看被删除的记录,但记录仍保留在通话记录中。
  • 优化队列坐席权限设置:细化对已接通话记录查看范围的控制,分为以下两个选项 (路径:呼叫功能 > 队列 > 队列面板权限 > 坐席

    选项 说明
    仅个人 若选择此项,授权队列坐席仅可查看自己接听的队列通话记录。
    所有坐席 若选择此项,授权坐席可查看队列中所有坐席接听的队列通话记录。
    注: 仅支持查看 84.21.0.117 或更高版本中生成的通话记录,不支持此版本之前的历史队列通话记录。
  • 修复呼叫中心问题:队列看板上显示的时间比 PBX 的系统时间快一个小时。
语音留言
通话录音
  • 录音文件的下载大小限制从 600 MB 增加至 2 GB
  • 修复多方会议通话录音问题:由于与第三方平台的文件名格式不兼容,录音解析失败,导致同步至第三方平台的录音文件不完整。
话务标签
话务标签的数量上限从 20 增加至 200 个。
分机携带
修复分机携带问题:使用亿联 (Yealink) IP 话机作为共享话机时,随机出现用户登入或登出失败的情况。
讯息管理
  • SMS 渠道和 WhatsApp 渠道新增配置项 允许创建重复的活跃会话 (路径:讯息管理 > 消息渠道 > SMS 渠道/WhatsApp 渠道 > 消息设置)。

    启用后,若分机用户在 Linkus 客户端上创建会话时,渠道中已存在相同发送方和接收方的活跃会话,Linkus 将弹出以下提示。如果用户继续操作,原始会话将被该用户接管,并带有完整聊天记录。

    注: 对于 Linkus 手机端,用户需将其 Linkus 升级至以下版本:
    • Linkus iOS 端5.25.15 或更高版本
    • Linkus 安卓端5.25.12 或更高版本

  • 优化外部聊天记录管理 (路径:通话记录和录音 > 外部聊天记录)。
    • 支持根据 会话当前处理人 筛选聊天会话。

    • 新增快捷操作按钮 。可快速筛选出已被删除分机和队列的聊天会话。

    • 支持将一个或多个聊天会话转至指定目的地。

    更多信息,请参见 查看和管理外部聊天记录
PBX 设置
  • 特色来电显示名称 设置新增配置项 显示分机前转携带的Diversion头域 (路径:PBX设置 > 常规设置 > 来电显示名称)。

    若启用,当分机来电被前转至 分机前转携带Diversion头域 (路径:PBX设置 > SIP设置 > 高级 > 其他选项) 中指定的目的地类型时,来电显示将展示前转来电的分机名称和号码。
    注: IP 话机和 Linkus 客户端均可展示此信息。为确保在 Linkus 客户端上正常显示,分机用户必须将其 Linkus 客户端升级至以下版本:
    • Linkus 桌面端1.22.4 或更高版本
    • Linkus 手机端5.25.15 (iOS) / 5.25.12 (安卓) 或更高版本
  • 分机前转携带Diversion头域 设置新增目的地类型 队列 (路径:PBX设置 > SIP设置 > 高级 > 其他选项) 中。若选中,则分机来电被前转至队列时,INVITE 请求中将携带 Diversion 头域,告知目的地此通话从哪个分机前转而来。

  • 修复号码加密问题:启用 通过“二次开发接口”功能发起的呼叫 设置后,通过 API 发起呼叫时 Linkus 网页端上显示的主叫名称字段中的号码未被隐藏。
邮件模板
  • 支持设置邮件模板语言为西班牙语 (Spanish) (路径:系统 > 邮箱 > 邮件模板 > 邮件通知语言)。
  • 移除所有邮件模板底部的邮件落款。
归档
修复归档问题:将录音文件归档至 Amazon S3 失败。
活动目录 (AD) 集成
优化用户同步设置:
  • 字段匹配 栏中新增映射字段 头像。若勾选,系统将从 AD 域中同步用户头像至 PBX 分机。

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

    若禁用了特定字段的映射,则相应信息不会被同步,你可以直接在 PBX 上编辑该用户的信息。

更多信息,请参见 同步 AD 用户到 Yeastar P 系列云 PBX
协同办公平台集成
优化 自动绑定邮箱一致的分机和用户 启用时的用户匹配机制。
集成 说明
Microsoft Entra ID (Azure AD) 集成 PBX 使用 Microsoft Entra ID 用户的 用户主体名称 (而非 字段匹配 栏中设置的 邮箱地址 映射字段) 与 PBX 分机的邮箱地址进行匹配。
Google Workspace 集成 PBX 使用 Google Workspace 用户的 主要邮箱 (而非 字段匹配 栏中设置的 邮箱地址 映射字段) 与 PBX 分机的邮箱地址进行匹配。
注: 对于 活动目录 (AD) 集成Red Hat SSO 集成,PBX 仍使用 字段匹配 栏中设置的 邮箱地址 映射字段进行匹配。为确保匹配的一致性与安全性,强烈建议在身份提供方平台上限制用户自行修改其邮箱地址。
自定义 CRM / Helpdesk 集成模板

OAuth 2.0 鉴权模式新增 PKCE 授权码流程

在集成模板中配置 OAuth 2.0 认证时,可通过新增的 鉴权模式PKCE 验证方式 配置项 (路径:请求配置 > 认证方式) 来启用此模式。该模式使用 challenge-verifier 密钥对替代客户端密钥进行授权,可有效防止授权码被拦截,提高安全性。

更多信息,请参见 添加 CRM 集成模板添加 Helpdesk 集成模板
Dynamics 365 CRM 集成
修复通话录音问题:集成已启用 播放通话录音,但 Dynamics 365 通话活动中的录音字段始终为空。
API
优化以下功能的 API:
功能 说明
分机
  • 支持通过以下 API 接口查询或配置分机头像:
    • 新增 extension/uploadtempavatarfile 接口,可用于上传分机头像图片至 PBX,并返回文件 ID。
    • extension/getextension/queryextension/createextension/update 接口新增参数 avatar,可用于查询分机头像图片的文件 ID,或通过指定对应的文件 ID 来设置分机头像。
  • extension/getextension/queryextension/createextension/update 接口中,分机状态设置的目的地相关参数新增有效值 send_busy。若目的地为 send_busy,PBX 将拒接来电,并返回 SIP 响应码 486 Busy Here
更多信息,请参见 开发者手册 - 分机
中继 trunk/gettrunk/querytrunk/createtrunk/update 接口新增以下参数,可用于查询或配置 SIP REFER 相关设置:
  • refer_to_support:PBX 是否支持处理通过此中继接收到的 SIP REFER 转接请求。
  • refer_to_mode_list:允许的转接目的地类型 (内部分机和/或外部号码)。
  • refer_to_prefix:转接至外部号码时,需要在目标号码前添加的前缀。
更多信息,请参见 开发者手册 - 中继
语音留言
  • 新增接口 vm/forward,可用于将特定语音留言消息转发至一个或多个分机。
  • 接口 vm/getvm/query 新增参数 vm_detailInfo,若语音留言是由其他分机转发而来的,该参数将返回转发来源 (分机名称和分机号码)。
更多信息,请参见 开发者手册 - 语音留言
消息渠道 接口 message_channel/getmessage_channel/querymessage_channel/createmessage_channel/update 新增参数 enb_duplicate_active_session,可用于查询或配置消息渠道中是否允许创建重复会话。

更多信息,请参见 开发者手册 - 消息渠道

通话记录 (CDR)
修复预约通话记录问题:通话记录中可搜索到某联系人的通话记录,但下载此联系人的预约通话记录报告时信息为空。
通话报告
修复通话报告问题:查询 队列业绩 报告失败,系统返回 “请求超时” 的错误提示,但实际并未达到请求上限。