群标签-打标签

最后更新：2025/12/22

企业可通过此接口为群聊打标签

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tag/chat_tag/mark_tag?access_token=x

参数说明：

参数 类型 必填 说明
access_token string 是 调用接口凭证

参数示例：

增量打标（mark_type=0）：

{
  "chat_id": "wrOBmQEAAAbDjC3UtXIJT2STVbVPCAAA",
  "mark_type": 0,
  "add_tag_id_list": ["67890", "67891"],
  "remove_tag_id_list": ["67892"]
}

全量覆盖（mark_type=1）：

{
  "chat_id": "wrOBmQEAAAbDjC3UtXIJT2STVbVPCAAA",
  "mark_type": 1,
  "rewrite_tag_id_list": ["67890", "67891"]
}
参数 类型 必填 说明
chat_id string 否 群ID
mark_type int 是 打标方式：0-增量添加或移除；1-全量覆盖
add_tag_id_list array 否 添加的标签ID列表，当mark_type=0时生效，add_tag_id_list和remove_tag_id_list不可同时为空，最多100个
remove_tag_id_list array 否 移除的标签ID列表，当mark_type=0时生效，add_tag_id_list和remove_tag_id_list不可同时为空，最多100个
rewrite_tag_id_list array 否 覆盖的标签ID列表，当mark_type=1时生效，最多100个

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": true
}

返回说明：

参数 类型 说明
code int 出错返回码，为0表示成功，非0表示调用失败
msg string 返回码描述
data boolean 打标结果，true表示成功，false表示失败

说明：

  • 当mark_type=0时，使用增量模式，可以通过add_tag_id_list添加标签，通过remove_tag_id_list移除标签
  • 当mark_type=1时，使用全量覆盖模式，会将群的所有标签替换为rewrite_tag_id_list中的标签
  • 每个列表最多支持100个标签ID

results matching ""

    No results matching ""