更新回访总结自定义字段

按 worksheetId 更新工单回访总结自定义字段值。请求体必须包含 worksheetId 和 customFields 数组；customFields 会按 WorksheetFollowUpCustomFieldVO 结构解析。worksheetId 缺失、非正数、工单不存在、工单已删除或企业管理员不存在时返回工单不存在错误。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
worksheetId	int64	是	工单 ID	123456
customFields	object[]	是	待更新的回访总结自定义字段列表	[{"fieldId":81001,"name":"回访结果","value":"用户已确认退款到账"}]
└fieldId	int64	否	字段定义 ID	81001
└name	string	否	字段名称	回访结果
└displayName	string	否	字段显示名称	客户回访结果
└type	int32	否	字段类型	1
└description	string	否	字段说明	记录客户对处理结果的反馈
└columnType	string	否	字段列类型	varchar
└editStatus	int32	否	字段是否可编辑	1
└rank	int32	否	字段排序序号	1
└value	string	否	字段值	用户已确认退款到账

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
data	object	工单回访总结自定义字段更新结果	{"worksheetId":123456,"customFields":[{"fieldId":81001,"name":"回访结果","value":"用户已确认退款到账"}]}
└worksheetId	int64	工单 ID	123456
└customFields	object[]	更新后的回访总结自定义字段列表	[{"fieldId":81001,"name":"回访结果","value":"用户已确认退款到账"}]
└fieldId	int64	字段定义 ID	81001
└name	string	字段名称	回访结果
└displayName	string	字段显示名称	客户回访结果
└type	int32	字段类型	1
└description	string	字段说明	记录客户对处理结果的反馈
└columnType	string	字段列类型	varchar
└editStatus	int32	字段是否可编辑	1
└rank	int32	字段排序序号	1
└value	string	字段值	用户已确认退款到账

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	time 缺失，或请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON；customFields 缺失或不是数组
14106	worksheetId 缺失、非正数、企业管理员不存在、工单不存在或工单已删除
14500	服务内部异常；服务处理失败

postEndpoint

/openapi/worksheet/followUp/customFields/update

curl -X POST "https://qiyukf.com/openapi/worksheet/followUp/customFields/update?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \  -H "Content-Type: application/json" \  -d '{    "worksheetId": 123456,    "customFields": [      {        "fieldId": 81001,        "name": "回访结果",        "value": "用户已确认退款到账"      }    ]  }'

{
  "code": 200,
  "data": {
    "worksheetId": 123456,
    "customFields": [
      {
        "fieldId": 81001,
        "name": "回访结果",
        "value": "用户已确认退款到账"
      }
    ]
  }
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "time 缺失，或请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体不是合法 JSON；customFields 缺失或不是数组"
}

{
  "code": 14106,
  "message": "worksheetId 缺失、非正数、企业管理员不存在、工单不存在或工单已删除"
}

{
  "code": 14500,
  "message": "服务内部异常；服务处理失败"
}