企业可通过此接口为指定成员的客户添加上由企业统一配置的标签;注意,每个成员对同一个客户最多可以添加3000个标签。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token=ACCESS_TOKEN
请求示例:
{
"userid":"zhangsan",
"external_userid":"woAJ2GCAAAd1NPGHKSD4wKmE8Aabj9AAA",
"add_tag":["TAGID1","TAGID2"],
"remove_tag":["TAGID3","TAGID4"]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
userid | 是 | 添加外部联系人的userid |
external_userid | 是 | 外部联系人userid |
add_tag | 否 | 要标记的标签列表 |
remove_tag | 否 | 要移除的标签列表 |
请确保external_userid
是userid
的外部联系人。add_tag
和remove_tag
不可同时为空。
同一个标签组下现已支持多个标签
权限说明:
调用接口的应用需要满足如下的权限:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「客户联系 可调用接口的应用」中 |
代开发应用 | 具有「客户基础信息」权限 |
第三方应用 | 具有「客户基础信息」权限 |
应用只能编辑可见范围内的成员添加的企业客户标签。
如果要使用某个客户联系规则组下的企业客户标签,则规则组必须由同一个应用创建并且相关成员在规则组的管理范围内。
返回结果:
{
"errcode": 0,
"errmsg": "ok",
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |