mirror of
https://github.com/silenceper/wechat.git
synced 2026-02-04 12:52:27 +08:00
8ceabc2d0b
* 添加微信客服SDK * polish:优化签名函数 * polish：优化注释内容 * polish:复用已有的Token以及CommonError,移除无用的输出 * polish:复用已有的消息加解密 * fix:修复错误信息被覆盖的问题 * polish:go fmt 文件
57 lines
1.9 KiB
Go
57 lines
1.9 KiB
Go
package kf
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
|
||
"github.com/silenceper/wechat/v2/util"
|
||
)
|
||
|
||
const (
|
||
customerBatchGetAddr = "https://qyapi.weixin.qq.com/cgi-bin/kf/customer/batchget?access_token=%s"
|
||
)
|
||
|
||
// CustomerBatchGetOptions 客户基本信息获取请求参数
|
||
type CustomerBatchGetOptions struct {
|
||
ExternalUserIDList []string `json:"external_userid_list"` // external_userid列表
|
||
}
|
||
|
||
// CustomerSchema 微信客户基本资料
|
||
type CustomerSchema struct {
|
||
ExternalUserID string `json:"external_userid"` // 微信客户的external_userid
|
||
NickName string `json:"nickname"` // 微信昵称
|
||
Avatar string `json:"avatar"` // 微信头像。第三方不可获取
|
||
Gender int `json:"gender"` // 性别
|
||
UnionID string `json:"unionid"` // unionid，需要绑定微信开发者帐号才能获取到，查看绑定方法: https://open.work.weixin.qq.com/kf/doc/92512/93143/94769#%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E5%AE%A2%E6%88%B7%E7%9A%84unionid
|
||
}
|
||
|
||
// CustomerBatchGetSchema 获取客户基本信息响应内容
|
||
type CustomerBatchGetSchema struct {
|
||
util.CommonError
|
||
CustomerList []CustomerSchema `json:"customer_list"` // 微信客户信息列表
|
||
InvalidExternalUserID []string `json:"invalid_external_userid"` // 无效的微信客户ID
|
||
}
|
||
|
||
// CustomerBatchGet 客户基本信息获取
|
||
func (r *Client) CustomerBatchGet(options CustomerBatchGetOptions) (info CustomerBatchGetSchema, err error) {
|
||
var (
|
||
accessToken string
|
||
data []byte
|
||
)
|
||
accessToken, err = r.ctx.GetAccessToken()
|
||
if err != nil {
|
||
return
|
||
}
|
||
data, err = util.PostJSON(fmt.Sprintf(customerBatchGetAddr, accessToken), options)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if err = json.Unmarshal(data, &info); err != nil {
|
||
return
|
||
}
|
||
if info.ErrCode != 0 {
|
||
return info, NewSDKErr(info.ErrCode, info.ErrMsg)
|
||
}
|
||
return info, nil
|
||
}
|