添加预打标签任务

已废弃

POST

/open-api/pre_tag/add

openapi

在客服未添加指定客户时给该客服指派预打标签的计划任务。在添加好友时会自动执行该打标签任务。请使用批量预打企业标签接口：http://openapi.weibanzhushou.com/api-9094169。

错误码	说明
20351	type错误
20352	请同时提供标签组名称和标签名称
20353	任务已存在,task_id为xxx。 task_id为预打标签在系统中的唯一id

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

type

string

必需

标签类型。corp-企业标签，internal-个人标签

unionid

string

必需

客户unionid。

tag_group

string

必需

新增标签组。在type为internal 打个人标签式无需此字段,在type为corp时必须带上此字段

tag_name

string

必需

新增标签名称。在执行预打标签任务时标签不存在则会创建标签

示例

{
  "type":"corp",
  "unionid": "oz9xvw_jfkmHMGWVSn5CatKSTOMU",
  "tag_group": "标签组1",
  "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/pre_tag/add?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type":"corp",
  "unionid": "oz9xvw_jfkmHMGWVSn5CatKSTOMU",
  "tag_group": "标签组1",
  "tag_name": "标签1"
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

状态码，0为正常，非0代表错误。

errmsg

string

必需

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

string

必需

创建的预打标签任务对应的id,对应删除预打标签接口中的task_id

示例

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

🟢200正常返回

修改于 2023-09-14 09:33:17

获取预打标签任务列表

获取客户事件列表