shopping-guide.addGuideBuyerRelation

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

为顾问分配客户

单次请求接口,可选择一次分配一个客户(传openid)或者一次分配多个(传buyer_list),建议使用buyer_list。 结果将推送给开发者。

请求地址

POST https://api.weixin.qq.com/cgi-bin/guide/addguidebuyerrelation?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(openid和buyer_list二选一)
buyer_nickname string 微信昵称 客户openid对应的昵称
buyer_list Array.<Object> 客户列表(不超过200,openid和buyer_list二选一)

返回值

Object

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

buyer_list结构

属性 类型 必填 说明
openid string 客户openid
buyer_nickname string 客户昵称

buyer_resp的结构

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

errcode 的合法值

说明 最低版本
0 成功
-1 系统失败
-1000 粉丝未关注公众号
40003 无效的openid
43004 没有关注该服务号
9300801 无效的微信号
9300804 顾问不存在
9300805 粉丝已绑定其它顾问
40032 客户列表大小不合法

请求数据示例

{
  "guide_account": "wx_account",
  "openid": "xxxxxxx",
  "buyer_nickname": "张三"
}

或者

{
  "guide_account": "wx_account",
  "buyer_list": {
    [
        "openid": "xxxxxxx",
        "buyer_nickname": "张三"
    ],
    [
        "openid": "yyyyyyyy",
        "buyer_nickname": "李四"
    ]
  }
}

返回数据示例

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

或者

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

事件推送

结果将推送给开发者

参数 MsgType=event Event=add_guide_buyer_relation_event

示例

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1546924844</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[add_guide_buyer_relation_event]]></Event>
  <errcode>0</errcode>
  <errmsg><![CDATA[ok]]></errmsg>
  <guide_account><![CDATA[xxxxx]]></guide_account>
  <guide_openid><![CDATA[yyyyyyyyyy]]></guide_openid>
  <buyer_openid><![CDATA[zzzzzzzz]]></buyer_openid>
</xml>