批量修改自定义字段的值

POST

/open-api/external_user/remark/custom_field/batch_update

指定外部联系人id和员工id，在该外部联系人详情页中所属指定员工的自定义信息中指定的字段添加/修改值，最多允许批量修改10个自定义字段的值

错误码	说明
21801	最多允许批量修改10个自定义字段
21802	参数option_id，field_value，field_datetime不能同时为空
21803	存在无效的员工或外部联系人
21804	存在无效的field_id
21805	存在无效的option_id
21806	存在外部联系人和员工没有好友关系
21807	存在字段类型和传入的参数不正确
21808	时间格式不正确
21809	缺少参数
21810	自定义信息更新失败，请重试
21811	field_id为${field_id}的自定义字段不存在
调用此接口需购买基础席位。

请求参数

Query 参数

Body 参数application/json

示例

{
    "data_list": [
        {
            "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
            "staff_id": "ZhangSan",
            "field_id": 10000,
            "option_id": 654
        },
        {
            "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
            "staff_id": "LiSi",
            "field_id": 9999,
            "field_value": "样例文本"
        },
        {
            "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
            "staff_id": "WangWu",
            "field_id": 343,
            "field_datetime": "2021-9-12 14:23:37"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://open.weibanzhushou.com/open-api/external_user/remark/custom_field/batch_update?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data_list": [
        {
            "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
            "staff_id": "ZhangSan",
            "field_id": 10000,
            "option_id": 654
        },
        {
            "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
            "staff_id": "LiSi",
            "field_id": 9999,
            "field_value": "样例文本"
        },
        {
            "external_user_id": "wm8xjUCAAAOgAFmo0QIZ6HrLb9kFP0zw",
            "staff_id": "WangWu",
            "field_id": 343,
            "field_datetime": "2021-9-12 14:23:37"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

成功示例成功示例

{
    "errcode": 0,
    "errmsg": "ok"
}

🟢200正常返回

修改于 2025-11-18 10:24:06

批量预设客户属性

创建批量加好友任务（批量创建添加客户任务）