首页
/ Zammad 6.4版本API创建工单的邮件接收者验证机制解析

Zammad 6.4版本API创建工单的邮件接收者验证机制解析

2025-06-11 23:09:12作者:庞眉杨Will

在Zammad 6.4版本中,通过API创建邮件类型工单时新增了严格的接收者验证机制。这一变更源于对系统邮件发送可靠性的增强,确保所有邮件工单都具备有效的接收方信息。

核心变更点在于:

  1. 当创建类型为"email"的工单时,系统会强制验证接收者信息的有效性
  2. 验证逻辑会检查以下字段:
    • 客户账户必须包含有效的电子邮件地址
    • 或者通过"to"字段明确指定接收者
    • 亦可通过"cc"字段提供抄送地址

技术实现层面,该验证位于Ticket::Article模型的check_email_recipient_validity方法中。当系统检测到以下情况时会抛出InvalidAttribute异常:

  • 邮件工单缺少有效的接收者信息
  • 客户账户未配置有效邮箱且未提供to/cc字段

对于从6.3升级到6.4的用户,需要注意调整API调用方式。典型的合规请求应包含:

  • 在article部分添加有效的"to"字段
  • 或确保客户账户(customer_id)关联的用户配置了有效邮箱
  • 或使用"cc"字段指定抄送地址

这一改进虽然增加了配置要求,但有效防止了后续邮件发送失败的情况,提升了系统稳定性。开发者在使用API创建邮件工单时,应当确保请求参数包含必要的接收方信息,以避免422 Unprocessable Entity错误。

对于需要创建非邮件类工单的场景,可以指定其他工单类型(如"phone")来绕过邮件验证机制。这种设计既保证了邮件工单的可靠性,又保持了API的灵活性。

登录后查看全文
热门项目推荐