微伴助手OpenAPI

批量预打企业标签

POST/open-api/wx_user/mark_tag

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

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

请求参数

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"
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

object {0}

{}

修改于 6 个月前