给客户添加微伴个人标签

POST

/open-api/tag/internal/add

openapi

给指定客户微伴个人标签。如果指定标签不存在则会自动创建。微伴个人标签不存在标签组的概念。

标签总是和客服相关，所以打标签时同时需要提供客服的员工id。

错误码	说明
20350	external_user_id错误
20351	external_user_unionid错误
20352	请提供external_user_id或external_user_unionid
20353	找不到对应员工
调用此接口需购买基础席位。

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

staff_id

string

客服员工id

必需

external_user_id

string

可选

客户id。external_user_id 和 external_user_unionid 必须选择一个填写

external_user_unionid

string

可选

客户unionid。external_user_id 和 external_user_unionid 必须选择一个填写

external_user_openid

string

可选

客户openid。密文企业选择 external_user_unionid 时需填写

tag_name

string

新增标签名称

必需

示例

{
  "staff_id": "zhangsan",
  // external_user_id 和 external_user_unionid 只需填写一个
  "external_user_id": "wo8xjUCAAAGfqRyM0CGqryOsaKOYgEZE",
  "external_user_unionid": "oz9xvw_jfkmHMGWVSn5CatKSTOMU",
  "tag_name": "标签1"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/tag/internal/add?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
  "staff_id": "zhangsan",
  // external_user_id 和 external_user_unionid 只需填写一个
  "external_user_id": "wo8xjUCAAAGfqRyM0CGqryOsaKOYgEZE",
  "external_user_unionid": "oz9xvw_jfkmHMGWVSn5CatKSTOMU",
  "tag_name": "标签1"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

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

🟢200正常返回

删除客户的企业标签

删除客户的微伴个人标签