shopping-guide.addGuideBuyerTag

本接口应在服务器端调用,详细说明参见服务端API

为客户设置标签

单次请求接口,可选择一次设置一个客户(传openid)或者一次设置多个客户(传openid_list)

请求地址

POST https://api.weixin.qq.com/cgi-bin/guide/addguidebuyertag?access_token=ACCESS_TOKEN

请求参数

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
guide_account string 顾问微信号(guide_account和guide_openid二选一)
guide_openid string 顾问openid或者unionid(guide_account和guide_openid二选一)
openid string 客户openid
tag_value string 标签的可选值,该值必须在标签的可选值集合中
openid_list Array.<string> 客户列表,不超过200,openid和openid_list二选一

返回值

Object

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
buyer_resp Array.<Object> 客户列表添加结果,当请求openid_list列表大于0有意义

buyer_resp的结构

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
openid string 请求里的buyer_list客户openid

errcode 的合法值

说明 最低版本
0 成功
-1 系统失败
40003 无效的openid
43004 没有关注该服务号
9300801 无效的微信号
9300804 该微信号不是顾问
9300806 客户和顾问不存在绑定关系
9300807 可选值无效,不是标签的可选值

请求数据示例

{
  "guide_account": "wx_account",
  "openid": "xxxxxxx",
  "tag_value": "tag1"
}

或者

{
  "guide_account": "wx_account",
  "openid_list": [
        "xxxxxxx",
        "yyyyyyyy"
  ],
  "tag_value": "tag1"
}

返回数据示例

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

或者

{
  "errcode": 0,
  "errmsg": "ok",
  "buyer_resp": {
    [
        "errcode": 0,
        "errmsg": "ok",
        "openid": "xxxxxxx"
    ],
    [
        "errcode": 0,
        "errmsg": "ok",
        "openid": "yyyyyyyy"
    ]
  }
}