mirror of
https://github.com/silenceper/wechat.git
synced 2026-02-23 13:42:25 +08:00
Compare commits
5 Commits
v2.1.6-rc.
...
d87f30e5e0
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
d87f30e5e0 | ||
|
|
7df3fe1a09 | ||
|
|
5a23c5c780 | ||
|
|
c84eb7b550 | ||
|
|
c2a8533781 |
@@ -9,6 +9,12 @@ import (
|
|||||||
|
|
||||||
const (
|
const (
|
||||||
getAccountBasicInfoURL = "https://api.weixin.qq.com/cgi-bin/account/getaccountbasicinfo"
|
getAccountBasicInfoURL = "https://api.weixin.qq.com/cgi-bin/account/getaccountbasicinfo"
|
||||||
|
checkNickNameURL = "https://api.weixin.qq.com/cgi-bin/wxverify/checkwxverifynickname"
|
||||||
|
setNickNameURL = "https://api.weixin.qq.com/wxa/setnickname"
|
||||||
|
setSignatureURL = "https://api.weixin.qq.com/cgi-bin/account/modifysignature"
|
||||||
|
setHeadImageURL = "https://api.weixin.qq.com/cgi-bin/account/modifyheadimage"
|
||||||
|
getSearchStatusURL = "https://api.weixin.qq.com/wxa/getwxasearchstatus"
|
||||||
|
setSearchStatusURL = "https://api.weixin.qq.com/wxa/changewxasearchstatus"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Basic 基础信息设置
|
// Basic 基础信息设置
|
||||||
@@ -51,3 +57,187 @@ func (basic *Basic) GetAccountBasicInfo() (*AccountBasicInfo, error) {
|
|||||||
// TODO
|
// TODO
|
||||||
// func (encryptor *Basic) modifyDomain() {
|
// func (encryptor *Basic) modifyDomain() {
|
||||||
// }
|
// }
|
||||||
|
|
||||||
|
// CheckNickNameResp 小程序名称检测结果
|
||||||
|
type CheckNickNameResp struct {
|
||||||
|
util.CommonError
|
||||||
|
HitCondition bool `json:"hit_condition"` // 是否命中关键字策略。若命中,可以选填关键字材料
|
||||||
|
Wording string `json:"wording"` // 命中关键字的说明描述
|
||||||
|
}
|
||||||
|
|
||||||
|
// CheckNickName 检测微信认证的名称是否符合规则
|
||||||
|
// ref: https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/basic-info-management/checkNickName.html
|
||||||
|
func (basic *Basic) CheckNickName(nickname string) (*CheckNickNameResp, error) {
|
||||||
|
ak, err := basic.GetAuthrAccessToken(basic.AppID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
url := fmt.Sprintf("%s?access_token=%s", checkNickNameURL, ak)
|
||||||
|
data, err := util.PostJSON(url, map[string]string{
|
||||||
|
"nick_name": nickname,
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &CheckNickNameResp{}
|
||||||
|
if err := util.DecodeWithError(data, result, "wxverify/checkwxverifynickname"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetNickNameResp 设置小程序名称结果
|
||||||
|
type SetNickNameResp struct {
|
||||||
|
util.CommonError
|
||||||
|
AuditID int64 `json:"audit_id"` // 审核单Id,通过用于查询改名审核状态
|
||||||
|
Wording string `json:"wording"` // 材料说明
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetNickNameParam 设置小程序名称参数
|
||||||
|
type SetNickNameParam struct {
|
||||||
|
NickName string `json:"nick_name"` // 昵称,不支持包含“小程序”关键字的昵称
|
||||||
|
IDCard string `json:"id_card,omitempty"` // 身份证照片 mediaid,个人号必填
|
||||||
|
License string `json:"license,omitempty"` // 组织机构代码证或营业执照 mediaid,组织号必填
|
||||||
|
NameingOtherStuff1 string `json:"naming_other_stuff_1,omitempty"` // 其他证明材料 mediaid,选填
|
||||||
|
NameingOtherStuff2 string `json:"naming_other_stuff_2,omitempty"` // 其他证明材料 mediaid,选填
|
||||||
|
NameingOtherStuff3 string `json:"naming_other_stuff_3,omitempty"` // 其他证明材料 mediaid,选填
|
||||||
|
NameingOtherStuff4 string `json:"naming_other_stuff_4,omitempty"` // 其他证明材料 mediaid,选填
|
||||||
|
NameingOtherStuff5 string `json:"naming_other_stuff_5,omitempty"` // 其他证明材料 mediaid,选填
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetNickName 设置小程序名称
|
||||||
|
func (basic *Basic) SetNickName(nickname string) (*SetNickNameResp, error) {
|
||||||
|
return basic.SetNickNameFull(&SetNickNameParam{
|
||||||
|
NickName: nickname,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetNickNameFull 设置小程序名称
|
||||||
|
// ref: https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/basic-info-management/setNickName.html
|
||||||
|
func (basic *Basic) SetNickNameFull(param *SetNickNameParam) (*SetNickNameResp, error) {
|
||||||
|
ak, err := basic.GetAuthrAccessToken(basic.AppID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
url := fmt.Sprintf("%s?access_token=%s", setNickNameURL, ak)
|
||||||
|
data, err := util.PostJSON(url, param)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &SetNickNameResp{}
|
||||||
|
if err := util.DecodeWithError(data, result, "setnickname"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetSignatureResp 小程序功能介绍修改结果
|
||||||
|
type SetSignatureResp struct {
|
||||||
|
util.CommonError
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetSignature 小程序修改功能介绍
|
||||||
|
// ref: https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/basic-info-management/setSignature.html
|
||||||
|
func (basic *Basic) SetSignature(signature string) error {
|
||||||
|
ak, err := basic.GetAuthrAccessToken(basic.AppID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
url := fmt.Sprintf("%s?access_token=%s", setSignatureURL, ak)
|
||||||
|
data, err := util.PostJSON(url, map[string]string{
|
||||||
|
"signature": signature,
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
return util.DecodeWithError(data, &SetSignatureResp{}, "account/modifysignature")
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetSearchStatusResp 查询小程序当前是否可被搜索
|
||||||
|
type GetSearchStatusResp struct {
|
||||||
|
util.CommonError
|
||||||
|
Status int `json:"status"` // 1 表示不可搜索,0 表示可搜索
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetSearchStatus 查询小程序当前是否可被搜索
|
||||||
|
// ref: https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/basic-info-management/getSearchStatus.html
|
||||||
|
func (basic *Basic) GetSearchStatus(signature string) (*GetSearchStatusResp, error) {
|
||||||
|
ak, err := basic.GetAuthrAccessToken(basic.AppID)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
url := fmt.Sprintf("%s?access_token=%s", getSearchStatusURL, ak)
|
||||||
|
data, err := util.HTTPGet(url)
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetSearchStatusResp{}
|
||||||
|
if err := util.DecodeWithError(data, result, "getwxasearchstatus"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetSearchStatusResp 小程序是否可被搜索修改结果
|
||||||
|
type SetSearchStatusResp struct {
|
||||||
|
util.CommonError
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetSearchStatus 修改小程序是否可被搜索
|
||||||
|
// status: 1 表示不可搜索,0 表示可搜索
|
||||||
|
// ref: https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/basic-info-management/setSearchStatus.html
|
||||||
|
func (basic *Basic) SetSearchStatus(status int) error {
|
||||||
|
ak, err := basic.GetAuthrAccessToken(basic.AppID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
url := fmt.Sprintf("%s?access_token=%s", setSearchStatusURL, ak)
|
||||||
|
data, err := util.PostJSON(url, map[string]int{
|
||||||
|
"status": status,
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
return util.DecodeWithError(data, &SetSearchStatusResp{}, "changewxasearchstatus")
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetHeadImageResp 小程序头像修改结果
|
||||||
|
type SetHeadImageResp struct {
|
||||||
|
util.CommonError
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetHeadImageParam 小程序头像修改参数
|
||||||
|
type SetHeadImageParam struct {
|
||||||
|
HeadImageMediaID string `json:"head_img_media_id"` // 头像素材 media_id
|
||||||
|
X1 string `json:"x1"` // 裁剪框左上角 x 坐标(取值范围:[0, 1])
|
||||||
|
Y1 string `json:"y1"` // 裁剪框左上角 y 坐标(取值范围:[0, 1])
|
||||||
|
X2 string `json:"x2"` // 裁剪框右下角 x 坐标(取值范围:[0, 1])
|
||||||
|
Y2 string `json:"y2"` // 裁剪框右下角 y 坐标(取值范围:[0, 1])
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetHeadImage 修改小程序头像
|
||||||
|
func (basic *Basic) SetHeadImage(imgMediaID string) error {
|
||||||
|
return basic.SetHeadImageFull(&SetHeadImageParam{
|
||||||
|
HeadImageMediaID: imgMediaID,
|
||||||
|
X1: "0",
|
||||||
|
Y1: "0",
|
||||||
|
X2: "1",
|
||||||
|
Y2: "1",
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetHeadImageFull 修改小程序头像
|
||||||
|
// 新增临时素材: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html
|
||||||
|
// ref: https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/basic-info-management/setHeadImage.html
|
||||||
|
func (basic *Basic) SetHeadImageFull(param *SetHeadImageParam) error {
|
||||||
|
ak, err := basic.GetAuthrAccessToken(basic.AppID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
url := fmt.Sprintf("%s?access_token=%s", setHeadImageURL, ak)
|
||||||
|
data, err := util.PostJSON(url, param)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
return util.DecodeWithError(data, &SetHeadImageResp{}, "account/modifyheadimage")
|
||||||
|
}
|
||||||
|
|||||||
@@ -9,6 +9,8 @@ import (
|
|||||||
const (
|
const (
|
||||||
// departmentSimpleListURL 获取子部门ID列表
|
// departmentSimpleListURL 获取子部门ID列表
|
||||||
departmentSimpleListURL = "https://qyapi.weixin.qq.com/cgi-bin/department/simplelist?access_token=%s&id=%d"
|
departmentSimpleListURL = "https://qyapi.weixin.qq.com/cgi-bin/department/simplelist?access_token=%s&id=%d"
|
||||||
|
// departmentListURL 获取部门列表
|
||||||
|
departmentListURL = "https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=%s"
|
||||||
)
|
)
|
||||||
|
|
||||||
type (
|
type (
|
||||||
@@ -23,6 +25,21 @@ type (
|
|||||||
ParentID int `json:"parentid"`
|
ParentID int `json:"parentid"`
|
||||||
Order int `json:"order"`
|
Order int `json:"order"`
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// DepartmentListResponse 获取部门列表响应
|
||||||
|
DepartmentListResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Department []*Department `json:"department"`
|
||||||
|
}
|
||||||
|
// Department 部门列表数据
|
||||||
|
Department struct {
|
||||||
|
ID int `json:"id"` // 创建的部门id
|
||||||
|
Name string `json:"name"` // 部门名称
|
||||||
|
NameEn string `json:"name_en"` // 英文名称
|
||||||
|
DepartmentLeader []string `json:"department_leader"` // 部门负责人的UserID
|
||||||
|
ParentID int `json:"parentid"` // 父部门id。根部门为1
|
||||||
|
Order int `json:"order"` // 在父部门中的次序值。order值大的排序靠前
|
||||||
|
}
|
||||||
)
|
)
|
||||||
|
|
||||||
// DepartmentSimpleList 获取子部门ID列表
|
// DepartmentSimpleList 获取子部门ID列表
|
||||||
@@ -45,3 +62,25 @@ func (r *Client) DepartmentSimpleList(departmentID int) ([]*DepartmentID, error)
|
|||||||
}
|
}
|
||||||
return result.DepartmentID, nil
|
return result.DepartmentID, nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// DepartmentList 获取部门列表
|
||||||
|
// @desc https://developer.work.weixin.qq.com/document/path/90208
|
||||||
|
func (r *Client) DepartmentList() ([]*Department, error) {
|
||||||
|
// 获取accessToken
|
||||||
|
accessToken, err := r.GetAccessToken()
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
// 发起http请求
|
||||||
|
response, err := util.HTTPGet(fmt.Sprintf(departmentListURL, accessToken))
|
||||||
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
// 按照结构体解析返回值
|
||||||
|
result := &DepartmentListResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "DepartmentList"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
// 返回数据
|
||||||
|
return result.Department, err
|
||||||
|
}
|
||||||
|
|||||||
658
work/externalcontact/moment.go
Normal file
658
work/externalcontact/moment.go
Normal file
@@ -0,0 +1,658 @@
|
|||||||
|
package externalcontact
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
|
||||||
|
"github.com/silenceper/wechat/v2/util"
|
||||||
|
)
|
||||||
|
|
||||||
|
const (
|
||||||
|
// addMomentTaskURL 创建发表任务
|
||||||
|
addMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_moment_task?access_token=%s"
|
||||||
|
// getMomentTaskResultURL 获取任务创建结果
|
||||||
|
getMomentTaskResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_task_result?access_token=%s&jobid=%s"
|
||||||
|
// cancelMomentTaskURL 停止发表企业朋友圈
|
||||||
|
cancelMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/cancel_moment_task?access_token=%s"
|
||||||
|
// getMomentListURL 获取企业全部的发表列表
|
||||||
|
getMomentListURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_list?access_token=%s"
|
||||||
|
// getMomentTaskURL 获取客户朋友圈企业发表的列表
|
||||||
|
getMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_task?access_token=%s"
|
||||||
|
// getMomentCustomerListURL 获取客户朋友圈发表时选择的可见范围
|
||||||
|
getMomentCustomerListURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_customer_list?access_token=%s"
|
||||||
|
// getMomentSendResultURL 获取客户朋友圈发表后的可见客户列表
|
||||||
|
getMomentSendResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_send_result?access_token=%s"
|
||||||
|
// getMomentCommentsURL 获取客户朋友圈的互动数据
|
||||||
|
getMomentCommentsURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_comments?access_token=%s"
|
||||||
|
// listMomentStrategyURL 获取规则组列表
|
||||||
|
listMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/list?access_token=%s"
|
||||||
|
// getMomentStrategyURL 获取规则组详情
|
||||||
|
getMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/get?access_token=%s"
|
||||||
|
// getRangeMomentStrategyURL 获取规则组管理范围
|
||||||
|
getRangeMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/get_range?access_token=%s"
|
||||||
|
// createMomentStrategyURL 创建新的规则组
|
||||||
|
createMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/create?access_token=%s"
|
||||||
|
// editMomentStrategyURL 编辑规则组及其管理范围
|
||||||
|
editMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/edit?access_token=%s"
|
||||||
|
// delMomentStrategyURL 删除规则组
|
||||||
|
delMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/del?access_token=%s"
|
||||||
|
)
|
||||||
|
|
||||||
|
// AddMomentTaskRequest 创建发表任务请求
|
||||||
|
type AddMomentTaskRequest struct {
|
||||||
|
Text MomentTaskText `json:"text"`
|
||||||
|
Attachments []MomentTaskAttachment `json:"attachments"`
|
||||||
|
VisibleRange MomentVisibleRange `json:"visible_range"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentTaskText 发表任务文本消息
|
||||||
|
type MomentTaskText struct {
|
||||||
|
Content string `json:"content"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentTaskImage 发表任务图片消息
|
||||||
|
type MomentTaskImage struct {
|
||||||
|
MediaID string `json:"media_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentTaskVideo 发表任务视频消息
|
||||||
|
type MomentTaskVideo struct {
|
||||||
|
MediaID string `json:"media_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentTaskLink 发表任务图文消息
|
||||||
|
type MomentTaskLink struct {
|
||||||
|
Title string `json:"title"`
|
||||||
|
URL string `json:"url"`
|
||||||
|
MediaID string `json:"media_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentTaskAttachment 发表任务附件
|
||||||
|
type MomentTaskAttachment struct {
|
||||||
|
MsgType string `json:"msgtype"`
|
||||||
|
Image MomentTaskImage `json:"image,omitempty"`
|
||||||
|
Video MomentTaskVideo `json:"video,omitempty"`
|
||||||
|
Link MomentTaskLink `json:"link,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentVisibleRange 朋友圈指定的发表范围
|
||||||
|
type MomentVisibleRange struct {
|
||||||
|
SenderList MomentSenderList `json:"sender_list"`
|
||||||
|
ExternalContactList MomentExternalContactList `json:"external_contact_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentSenderList 发表任务的执行者列表
|
||||||
|
type MomentSenderList struct {
|
||||||
|
UserList []string `json:"user_list"`
|
||||||
|
DepartmentList []int `json:"department_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentExternalContactList 可见到该朋友圈的客户列表
|
||||||
|
type MomentExternalContactList struct {
|
||||||
|
TagList []string `json:"tag_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// AddMomentTaskResponse 创建发表任务响应
|
||||||
|
type AddMomentTaskResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
JobID string `json:"jobid"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// AddMomentTask 创建发表任务
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/95094#%E5%88%9B%E5%BB%BA%E5%8F%91%E8%A1%A8%E4%BB%BB%E5%8A%A1
|
||||||
|
func (r *Client) AddMomentTask(req *AddMomentTaskRequest) (*AddMomentTaskResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(addMomentTaskURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &AddMomentTaskResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "AddMomentTask"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentTaskResultResponse 获取任务创建结果响应
|
||||||
|
type GetMomentTaskResultResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Status int `json:"status"`
|
||||||
|
Type string `json:"type"`
|
||||||
|
Result MomentTaskResult `json:"result"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentTaskResult 任务创建结果
|
||||||
|
type MomentTaskResult struct {
|
||||||
|
ErrCode int64 `json:"errcode"`
|
||||||
|
ErrMsg string `json:"errmsg"`
|
||||||
|
MomentID string `json:"moment_id"`
|
||||||
|
InvalidSenderList MomentInvalidSenderList `json:"invalid_sender_list"`
|
||||||
|
InvalidExternalContactList MomentInvalidExternalContactList `json:"invalid_external_contact_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentInvalidSenderList 不合法的执行者列表
|
||||||
|
type MomentInvalidSenderList struct {
|
||||||
|
UserList []string `json:"user_list"`
|
||||||
|
DepartmentList []int `json:"department_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentInvalidExternalContactList 不合法的可见到该朋友圈的客户列表
|
||||||
|
type MomentInvalidExternalContactList struct {
|
||||||
|
TagList []string `json:"tag_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentTaskResult 获取任务创建结果
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/95094#%E8%8E%B7%E5%8F%96%E4%BB%BB%E5%8A%A1%E5%88%9B%E5%BB%BA%E7%BB%93%E6%9E%9C
|
||||||
|
func (r *Client) GetMomentTaskResult(jobID string) (*GetMomentTaskResultResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.HTTPGet(fmt.Sprintf(getMomentTaskResultURL, accessToken, jobID)); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetMomentTaskResultResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetMomentTaskResult"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// CancelMomentTaskRequest 停止发表企业朋友圈请求
|
||||||
|
type CancelMomentTaskRequest struct {
|
||||||
|
MomentID string `json:"moment_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// CancelMomentTask 停止发表企业朋友圈
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/97612
|
||||||
|
func (r *Client) CancelMomentTask(req *CancelMomentTaskRequest) error {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(cancelMomentTaskURL, accessToken), req); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
return util.DecodeWithCommonError(response, "CancelMomentTask")
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentListRequest 获取企业全部的发表列表请求
|
||||||
|
type GetMomentListRequest struct {
|
||||||
|
StartTime int64 `json:"start_time"`
|
||||||
|
EndTime int64 `json:"end_time"`
|
||||||
|
Creator string `json:"creator"`
|
||||||
|
FilterType int `json:"filter_type"`
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
Limit int `json:"limit"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentListResponse 获取企业全部的发表列表响应
|
||||||
|
type GetMomentListResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
MomentList []MomentItem `json:"moment_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentItem 朋友圈
|
||||||
|
type MomentItem struct {
|
||||||
|
MomentID string `json:"moment_id"`
|
||||||
|
Creator string `json:"creator"`
|
||||||
|
CreateTime int64 `json:"create_time"`
|
||||||
|
CreateType int `json:"create_type"`
|
||||||
|
VisibleType int `json:"visible_type"`
|
||||||
|
Text MomentText `json:"text"`
|
||||||
|
Image []MomentImage `json:"image"`
|
||||||
|
Video MomentVideo `json:"video"`
|
||||||
|
Link MomentLink `json:"link"`
|
||||||
|
Location MomentLocation `json:"location"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentText 朋友圈文本消息
|
||||||
|
type MomentText struct {
|
||||||
|
Content string `json:"content"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentImage 朋友圈图片
|
||||||
|
type MomentImage struct {
|
||||||
|
MediaID string `json:"media_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentVideo 朋友圈视频
|
||||||
|
type MomentVideo struct {
|
||||||
|
MediaID string `json:"media_id"`
|
||||||
|
ThumbMediaID string `json:"thumb_media_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentLink 朋友圈网页链接
|
||||||
|
type MomentLink struct {
|
||||||
|
Title string `json:"title"`
|
||||||
|
URL string `json:"url"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentLocation 朋友圈地理位置
|
||||||
|
type MomentLocation struct {
|
||||||
|
Latitude string `json:"latitude"`
|
||||||
|
Longitude string `json:"longitude"`
|
||||||
|
Name string `json:"name"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentList 获取企业全部的发表列表
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E4%BC%81%E4%B8%9A%E5%85%A8%E9%83%A8%E7%9A%84%E5%8F%91%E8%A1%A8%E5%88%97%E8%A1%A8
|
||||||
|
func (r *Client) GetMomentList(req *GetMomentListRequest) (*GetMomentListResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(getMomentListURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetMomentListResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetMomentList"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentTaskRequest 获取客户朋友圈企业发表的列表请求
|
||||||
|
type GetMomentTaskRequest struct {
|
||||||
|
MomentID string `json:"moment_id"`
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
Limit int `json:"limit"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentTaskResponse 获取客户朋友圈企业发表的列表响应
|
||||||
|
type GetMomentTaskResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
TaskList []MomentTask `json:"task_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentTask 发表任务
|
||||||
|
type MomentTask struct {
|
||||||
|
UserID string `json:"userid"`
|
||||||
|
PublishStatus int `json:"publish_status"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentTask 获取客户朋友圈企业发表的列表
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E4%BC%81%E4%B8%9A%E5%8F%91%E8%A1%A8%E7%9A%84%E5%88%97%E8%A1%A8
|
||||||
|
func (r *Client) GetMomentTask(req *GetMomentTaskRequest) (*GetMomentTaskResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(getMomentTaskURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetMomentTaskResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetMomentTask"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentCustomerListRequest 获取客户朋友圈发表时选择的可见范围请求
|
||||||
|
type GetMomentCustomerListRequest struct {
|
||||||
|
MomentID string `json:"moment_id"`
|
||||||
|
UserID string `json:"userid"`
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
Limit int `json:"limit"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentCustomerListResponse 获取客户朋友圈发表时选择的可见范围响应
|
||||||
|
type GetMomentCustomerListResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
CustomerList []MomentCustomer `json:"customer_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentCustomer 成员可见客户列表
|
||||||
|
type MomentCustomer struct {
|
||||||
|
UserID string `json:"userid"`
|
||||||
|
ExternalUserID string `json:"external_userid"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentCustomerList 获取客户朋友圈发表时选择的可见范围
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E5%8F%91%E8%A1%A8%E6%97%B6%E9%80%89%E6%8B%A9%E7%9A%84%E5%8F%AF%E8%A7%81%E8%8C%83%E5%9B%B4
|
||||||
|
func (r *Client) GetMomentCustomerList(req *GetMomentCustomerListRequest) (*GetMomentCustomerListResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(getMomentCustomerListURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetMomentCustomerListResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetMomentCustomerList"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentSendResultRequest 获取客户朋友圈发表后的可见客户列表请求
|
||||||
|
type GetMomentSendResultRequest struct {
|
||||||
|
MomentID string `json:"moment_id"`
|
||||||
|
UserID string `json:"userid"`
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
Limit int `json:"limit"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentSendResultResponse 获取客户朋友圈发表后的可见客户列表响应
|
||||||
|
type GetMomentSendResultResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
CustomerList []MomentSendCustomer `json:"customer_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentSendCustomer 成员发送成功客户
|
||||||
|
type MomentSendCustomer struct {
|
||||||
|
ExternalUserID string `json:"external_userid"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentSendResult 获取客户朋友圈发表后的可见客户列表
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E5%8F%91%E8%A1%A8%E5%90%8E%E7%9A%84%E5%8F%AF%E8%A7%81%E5%AE%A2%E6%88%B7%E5%88%97%E8%A1%A8
|
||||||
|
func (r *Client) GetMomentSendResult(req *GetMomentSendResultRequest) (*GetMomentSendResultResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(getMomentSendResultURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetMomentSendResultResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetMomentSendResult"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentCommentsRequest 获取客户朋友圈的互动数据请求
|
||||||
|
type GetMomentCommentsRequest struct {
|
||||||
|
MomentID string `json:"moment_id"`
|
||||||
|
UserID string `json:"userid"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentCommentsResponse 获取客户朋友圈的互动数据响应
|
||||||
|
type GetMomentCommentsResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
CommentList []MomentComment `json:"comment_list"`
|
||||||
|
LikeList []MomentLike `json:"like_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentComment 朋友圈评论
|
||||||
|
type MomentComment struct {
|
||||||
|
ExternalUserID string `json:"external_userid,omitempty"`
|
||||||
|
UserID string `json:"userid,omitempty"`
|
||||||
|
CreateTime int64 `json:"create_time"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentLike 朋友圈点赞
|
||||||
|
type MomentLike struct {
|
||||||
|
ExternalUserID string `json:"external_userid,omitempty"`
|
||||||
|
UserID string `json:"userid,omitempty"`
|
||||||
|
CreateTime int64 `json:"create_time"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentComments 获取客户朋友圈的互动数据
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E7%9A%84%E4%BA%92%E5%8A%A8%E6%95%B0%E6%8D%AE
|
||||||
|
func (r *Client) GetMomentComments(req *GetMomentCommentsRequest) (*GetMomentCommentsResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(getMomentCommentsURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetMomentCommentsResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetMomentComments"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// ListMomentStrategyRequest 获取规则组列表请求
|
||||||
|
type ListMomentStrategyRequest struct {
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
Limit int `json:"limit"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// ListMomentStrategyResponse 获取规则组列表响应
|
||||||
|
type ListMomentStrategyResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Strategy []MomentStrategyID `json:"strategy"`
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentStrategyID 规则组ID
|
||||||
|
type MomentStrategyID struct {
|
||||||
|
StrategyID int `json:"strategy_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// ListMomentStrategy 获取规则组列表
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E5%88%97%E8%A1%A8
|
||||||
|
func (r *Client) ListMomentStrategy(req *ListMomentStrategyRequest) (*ListMomentStrategyResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(listMomentStrategyURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &ListMomentStrategyResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "ListMomentStrategy"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentStrategyRequest 获取规则组详情请求
|
||||||
|
type GetMomentStrategyRequest struct {
|
||||||
|
StrategyID int `json:"strategy_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentStrategyResponse 获取规则组详情响应
|
||||||
|
type GetMomentStrategyResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Strategy MomentStrategy `json:"strategy"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentStrategy 规则组
|
||||||
|
type MomentStrategy struct {
|
||||||
|
StrategyID int `json:"strategy_id"`
|
||||||
|
ParentID int `json:"parent_id"`
|
||||||
|
StrategyName string `json:"strategy_name"`
|
||||||
|
CreateTime int64 `json:"create_time"`
|
||||||
|
AdminList []string `json:"admin_list"`
|
||||||
|
Privilege MomentPrivilege `json:"privilege"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// MomentPrivilege 规则组权限
|
||||||
|
type MomentPrivilege struct {
|
||||||
|
ViewMomentList bool `json:"view_moment_list"`
|
||||||
|
SendMoment bool `json:"send_moment"`
|
||||||
|
ManageMomentCoverAndSign bool `json:"manage_moment_cover_and_sign"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetMomentStrategy 获取规则组详情
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E8%AF%A6%E6%83%85
|
||||||
|
func (r *Client) GetMomentStrategy(req *GetMomentStrategyRequest) (*GetMomentStrategyResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(getMomentStrategyURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetMomentStrategyResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetMomentStrategy"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetRangeMomentStrategyRequest 获取规则组管理范围请求
|
||||||
|
type GetRangeMomentStrategyRequest struct {
|
||||||
|
StrategyID int `json:"strategy_id"`
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
Limit int `json:"limit"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetRangeMomentStrategyResponse 获取规则组管理范围响应
|
||||||
|
type GetRangeMomentStrategyResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Range []RangeMomentStrategy `json:"range"`
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// RangeMomentStrategy 管理范围内配置的成员或部门
|
||||||
|
type RangeMomentStrategy struct {
|
||||||
|
Type int `json:"type"`
|
||||||
|
UserID string `json:"userid,omitempty"`
|
||||||
|
PartyID int `json:"partyid,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetRangeMomentStrategy 获取规则组管理范围
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4
|
||||||
|
func (r *Client) GetRangeMomentStrategy(req *GetRangeMomentStrategyRequest) (*GetRangeMomentStrategyResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(getRangeMomentStrategyURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetRangeMomentStrategyResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetRangeMomentStrategy"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// CreateMomentStrategyRequest 创建新的规则组请求
|
||||||
|
type CreateMomentStrategyRequest struct {
|
||||||
|
ParentID int `json:"parent_id"`
|
||||||
|
StrategyName string `json:"strategy_name"`
|
||||||
|
AdminList []string `json:"admin_list"`
|
||||||
|
Privilege MomentPrivilege `json:"privilege"`
|
||||||
|
Range []RangeMomentStrategy `json:"range"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// CreateMomentStrategyResponse 创建新的规则组响应
|
||||||
|
type CreateMomentStrategyResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
StrategyID int `json:"strategy_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// CreateMomentStrategy 创建新的规则组
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94890#%E5%88%9B%E5%BB%BA%E6%96%B0%E7%9A%84%E8%A7%84%E5%88%99%E7%BB%84
|
||||||
|
func (r *Client) CreateMomentStrategy(req *CreateMomentStrategyRequest) (*CreateMomentStrategyResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(createMomentStrategyURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &CreateMomentStrategyResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "CreateMomentStrategy"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// EditMomentStrategyRequest 编辑规则组及其管理范围请求
|
||||||
|
type EditMomentStrategyRequest struct {
|
||||||
|
StrategyID int `json:"strategy_id"`
|
||||||
|
StrategyName string `json:"strategy_name"`
|
||||||
|
AdminList []string `json:"admin_list"`
|
||||||
|
Privilege MomentPrivilege `json:"privilege"`
|
||||||
|
RangeAdd []RangeMomentStrategy `json:"range_add"`
|
||||||
|
RangeDel []RangeMomentStrategy `json:"range_del"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// EditMomentStrategy 编辑规则组及其管理范围
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94890#%E7%BC%96%E8%BE%91%E8%A7%84%E5%88%99%E7%BB%84%E5%8F%8A%E5%85%B6%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4
|
||||||
|
func (r *Client) EditMomentStrategy(req *EditMomentStrategyRequest) error {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(editMomentStrategyURL, accessToken), req); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
return util.DecodeWithCommonError(response, "EditMomentStrategy")
|
||||||
|
}
|
||||||
|
|
||||||
|
// DelMomentStrategyRequest 删除规则组请求
|
||||||
|
type DelMomentStrategyRequest struct {
|
||||||
|
StrategyID int `json:"strategy_id"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// DelMomentStrategy 删除规则组
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94890#%E5%88%A0%E9%99%A4%E8%A7%84%E5%88%99%E7%BB%84
|
||||||
|
func (r *Client) DelMomentStrategy(req *DelMomentStrategyRequest) error {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(delMomentStrategyURL, accessToken), req); err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
return util.DecodeWithCommonError(response, "DelMomentStrategy")
|
||||||
|
}
|
||||||
291
work/externalcontact/transfer.go
Normal file
291
work/externalcontact/transfer.go
Normal file
@@ -0,0 +1,291 @@
|
|||||||
|
package externalcontact
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
|
||||||
|
"github.com/silenceper/wechat/v2/util"
|
||||||
|
)
|
||||||
|
|
||||||
|
const (
|
||||||
|
// transferCustomerURL 分配在职成员的客户
|
||||||
|
transferCustomerURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/transfer_customer?access_token=%s"
|
||||||
|
// transferResultURL 查询客户接替状态
|
||||||
|
transferResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/transfer_result?access_token=%s"
|
||||||
|
// groupChatOnJobTransferURL 分配在职成员的客户群
|
||||||
|
groupChatOnJobTransferURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/onjob_transfer?access_token=%s"
|
||||||
|
// getUnassignedListURL 获取待分配的离职成员列表
|
||||||
|
getUnassignedListURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_unassigned_list?access_token=%s"
|
||||||
|
// resignedTransferCustomerURL 分配离职成员的客户
|
||||||
|
resignedTransferCustomerURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/resigned/transfer_customer?access_token=%s"
|
||||||
|
// resignedTransferResultURL 查询离职客户接替状态
|
||||||
|
resignedTransferResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/resigned/transfer_result?access_token=%s"
|
||||||
|
// groupChatTransferURL 分配离职成员的客户群
|
||||||
|
groupChatTransferURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/transfer?access_token=%s"
|
||||||
|
)
|
||||||
|
|
||||||
|
// TransferCustomerRequest 分配在职成员的客户请求
|
||||||
|
type TransferCustomerRequest struct {
|
||||||
|
HandoverUserID string `json:"handover_userid"`
|
||||||
|
TakeoverUserID string `json:"takeover_userid"`
|
||||||
|
ExternalUserID []string `json:"external_userid"`
|
||||||
|
TransferSuccessMsg string `json:"transfer_success_msg"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// TransferCustomerResponse 分配在职成员的客户请求响应
|
||||||
|
type TransferCustomerResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Customer []TransferCustomerItem `json:"customer"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// TransferCustomerItem 客户分配结果
|
||||||
|
type TransferCustomerItem struct {
|
||||||
|
ExternalUserID string `json:"external_userid"`
|
||||||
|
ErrCode int `json:"errcode"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// TransferCustomer 分配在职成员的客户
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/92125
|
||||||
|
func (r *Client) TransferCustomer(req *TransferCustomerRequest) (*TransferCustomerResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(transferCustomerURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &TransferCustomerResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "TransferCustomer"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// TransferResultRequest 查询客户接替状态请求
|
||||||
|
type TransferResultRequest struct {
|
||||||
|
HandoverUserID string `json:"handover_userid"`
|
||||||
|
TakeoverUserID string `json:"takeover_userid"`
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// TransferResultResponse 查询客户接替状态响应
|
||||||
|
type TransferResultResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Customer []TransferResultItem `json:"customer"`
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// TransferResultItem 客户接替状态
|
||||||
|
type TransferResultItem struct {
|
||||||
|
ExternalUserID string `json:"external_userid"`
|
||||||
|
Status int `json:"status"`
|
||||||
|
TakeoverTime int64 `json:"takeover_time"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// TransferResult 查询客户接替状态
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94088
|
||||||
|
func (r *Client) TransferResult(req *TransferResultRequest) (*TransferResultResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(transferResultURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &TransferResultResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "TransferResult"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GroupChatOnJobTransferRequest 分配在职成员的客户群请求
|
||||||
|
type GroupChatOnJobTransferRequest struct {
|
||||||
|
ChatIDList []string `json:"chat_id_list"`
|
||||||
|
NewOwner string `json:"new_owner"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GroupChatOnJobTransferResponse 分配在职成员的客户群响应
|
||||||
|
type GroupChatOnJobTransferResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
FailedChatList []FailedChat `json:"failed_chat_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// FailedChat 没能成功继承的群
|
||||||
|
type FailedChat struct {
|
||||||
|
ChatID string `json:"chat_id"`
|
||||||
|
ErrCode int `json:"errcode"`
|
||||||
|
ErrMsg string `json:"errmsg"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GroupChatOnJobTransfer 分配在职成员的客户群
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/95703
|
||||||
|
func (r *Client) GroupChatOnJobTransfer(req *GroupChatOnJobTransferRequest) (*GroupChatOnJobTransferResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(groupChatOnJobTransferURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GroupChatOnJobTransferResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GroupChatOnJobTransfer"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetUnassignedListRequest 获取待分配的离职成员列表请求
|
||||||
|
type GetUnassignedListRequest struct {
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
PageSize int `json:"page_size"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetUnassignedListResponse 获取待分配的离职成员列表响应
|
||||||
|
type GetUnassignedListResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Info []UnassignedListInfo `json:"info"`
|
||||||
|
IsLast bool `json:"is_last"`
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// UnassignedListInfo 离职成员信息
|
||||||
|
type UnassignedListInfo struct {
|
||||||
|
HandoverUserID string `json:"handover_userid"`
|
||||||
|
ExternalUserID string `json:"external_userid"`
|
||||||
|
DimissionTime int64 `json:"dimission_time"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetUnassignedList 获取待分配的离职成员列表
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/92124
|
||||||
|
func (r *Client) GetUnassignedList(req *GetUnassignedListRequest) (*GetUnassignedListResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(getUnassignedListURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GetUnassignedListResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GetUnassignedList"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// ResignedTransferCustomerRequest 分配离职成员的客户请求
|
||||||
|
type ResignedTransferCustomerRequest struct {
|
||||||
|
HandoverUserID string `json:"handover_userid"`
|
||||||
|
TakeoverUserID string `json:"takeover_userid"`
|
||||||
|
ExternalUserID []string `json:"external_userid"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// ResignedTransferCustomerResponse 分配离职成员的客户响应
|
||||||
|
type ResignedTransferCustomerResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Customer []TransferCustomerItem `json:"customer"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// ResignedTransferCustomer 分配离职成员的客户
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94081
|
||||||
|
func (r *Client) ResignedTransferCustomer(req *ResignedTransferCustomerRequest) (*ResignedTransferCustomerResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(resignedTransferCustomerURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &ResignedTransferCustomerResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "ResignedTransferCustomer"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// ResignedTransferResultRequest 查询离职客户接替状态请求
|
||||||
|
type ResignedTransferResultRequest struct {
|
||||||
|
HandoverUserID string `json:"handover_userid"`
|
||||||
|
TakeoverUserID string `json:"takeover_userid"`
|
||||||
|
Cursor string `json:"cursor"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// ResignedTransferResultResponse 查询离职客户接替状态响应
|
||||||
|
type ResignedTransferResultResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
Customer []TransferResultItem `json:"customer"`
|
||||||
|
NextCursor string `json:"next_cursor"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// ResignedTransferResult 查询离职客户接替状态
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/94082
|
||||||
|
func (r *Client) ResignedTransferResult(req *ResignedTransferResultRequest) (*ResignedTransferResultResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(resignedTransferResultURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &ResignedTransferResultResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "ResignedTransferResult"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// GroupChatTransferRequest 分配离职成员的客户群请求
|
||||||
|
type GroupChatTransferRequest struct {
|
||||||
|
ChatIDList []string `json:"chat_id_list"`
|
||||||
|
NewOwner string `json:"new_owner"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GroupChatTransferResponse 分配离职成员的客户群响应
|
||||||
|
type GroupChatTransferResponse struct {
|
||||||
|
util.CommonError
|
||||||
|
FailedChatList []FailedChat `json:"failed_chat_list"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GroupChatTransfer 分配离职成员的客户群
|
||||||
|
// see https://developer.work.weixin.qq.com/document/path/92127
|
||||||
|
func (r *Client) GroupChatTransfer(req *GroupChatTransferRequest) (*GroupChatTransferResponse, error) {
|
||||||
|
var (
|
||||||
|
accessToken string
|
||||||
|
err error
|
||||||
|
)
|
||||||
|
if accessToken, err = r.GetAccessToken(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
var response []byte
|
||||||
|
if response, err = util.PostJSON(fmt.Sprintf(groupChatTransferURL, accessToken), req); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
result := &GroupChatTransferResponse{}
|
||||||
|
if err = util.DecodeWithError(response, result, "GroupChatTransfer"); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
return result, nil
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user