第三方应用开发 服务端API 客户联系 客户标签管理 编辑客户企业标签
编辑客户企业标签
最后更新:2023/12/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
编辑客户企业标签
最后更新:2023/12/01

企业可通过此接口为指定成员的客户添加上由企业统一配置的标签;注意,每个成员对同一个客户最多可以添加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_useriduserid的外部联系人。
add_tagremove_tag不可同时为空。
同一个标签组下现已支持多个标签

 

权限说明:
调用接口的应用需要满足如下的权限:

应用类型权限要求
自建应用配置到「客户联系 可调用接口的应用」中
代开发应用具有「客户基础信息」权限
第三方应用具有「客户基础信息」权限

应用只能编辑可见范围内的成员添加的企业客户标签。
如果要使用某个客户联系规则组下的企业客户标签,则规则组必须由同一个应用创建并且相关成员在规则组的管理范围内。

 

返回结果:

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

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
上一篇
管理企业标签
下一篇
管理企业规则组下的客户标签