Yeastar P 系列硬件版 37.24.0.73-beta1

功能优化与 Bug 修复

订阅服务

优化 星纵数字维保服务 的详情展示和服务策略：

• 支持在 仪表盘 的 服务 栏，以及 订阅服务 列表中查看 星纵数字维保服务 的订阅详情。

  

• 订阅 星纵数字维保服务 后，可跨主功能版本升级 PBX 固件 (如 37.23.0.24 升级至 37.24.0.30)。未订阅时，仅支持在同一主功能版本基线范围内升级固件 (如 37.23.0.24 升级至 37.23.0.123)。

分机

• 支持为分机配置 呼叫确认。启用后，外部接听方在通话前被提示按键 (键 1 表示接听，键 # 表示拒接)， 以防止来电被语音信箱或其他自动系统应答。

  你可以为以下分机状态设置配置呼叫确认 (路径：分机和中继 > 分机 > > 状态)。

  • 设置为 手机号码 和 外部号码 的呼叫前转目的地。

    

  • 手机号码同时响铃 配置项。

    

• 修复分机列表显示问题：在多次修改并应用分机的呼叫前转设置后，分机列表加载失败。

SIP 中继

• 当 From User Part 设置为 中继去电显示号码 时，SIP INVITE 请求中会携带 Diversion 头域。

  

• 修复 SIP 中继状态显示问题：SIP 中继已注册成功且可正常使用，但列表中的中继状态显示为 (注册中)。

通讯录

修复外线来电响铃问题：当联系人姓名中包含字符 " 时，该联系人的来电不会响铃分机。

自动配置

• 支持通过自动配置在单台 IP 话机上注册多个分机。

  在配置过程中，你可以为话机分配多个分机，并指定在话机上使用哪个分机的联系人群组和功能键。

  注： 仅此功能仅适用于未被设置为共享话机的非 DECT IP 话机。

  

• 优化思科 (Cisco) 话机配置：支持直接在设备上通过 XML 目录服务访问和搜索分机的个人联系人和企业联系人。

  注： 此功能仅适用于非 SPA 系列的思科 (Cisco) IP 话机。

• 优化 Wildix 话机配置：提升从 PBX 系统同步至 Wildix WP480R3 / WP480R4 话机的联系人数量上限。

通话流程设计器

修复 HTTP请求 组件问题：如果通过 HTTP 请求组件返回的 JSON 响应包含带空格的字段，PBX 无法将响应结果存入变量。

IVR

支持为路由来电至响铃组或队列的 IVR 按键事件配置附加来电显示名称。

配置后，当按键事件被触发时，指定的名称将被拼接到原来电显示名称之前，并显示在成员或坐席的来电窗口中，以帮助他们快速识别主叫意图。

更多信息，请参见 设置按键事件的附加来电显示名称。

响铃组

• 支持添加外部号码作为响铃组成员。

  

• 新增以下响铃组配置项：
  • 生效分机的“总是”呼叫前转目的地：启用后，如果成员分机已设置 总是 呼叫前转目的地为 分机、手机号码 或 外部号码，该分机收到的响铃组来电将被直接前转至目的地，而该分机不响铃；响铃组中的其他成员仍按照响铃策略正常响铃。
  • 呼叫确认：启用后，外部号码成员收到响铃组来电时需进行呼叫确认。

更多信息，请参见 创建响铃组。

队列

新增以下队列配置项：

• 上次坐席路由：启用后，在指定时间范围内同一主叫的重复来电被路由至上一次应答该主叫来电的坐席。
• 生效分机的“总是”呼叫前转目的地：启用后，如果坐席分机已设置 总是 呼叫前转目的地为 分机、手机号码 或 外部号码，该分机收到的队列来电将被直接前转至目的地，而该分机不响铃；队列中的其他坐席仍按照响铃策略正常响铃。

更多信息，请参见 创建队列。

全渠道消息管理 (Omnichannel Messaging)

支持与 SMS 运营商 Clearfly 和 IZT Cloud Voice 对接。企业可以在 Yeastar P 系列 IPPBX 上为 Clearfly 和 IZT Cloud Voice 创建 SMS 短信渠道，以便企业员工可以在其 Linkus UC 客户端上接收和回复来自客户的短信。

系统偏好设置

新增选项 外部聊天已读回执 (路径：PBX设置 > 常规设置 > 已读回执)。

启用后，在通过在线消息渠道 (WhatsApp、Facebook 和 在线咨询) 进行的外部聊天中，坐席和客户均可在自己发送的消息旁看到已读状态标识，以了解消息是否已被对方阅读。

注： 对于 Linkus 手机端，用户需要将应用升级至以下版本：

• Linkus iOS 客户端：5.29.14 或更高版本
• Linkus 安卓客户端：5.29.12 或更高版本

归档

修复以下备份文件归档问题：

• 通过归档任务将备份文件归档至 FTP 服务器时，为任务配置的保留上限不生效。

• 将备份文件归档至 Amazon S3 的归档任务执行失败。

Zoho Desk 集成

修复 Zoho Desk 工单创建问题：当 Zoho Desk 配置为在通话开始前为外线来电创建工单时，路由到响铃组或队列的来电的工单创建失败。

Linkus SDK

优化来电推送逻辑：启用 Linkus SDK 但未上传证书时，Linkus 客户端仍可正常接收来电推送。

通话记录 (CDR)

• 优化通话详细信息展示：如果主叫号码或被叫号码匹配到联系人，其关联的公司名称将显示在对应字段旁。

  

• 修复通话详细信息展示问题：对于外线超时挂断的通话的详细信息中，最后状态 和 挂断方 字段显示错误通话信息。

通话报告

预约发送通话报告时，除固定日期外，还可配置相对时间范围 (如昨天、今天、上个月) 。

对于采用相对时间范围的循环预约，报告会根据系统时间动态生成。例如，若预约的时间范围选择 昨天，发送频率设置为 每天，系统会每天生成前一天的报告并发送至目标邮箱地址。

活动目录 (AD) 对接

修复 AD 同步问题：将 AD 组织单元同步至 PBX 组织后，显示的层级结构错误。

API

• 优化以下功能的 API 接口：

  功能	说明
  系统	system/get_menuoptions 接口优化参数 menu：新增 emoji 选项，可用于查询消息表情回复可用的表情符号。 更多信息，请参见 开发者手册 - 获取菜单选项。
  分机	extension/get、extension/query、extension/create 和 extension/update 接口新增 呼叫确认 相关参数，可用于查询或设置外部接收者在收到前转或同时响铃的呼叫时是否需要呼叫确认。 更多信息，请参见 开发者手册 - 分机。
  自动配置	phone/search、phone/get、phone/batchcreate 和 phone/batchupdate 接口新增参数 assigned_list、function_key_line 和 phonebook_line，可用于查询或设置分配的分机，以及要在话机上使用哪个分机的联系人群组和功能键。 更多信息，请参见 开发者手册 - 自动配置。
  IVR	ivr/get、ivr/query、ivr/create 和 ivr/updat 接口新增 附加来电显示名称 相关参数，可用于查询或设置按键事件的附加来电显示名称。 更多信息，请参见 开发者手册 - IVR。
  响铃组	新增接口 ringgroup/getoptions 和 ringgroup/updateoptions，可用于查询和设置全局响铃组设置。 ringgroup/get、ringgroup/query、ringgroup/create 和 ringgroup/update 接口新增 enb_extension_always_forward 和 外部号码 成员相关参数，可用于查询或配置对应的响铃组设置。 更多信息，请参见 开发者手册 - 响铃组。
  队列	queue_option/get 和 queue_option/update 接口新增参数 enb_transfer_to_voicemail，可用于查询或设置是否允许成员将来电前转至其分机语音信箱。 queue/get、queue/query、queue/create 和 queue/update 接口新增参数 enb_last_agent_routing、last_agent_routing_days 和 enb_extension_always_forward，可用于查询和配置对应的队列设置。 更多信息，请参见 开发者手册 - 队列。
  讯息管理	新增接口 message/reaction，可用于对活跃消息会话中的某条消息添加表情回复。 message/get 和 message/query 接口新增参数 quote，可用于查询引用回复中原始消息的详细信息。 message/send 接口新增参数 quote_msg_id，用于指定要被引用的消息。 更多信息，请参见 开发者手册 - 讯息管理。
  通话记录 (CDR)	cdr/list、cdr/detail 和 cdr/search 接口新增参数 call_to_company、call_from_company、last_participant_company 和 second_participant_company，可用于在主叫或被叫的号码匹配联系人时返回其公司名称。 注： 仅适用于 openapi/v2.0。 更多信息，请参见 开发者手册 - CDR (2.0)。

• 优化以下 API 事件：
  • 新增 API 事件 30038 (已读事件通知)，在第三方应用通过 PBX API 发送的消息被客户读取时触发。

    更多信息，请参见 开发者手册 - (30038) 已读事件通知。

  • API 事件 30012 (通话结束详情推送) 的参数 status 新增选择 ABANDONED，表示主叫在被叫接听前挂断电话。
• 修复 录音 功能的 API 接口问题：recording/search 接口的请求参数 start_time 和 end_time 不生效。