将企业主体下的客户标签ID(含标签组ID)转换成服务商主体下的客户标签ID。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/idconvert/external_tagid?access_token=ACCESS_TOKEN
请求参数:
{
"external_tagid_list":["TAG_ID1","TAG_ID2","TAG_ID3","TAG_ID4"]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 ,第三方应用access_token或代开发应用access_token |
external_tagid_list | 是 | 企业主体下的客户标签ID或标签组ID列表,最多不超过1000个 |
权限说明:
应用需具有“企业客户权限->客户基础信息”权限
返回结果:
{
"errcode":0,
"errmsg":"ok",
"items":[
{
"external_tagid":"TAG_ID1",
"open_external_tagid":"OPEN_TAG_ID1"
},
{
"external_tagid":"TAG_ID2",
"open_external_tagid":"OPEN_TAG_ID2"
},
"invalid_external_tagid_list":["TAG_ID3","TAG_ID4"]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
items | 客户标签转换结果 |
items.external_tagid | 企业主体下的客户标签ID |
items.open_external_tagid | 服务商主体下的客户标签ID,如果传入的external_tagid已经是服务商主体下的ID,则open_external_tagid与external_tagid相同。 |
invalid_external_tagid_list | 无法转换的客户标签ID列表 |