# [废弃]标签下批量添加客户
[异步回调]标签下批量添加客户
【提示】建议直接使用企微自建应用,调用企微开平接口
说明:
企业微信的标签分为2种,一种为企业标签,一种个人标签。
个人标签由企业成员创建,只可面向个人使用。
若机器人无客户联系和客户群权限,则无法在企业标签下添加客户
请求方式:POST
请求地址:https://$basehost/gateway/qopen/SetRobotTagByCustomers
body参数:
{
"robot_id": "机器人id",
"tag_id": "标签id",
"contact_id_list": ["客户id"]
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
robot_id | string | 是 | 机器人id |
tag_id | string | 是 | 标签id |
contact_id_list | array | 是 | 客户id,注:客户编号不可为空(最多支持传入100个客户查询) |
返回值:
{
"data": {
"serial_no": "操作序列号",
"failed_list": ["客户id"]
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
serial_no | string | 操作序列号 |
failed_list | array | 操作失败的客户编号列表 |
hint | string | 请求日志ID |
处理结果,异步返回值:
{
"event_type": 702007,
"serial_no": "操作序列号",
"robot_id": "机器人id",
"err_code": 0,
"err_msg": "success",
"data": {
"tag_id": "标签id",
"tag_name": "标签名称",
"base64_tag_name": "base64加密后的标签名称",
"contact_id_list": [
"客户id"
],
"failed_contact_id_list": [
"客户id"
]
}
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
event_type | int | 事件类型,702007 |
serial_no | string | 操作序列号 |
err_code | int | 状态码,0为正常,非0代表错误 |
err_msg | string | 错误信息 |
robot_id | string | 机器人id |
data | object | 返回数据 |
data.tag_id | string | 标签id |
data.tag_name | string | 标签名称 |
data.base64_tag_name | string | base64加密后的标签名称 |
data.contact_id_list | array | 客户id列表 |
data.failed_contact_id_list | array | 操作失败的客户id列表 |
完整请求示例:
curl -X POST https://$basehost/gateway/qopen/SetRobotTagByCustomers \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id": "机器人id",
"tag_id": "标签id",
"contact_id_list": ["客户id"]
}'