修改联系人标签

使用说明

• 移除好友的某个标签：先查出该好友当前所有标签 ID，去掉要移除的标签 ID，再把剩余标签 ID 传入 labelIdList。

• 给好友新增标签：先查出该好友当前所有标签 ID，再把新标签 ID 和原有标签 ID 一起传入 labelIdList。

• 批量添加或移除标签：需要逐个好友计算最终标签列表，并分别调用本接口。

接口地址： POST /modifyContactLabel

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 已确认目标好友 wcId。
• 已通过「获取标签列表」确认目标标签 ID。
• 业务系统需要保存或查询好友当前标签列表，避免覆盖掉其他已有标签。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	好友微信 ID
labelIdList	是	string	最终标签 ID 列表，多个标签用英文逗号分隔

请求示例

{
  "wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
  "wcId": "wxid_jg6e5v0b8bp322",
  "labelIdList": "1,2"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	null	无业务数据返回

成功响应

{
 "message": "成功",
 "code": "1000",
 "data": null
}

错误响应

{
 "message": "失败",
 "code": "1001",
 "data": null
}

使用建议

• 本接口传的是好友最终标签列表，不是增量追加或增量删除。
• 修改前务必先获取好友当前标签，合并后再提交，避免误删好友已有标签。
• 批量修改时建议逐个好友记录变更前后标签列表，方便回滚和排查。