# shopping-guide.addGuideAcct
本接口应在服务器端调用,详细说明参见服务端API。
为服务号添加顾问
# 请求地址
POST https://api.weixin.qq.com/cgi-bin/guide/addguideacct?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token | string | 是 | 接口调用凭证 | |
guide_account | string | 是 | 顾问微信号(guide_account和guide_openid二选一,若同时请求,默认为guide_account) | |
guide_openid | string | 是 | 顾问openid或者unionid(guide_account和guide_openid二选一) | |
guide_headimgurl | string | 微信头像 | 否 | 顾问头像,头像url只能用《上传图文消息内的图片获取URL》 |
guide_nickname | string | 微信昵称 | 否 | 顾问昵称 |
# 返回值
# Object
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
errcode 的合法值
值 | 说明 | 最低版本 |
---|---|---|
0 | 成功 | |
-1 | 系统失败 | |
40003 | 无效的openid | |
43004 | 没有关注该服务号 | |
65407 | 该微信已经绑定为客服,不能再继续绑定顾问 | |
9300801 | 无效的微信号 | |
9300802 | 服务号未开通顾问功能 | |
9300803 | 该微信号已经绑定为顾问 | |
9300810 | 顾问昵称大于16个字 | |
9300812 | 顾问人数到达上限 |
# 请求数据示例
{
"guide_account": "wx_account",
"guide_headimgurl": "xxxxxxx",
"guide_nickname": "张三"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok"
}
# 事件推送
结果将推送给开发者
参数 MsgType=event Event=guide_invite_result_even
<guide_account></guide_account> <guide_openid></guide_openid> 仅返回请求值
</invite_result>只返回 1
# 示例
<xml><ToUserName><![CDATA[gh_95ad37df48fa]]></ToUserName>
<FromUserName><![CDATA[ou4sAuBkvP7vnN3uzOPwN6MEGl1U]]></FromUserName>
<CreateTime>1594346219</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[guide_invite_result_event]]></Event>
<GuideInviteEvent>
<guide_account><![CDATA[ihaveacat]]></guide_account>
<guide_openid></guide_openid>
<invite_result>1</invite_result>
</GuideInviteEvent></xml>