如何通过Slack API更新用户资料自定义字段？更新失败排查

核心问题分析 #

调用users.profile.set接口时，非自定义字段（如status_text）更新成功，但自定义字段无变化，通常是权限缺失、字段ID错误或请求格式不符合要求导致。

修正后的请求示例 #

curl -X POST -H "Authorization: Bearer $USER_TOKEN" \
-H "Content-type: application/json; charset=UTF-8" \
-d '{
    "profile": {
        "fields": {
            "Xf015PPHEJKC": {
                "value": "username-using-api"
            }
        },
        "status_text": "api-status"
    },
    "user": "U02V1UA3YHL"
}' \
https://slack.com/api/users.profile.set | jq .

关键注意事项 #

• 权限验证：确保你的$USER_TOKEN拥有users.profile:write权限，这是更新用户自定义字段的必要前提。
• 字段ID核对：通过users.profile.get接口获取用户完整资料，确认Xf015PPHEJKC是目标自定义字段的正确ID：

  curl -X GET -H "Authorization: Bearer $USER_TOKEN" \
  "https://slack.com/api/users.profile.get?user=U02V1UA3YHL" | jq .profile.fields.Xf015PPHEJKC
  

• 简化请求格式：省略不必要的空值字段（如原请求中的skype、alt），避免API解析时忽略自定义字段的更新指令。

验证更新结果 #

执行更新后，再次调用users.profile.get接口，检查目标字段的value是否已更新为预期值。

内容的提问来源于stack exchange，提问作者Vishal Kapse