编辑客户企业标签

POST

http://127.0.0.1/cgi-bin/externalcontact/mark_tag

第三方应用开发/客户联系/客户标签管理

最后修改时间：2022-08-30 03:03:36

责任人：未设置

企业可通过此接口为指定成员的客户添加上由企业统一配置的标签。

权限说明：企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。第三方应用需具有“企业客户权限->客户基础信息”权限

文档ID: 16666
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/92118
https://open.work.weixin.qq.com/api/doc/90001/90143/92697

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

external_userid

string

必需

外部联系人userid

add_tag

array[string]

要标记的标签列表

可选

userid

string

必需

添加外部联系人的userid

remove_tag

array[string]

要移除的标签列表

可选

示例

{
  "userid": "zhangsan",
  "external_userid": "woAJ2GCAAAd1NPGHKSD4wKmE8Aabj9AAA",
  "add_tag": [
    "TAGID1",
    "TAGID2"
  ],
  "remove_tag": [
    "TAGID3",
    "TAGID4"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/externalcontact/mark_tag?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userid": "zhangsan",
    "external_userid": "woAJ2GCAAAd1NPGHKSD4wKmE8Aabj9AAA",
    "add_tag": [
        "TAGID1",
        "TAGID2"
    ],
    "remove_tag": [
        "TAGID3",
        "TAGID4"
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

示例

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

管理企业标签-删除企业客户标签

分配在职成员的客户