Yeastar P 系列硬件版 37.21.0.16

发布日期：2025年11月10日

发布类型：计划更新

新功能

Red Hat SSO 集成
Yeastar P 系列 IPPBX 支持对接 Red Hat SSO，允许 Red Hat 用户使用其账号凭证单点登录 Linkus 桌面端和网页端。

更多信息，请参见 Red Hat SSO 对接手册。

DOD 特征码
Yeastar P 系列 IPPBX 支持通过特征码快速调用与监控去电显示号码 (DOD)，从而提升操作效率。相关功能如下：
主要功能 说明
DOD 短号 支持在中继中为每个去电显示号码分配一个唯一的短号 (路径：分机和中继 > 中继 > 去电显示号码 > 去电显示号码列表)。该短号可与 DOD 特征码配合使用，以快速选中特定 DOD 号码。
注： 仅通过 一到多个分机共同使用一个去电显示号码 模式添加的去电显示号码支持配置短号。

DOD 特征码 新增 去电显示号码前缀 特征码 (路径：呼叫功能 > 特征码 > 设置去电显示号码)，用于 DOD 号码管理。默认的特征码为 *085。

分机用户可结合此特征码与特定去电显示号码 (DOD) 或其分配的短号，快速选中特定 DOD 号码，将其设置为默认 DOD 或使用此 DOD 发起外呼。

更多信息，请参见 特征码 - 设置去电显示号码。
BLF 状态指示 支持通过自动配置将 DOD 特征码配置到 IP 话机的 BLF 键上。配置后，BLF 键可直观展示特定 DOD 号码当前是否被设置为指定分机的默认 DOD。

更多信息，请参见 自动配置话机功能键。

功能优化和 Bug 修复

分机
  • 支持在自定义 Popup URL 中使用以下新增变量 (路径：分机和中继 > 分机 > Linkus客户端 > 来电弹屏 > 使用自定义Popup URL来弹出联系人URL)：
    • .{{.DIDNumber}}：传递 DID 号码 (仅适用于外线来电)。
    • .{{.DIDName}}：传递 DID 名称 (仅适用于外线来电)。
    • .{{.StartTime}}：传递呼叫发起时间。
  • 修复语言设置问题：无法更改分机的邮件通知语言。
中继
SIP 中继新增以下配置项：
配置项 说明
高级设置 (路径：分机和中继 > 中继 > 注册中继 > 高级 > VoIP设置)
强制使用 SIP URI 格式 启用后，PBX 将在注册请求中，使用 sip: URI 格式替代 sips:。
注： 仅使用 TLS 或 DNS-NAPTR 协议的注册中继支持此配置项。
SIP 头域设置 (路径：分机和中继 > 中继 > SIP 头域 > 其他设置)
强制在From头域使用指定DOD 启用后，若分机选择特定 DOD 呼出外线，PBX 将忽略中继的 From User Part 设置，强制在 From 头域中使用选中的 DOD。
外线前转时返回302 启用后，若通过此中继路由的外线来电被前转至外部号码，PBX 将向主叫方发送 302 Moved Temporarily 响应，以便运营商直接处理呼叫重定向。
注： PBX 也支持处理 SIP 302 响应。收到此响应时，PBX 将根据主叫方的呼叫权限，重新向指定目的地发起呼叫。
自动配置
修复自定义模板问题：基于 YSDP_CiscoSPA5XX30X 话机型号新增自定义模板后，该模板未在列表中显示。
紧急号码
紧急号码的 配置呼出线路 设置新增配置项 删除前缀位数 (路径：呼叫控制 > 紧急号码 > 配置呼出线路)，可用于指定在发起呼叫前，从拨打的紧急号码开头移除的位数。

例如，删除前缀位数 设置为 1，当用户拨打 8110 时，PBX 会从紧急号码开头移除一位数字 (即 8)，最终呼出 110。

语音信箱
修复语音信箱问题：当在语音信箱菜单中按 6 将留言转发给其他分机时，系统同时向该语音信箱的号码发起了一通呼叫。
队列
修复队列通话记录问题：队列已禁用 坐席的IP话机显示未接来电记录 设置项，但是坐席通过 Linkus 客户端接听队列来电后，其 IP 话机仍显示有未接队列来电。
录音
新增配置项 启用广播/对讲录音 (路径：呼叫功能 > 录音)。若启用，所有广播和对讲通话将被自动录音。
注： 在通话期间，系统不会播放提示音通知参与方当前通话正在录音，且即使参与方的分机拥有录音控制权限，也无法暂停或停止录音。
常规设置
新增配置项 显示来电号码归属地，支持在 IP 话机上显示来电号码的归属地 (路径：PBX设置 > 常规设置 > 特色来电显示名称 > 显示来电号码归属地)。启用后，系统会将外部来电号码与系统内置的号码地区归属表进行匹配，若匹配成功，分机所注册的 IP 话机上会显示该号码对应的归属地。
注： 仅当分机注册在方位 (Fanvil) 话机上时支持显示归属地。具体的方位话机型号和固件，请咨询 Yeastar 技术支持。
SIP 设置
优化高级 SIP 设置：分机前转携带Diversion头域 设置中新增目的地类型 响铃组 (路径：PBX设置 > SIP设置 > 高级 > 其他选项)。

若选择此目的地类型，当分机来电被前转至响铃组，PBX 将在 INVITE 头域中携带 Diversion 头域，告知目的地此通话从哪个分机前转而来。
事件通知
优化 检测到固件新版本 事件通知：新增模板变量 {{.PBXCautiousUpgrade}}，如果检测到的新版本为 “谨慎升级版”，则提示你需要先备份再进行手动升级。

CRM / Helpdesk 集成
  • 优化自定义 CRM / Helpdesk 集成模板：
    • 用户关联设置中支持设置分页，允许 PBX 基于页码、偏移量或使用下一页链接等分页模式发送多次请求，从 CRM / Helpdesk 平台中获取完整的用户列表。

      更多信息，请参见 添加 CRM 集成模板 和 添加 Helpdesk 集成模板。

    • 优化模板管理：通过 PBX 管理网页变更模板设置并保存时，模板中的自定义配置内容仍会保留，以避免意外覆盖。
  • 优化 Dynamics 365 CRM 集成的来电显示：当收到 CRM 联系人通过 PBX 呼叫功能 (如队列、响铃组、通话流程等) 送入的来电时，来电界面将同时展示联系人姓名与具体呼叫功能名称，用户可根据此信息快速识别呼叫来源。

API
  • 优化以下功能的 API：
    功能 说明
    新增 录音功能设置 新增录音功能设置相关的 API 接口：
    • autorecord/get：该接口可用于查询录音功能的设置。
    • autorecord/update：该接口可用于更新录音功能的设置。

    更多信息，请参见 开发者手册 - 获取录音设置 和 开发者手册 - 编辑录音设置。
    优化 系统 优化 system/get_menuoptions 接口：新增请求参数值 custom_prompt，可用于查询系统中的自定义提示音。
    优化 中继 trunk/get、trunk/query、trunk/create 和 trunk/update 接口新增以下参数：
    • force_dod_from：此参数用于查询或设置 PBX 是否在分机选择特定 DOD 发起外呼时，忽略中继 From User Part 设置，强制在 From 头域中使用选中的 DOD 号码。
    • force_sip_uri_scheme：此参数用于查询或设置 PBX 在注册中继中是否使用 sip: URI 格式替代 sips:。
    • enb_send_302_on_cf_external：此参数用于查询或设置在将来电前转至外部号码时，PBX 是否会向主叫方发送 302 Moved Temporarily 响应。
    • outbound_cid_short_code：此参数用于查询或分配去电显示号码 (DOD) 的短号。
  • 修复 API Webhook 问题：通过 API Webhook 推送的事件通知未携带 type 事件类型参数。
  • 修复 API 事件问题：通话结束时未触发 30012 事件通知。
AI 文本生成语音
修复 AI 文本生成语音问题：系统无法生成捷克语音频文件。
升级
优化固件升级的用户体验：手动升级固件时，系统会弹出提示，提醒你在操作前先备份数据。

Linkus 网页端
  • 支持 Red Hat 用户通过单点登录 (SSO) 使用其 Red Hat 账号凭证登录 Linkus 网页端。
    注： 仅在你已将 PBX 与 Red Hat SSO 对接，并启用 单点登录 (SSO) 时支持此功能。

  • 优化来电弹屏功能：支持在自定义 Popup URL 中使用以下新增变量 (路径：设置 > 功能 > 来电弹屏 > 使用自定义Popup URL来弹出联系人URL)。
    • .{{.DIDNumber}}：传递 DID 号码 (仅适用于外线来电)。
    • .{{.DIDName}}：传递 DID 名称 (仅适用于外线来电)。
    • .{{.StartTime}}：传递呼叫发起时间。
  • 修复 AI 通话转写问题：当 Linkus 网页端处于 CTI 模式时，来电的通话界面中未出现 AI 通话转写按钮。