forked from xen0n/go-workwx
/
external_contact.go
169 lines (153 loc) · 5.37 KB
/
external_contact.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
package workwx
import (
"time"
)
// ListExternalContact 获取客户列表
func (c *WorkwxApp) ListExternalContact(userID string) ([]string, error) {
resp, err := c.execExternalContactList(reqExternalContactList{
UserID: userID,
})
if err != nil {
return nil, err
}
return resp.ExternalUserID, nil
}
// GetExternalContact 获取客户详情
func (c *WorkwxApp) GetExternalContact(externalUserid string) (*ExternalContactInfo, error) {
resp, err := c.execExternalContactGet(reqExternalContactGet{
ExternalUserID: externalUserid,
})
if err != nil {
return nil, err
}
return &resp.ExternalContactInfo, nil
}
// BatchListExternalContact 批量获取客户详情
func (c *WorkwxApp) BatchListExternalContact(userID string, cursor string, limit int) (*BatchListExternalContactsResp, error) {
resp, err := c.execExternalContactBatchList(reqExternalContactBatchList{
UserID: userID,
Cursor: cursor,
Limit: limit,
})
if err != nil {
return nil, err
}
return &BatchListExternalContactsResp{Result: resp.ExternalContactList, NextCursor: resp.NextCursor}, nil
}
// RemarkExternalContact 修改客户备注信息
func (c *WorkwxApp) RemarkExternalContact(req *ExternalContactRemark) error {
_, err := c.execExternalContactRemark(reqExternalContactRemark{
Remark: req,
})
return err
}
// ListExternalContactCorpTags 获取企业标签库
func (c *WorkwxApp) ListExternalContactCorpTags(tagIDs ...string) ([]ExternalContactCorpTagGroup, error) {
resp, err := c.execExternalContactListCorpTags(reqExternalContactListCorpTags{
TagIDs: tagIDs,
})
if err != nil {
return nil, err
}
return resp.TagGroup, nil
}
// AddExternalContactCorpTag 添加企业客户标签
func (c *WorkwxApp) AddExternalContactCorpTag(req ExternalContactCorpTagGroup) ([]ExternalContactCorpTagGroup, error) {
resp, err := c.execExternalContactAddCorpTag(reqExternalContactAddCorpTag{
ExternalContactCorpTagGroup: req,
})
if err != nil {
return nil, err
}
return resp.TagGroup, nil
}
// EditExternalContactCorpTag 编辑企业客户标签
func (c *WorkwxApp) EditExternalContactCorpTag(id, name string, order uint32) error {
_, err := c.execExternalContactEditCorpTag(reqExternalContactEditCorpTag{
ID: id,
Name: name,
Order: order,
})
return err
}
// DelExternalContactCorpTag 删除企业客户标签
func (c *WorkwxApp) DelExternalContactCorpTag(tagID, groupID []string) error {
_, err := c.execExternalContactDelCorpTag(reqExternalContactDelCorpTag{
TagID: tagID,
GroupID: groupID,
})
return err
}
// MarkExternalContactTag 标记客户企业标签
func (c *WorkwxApp) MarkExternalContactTag(userID, externalUserID string, addTag, removeTag []string) error {
_, err := c.execExternalContactMarkTag(reqExternalContactMarkTag{
UserID: userID,
ExternalUserID: externalUserID,
AddTag: addTag,
RemoveTag: removeTag,
})
return err
}
// ExternalContactUnassigned 离职成员的客户
type ExternalContactUnassigned struct {
// HandoverUserID 离职成员的userid
HandoverUserID string
// ExternalUserID 外部联系人userid
ExternalUserID string
// DemissionTime 成员离职时间
DemissionTime time.Time
}
// ListUnassignedExternalContact 获取离职成员的客户列表
func (c *WorkwxApp) ListUnassignedExternalContact(pageID, pageSize uint32, cursor string) (*ExternalContactUnassignedList, error) {
resp, err := c.execListUnassignedExternalContact(reqListUnassignedExternalContact{
PageID: pageID,
PageSize: pageSize,
Cursor: cursor,
})
if err != nil {
return nil, err
}
externalContactUnassignedList := resp.intoExternalContactUnassignedList()
return &externalContactUnassignedList, nil
}
// TransferExternalContact 分配成员的客户
func (c *WorkwxApp) TransferExternalContact(externalUserID, handoverUserID, takeoverUserID, transferSuccessMsg string) error {
_, err := c.execTransferExternalContact(reqTransferExternalContact{
ExternalUserID: externalUserID,
HandoverUserID: handoverUserID,
TakeoverUserID: takeoverUserID,
TransferSuccessMsg: transferSuccessMsg,
})
return err
}
// ExternalContactTransferResult 客户接替结果
type ExternalContactTransferResult struct {
// Status 接替状态, 1-接替完毕 2-等待接替 3-客户拒绝 4-接替成员客户达到上限 5-无接替记录
Status ExternalContactTransferStatus
// TakeoverTime 接替客户的时间,如果是等待接替状态,则为未来的自动接替时间
TakeoverTime time.Time
}
// GetTransferExternalContactResult 查询客户接替结果
func (c *WorkwxApp) GetTransferExternalContactResult(externalUserID, handoverUserID, takeoverUserID string) (*ExternalContactTransferResult, error) {
resp, err := c.execGetTransferExternalContactResult(reqGetTransferExternalContactResult{
ExternalUserID: externalUserID,
HandoverUserID: handoverUserID,
TakeoverUserID: takeoverUserID,
})
if err != nil {
return nil, err
}
externalContactTransferResult := resp.intoExternalContactTransferResult()
return &externalContactTransferResult, nil
}
// TransferGroupChatExternalContact 离职成员的群再分配
func (c *WorkwxApp) TransferGroupChatExternalContact(chatIDList []string, newOwner string) ([]ExternalContactGroupChatTransferFailed, error) {
resp, err := c.execTransferGroupChatExternalContact(reqTransferGroupChatExternalContact{
ChatIDList: chatIDList,
NewOwner: newOwner,
})
if err != nil {
return nil, err
}
return resp.FailedChatList, nil
}