批量预打企业标签

POST

/open-api/wx_user/mark_tag

openapi

为unionid列表或者mobile列表中的客户添加预打企业标签。在添加好友时会自动打上企业标签。同时传了unionid_list和mobile_list优先以unionid_list为准。调用此接口需购买营销席位。

错误码	说明
20351	type错误
10002	标签参数错误

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

tag

object

标签

必需

integer

必需

企业标签的id,此id对应的企业标签必须对应，通过“获取标签列表”t_id字段获取

name

string

必需

企业标签名称,此企业标签名称必须存在

group_name

string

必需

企业标签组名称,企业标签组名称必须存在

unionid_list

array[string]

可选

unionid列表,列表最长1000， unionid_list和mobile_list必须传一个

mobile_list

array[string]

可选

mobile列表，列表最长1000， unionid_list和mobile_list必须传一个

unionid_openid_list

array [object {2}]

可选

unionid和openid列表,列表最长1000， mobile_list和unionid_openid_list必须传一个，仅密文企业使用

unionid

string

必需

微信用户unionid，不可以为空

openid

string

必需

微信用户openid，不可以为空

示例

{
    "tag": {
        "id": 67,
        "name": "标签1",
        "group_name": "组群1"
    },
    "unionid_list": [
        "omefmt_7WqYkqmF3LC1M0rtCQc30",
        "omefmt3Ahvg4sShVNtTjuNI3TsJs"
    ],
    "unionid_openid_list": [
        {
            "unionid": "omefmt_7WqYkqmF3LC1M0rtCQc30",
            "openid": "omefmt3Ahvg4sShVNtTjuNI3TsJs"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/wx_user/mark_tag?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tag": {
        "id": 67,
        "name": "标签1",
        "group_name": "组群1"
    },
    "unionid_list": [
        "omefmt_7WqYkqmF3LC1M0rtCQc30",
        "omefmt3Ahvg4sShVNtTjuNI3TsJs"
    ],
    "unionid_openid_list": [
        {
            "unionid": "omefmt_7WqYkqmF3LC1M0rtCQc30",
            "openid": "omefmt3Ahvg4sShVNtTjuNI3TsJs"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

🟢200正常返回

修改于 2024-03-12 03:49:29

获取预打标签信息

根据手机号删除预打标签任务