添加user_id字段后Freshdesk工单转发API返回400错误排查

问题原因 #

你遇到的400错误核心原因是：user_id和to_emails字段在Freshdesk工单转发API中是互斥的，不能同时出现在请求体中。

根据API的设计逻辑：

• user_id用于将工单转发给Freshdesk系统内部的有效用户（如客服人员、已注册的联系人）
• to_emails用于将工单转发给外部邮箱地址

当你同时传入这两个参数时，API无法判定你要执行的是内部转发还是外部转发，因此返回invalid_field错误，即使文档中单独列出了这两个字段。

解决方案 #

根据你的实际需求二选一：

• 需求：转发给外部邮箱：移除请求体中的user_id字段，保留body和to_emails即可（这也是你之前请求正常的场景）。
• 需求：转发给内部用户：移除请求体中的to_emails字段，保留body和user_id，且user_id必须是系统中存在的有效用户ID（建议使用整数格式）。

验证示例 #

正确的外部转发请求体 #

{
  "body": "<p>The workflows for this ticket have been completed: '{workflowNumber}'</p><br><br>",
  "to_emails": ["{me}@{mycompany}.com"]
}

正确的内部转发请求体 #

{
  "body": "<p>The workflows for this ticket have been completed: '{workflowNumber}'</p><br><br>",
  "user_id": 2043094848729
}

相关错误信息 #

返回的响应内容：

{
  "description": "Validation failed",
  "errors": [
    {
      "field": "user_id",
      "message": "Unexpected/invalid field in request",
      "code": "invalid_field"
    }
  ]
}

使用的请求URI：
POST https://{mydomain}.freshdesk.com/api/v2/tickets/118730/forward

内容的提问来源于stack exchange，提问作者AJ L