Merge branch 'release/1.0.0-alpha.2'

Author: xen0n

README.md

@@ -65,6 +65,8 @@ in at least 2 of Qiniu's internal systems.
 * [x] 消息发送 (除修改群聊会话外全部支持)
 * [x] 消息接收 (**接口尚不稳定，极有可能做出不兼容改动，先不要用**)
 * [x] 素材管理 (**支持上传**, 见下)
+* [ ] 会话内容存档
+* [x] 企业微信登录接口 (code2Session)
 
 <details>
 <summary>通讯录管理 API</summary>
@@ -109,7 +111,7 @@ in at least 2 of Qiniu's internal systems.
 <details>
 <summary>外部联系人管理 API</summary>
 
-* [ ] 离职成员的外部联系人再分配
+
 * [x] 成员对外信息
 * [x] 客户管理
     - [x] 获取客户列表
@@ -118,6 +120,11 @@ in at least 2 of Qiniu's internal systems.
 * [x] 客户标签管理
    - [x] 管理企业标签
    - [x] 编辑客户企业标签
+* [x] 客户分配
+   - [x] 获取离职成员列表
+   - [x] 分配在职或离职成员的客户
+   - [x] 查询客户接替结果
+   - [x] 分配离职成员的客户群
 * [x] 变更回调通知
     - [x] 添加企业客户事件
     - [x] 编辑企业客户事件
@@ -183,6 +190,16 @@ in at least 2 of Qiniu's internal systems.
 
 </details>
 
+<details>
+<summary>会话内容存档 API</summary>
+
+* [x] 获取会话内容存档开启成员列表
+* [x] 获取会话同意情况
+* [ ] 客户同意进行聊天内容存档事件回调
+* [x] 获取会话内容存档内部群信息
+
+</details>
+
 ## Notes
 
 ### 关于保密消息发送

apis.md.go

@@ -7,6 +7,7 @@ Name|Request Type|Response Type|Access Token|URL|Doc
 `execGetAccessToken`|`reqAccessToken`|`respAccessToken`|-|`GET /cgi-bin/gettoken`|[获取access_token](https://work.weixin.qq.com/api/doc#90000/90135/91039)
 `execGetJSAPITicket`|`reqJSAPITicket`|`respJSAPITicket`|+|`GET /cgi-bin/get_jsapi_ticket`|[获取企业的jsapi_ticket](https://open.work.weixin.qq.com/api/doc/90000/90136/90506)
 `execGetJSAPITicketAgentConfig`|`reqJSAPITicketAgentConfig`|`respJSAPITicket`|+|`GET /cgi-bin/ticket/get`|[获取应用的jsapi_ticket](https://open.work.weixin.qq.com/api/doc/90000/90136/90506)
+`execJSCode2Session`|`reqJSCode2Session`|`respJSCode2Session`|+|`GET /cgi-bin/miniprogram/jscode2session`|[临时登录凭证校验code2Session](https://open.work.weixin.qq.com/api/doc/90000/90136/91507)
 
 # 成员管理
 
@@ -88,6 +89,17 @@ Name|Request Type|Response Type|Access Token|URL|Doc
 `execExternalContactDelCorpTag`|`reqExternalContactDelCorpTag`|`respExternalContactDelCorpTag`|+|`POST /cgi-bin/externalcontact/del_corp_tag`|[删除企业客户标签](https://work.weixin.qq.com/api/doc/90000/90135/92117)
 `execExternalContactMarkTag`|`reqExternalContactMarkTag`|`respExternalContactMarkTag`|+|`POST /cgi-bin/externalcontact/mark_tag`|[标记客户企业标签](https://work.weixin.qq.com/api/doc/90000/90135/92118)
 
+# 外部联系人管理 - 客户分配
+
+## API calls
+
+Name|Request Type|Response Type|Access Token|URL|Doc
+:---|------------|-------------|------------|:--|:--
+`execListUnassignedExternalContact`|`reqListUnassignedExternalContact`|`respListUnassignedExternalContact`|+|`POST /cgi-bin/externalcontact/get_unassigned_list`|[获取离职成员的客户列表](https://work.weixin.qq.com/api/doc/90000/90135/92124)
+`execTransferExternalContact`|`reqTransferExternalContact`|`respTransferExternalContact`|+|`POST /cgi-bin/externalcontact/transfer`|[分配成员的客户](https://work.weixin.qq.com/api/doc/90000/90135/92125)
+`execGetTransferExternalContactResult`|`reqGetTransferExternalContactResult`|`respGetTransferExternalContactResult`|+|`POST /cgi-bin/externalcontact/get_transfer_result`|[查询客户接替结果](https://work.weixin.qq.com/api/doc/90000/90135/92973)
+`execTransferGroupChatExternalContact`|`reqTransferGroupChatExternalContact`|`respTransferGroupChatExternalContact`|+|`POST /cgi-bin/externalcontact/groupchat/transfer`|[离职成员的群再分配](https://work.weixin.qq.com/api/doc/90000/90135/92127)
+
 # 应用管理
 
 ## API calls
@@ -152,3 +164,15 @@ Name|Request Type|Response Type|Access Token|URL|Doc
 
 Name|Request Type|Response Type|Access Token|URL|Doc
 :---|------------|-------------|------------|:--|:--
+
+
+# 会话内容存档
+
+## API calls
+
+Name|Request Type|Response Type|Access Token|URL|Doc
+:---|------------|-------------|------------|:--|:--
+`execMsgAuditListPermitUser`|`reqMsgAuditListPermitUser`|`respMsgAuditListPermitUser`|+|`POST /cgi-bin/msgaudit/get_permit_user_list`|[获取会话内容存档开启成员列表](https://work.weixin.qq.com/api/doc/90000/90135/91614)
+`execMsgAuditCheckSingleAgree`|`reqMsgAuditCheckSingleAgree`|`respMsgAuditCheckSingleAgree`|+|`POST /cgi-bin/msgaudit/check_single_agree`|[获取会话同意情况（单聊）](https://work.weixin.qq.com/api/doc/90000/90135/91782)
+`execMsgAuditCheckRoomAgree`|`reqMsgAuditCheckRoomAgree`|`respMsgAuditCheckRoomAgree`|+|`POST /cgi-bin/msgaudit/check_room_agree`|[获取会话同意情况（群聊）](https://work.weixin.qq.com/api/doc/90000/90135/91782)
+`execMsgAuditGetGroupChat`|`reqMsgAuditGetGroupChat`|`respMsgAuditGetGroupChat`|+|`POST /cgi-bin/msgaudit/groupchat/get`|[获取会话内容存档内部群信息](https://work.weixin.qq.com/api/doc/90000/90135/92951)

docs/apis.md

@@ -181,3 +181,38 @@ Name|JSON|Type|Doc
 `ExternalUserID`|`external_userid`|`string`| 外部联系人userid
 `AddTag`|`add_tag`|`[]string`| 要标记的标签列表
 `RemoveTag`|`remove_tag`|`[]string`| 要移除的标签列表
+
+### `ExternalContactUnassignedList` 离职成员的客户列表
+
+Name|JSON|Type|Doc
+:---|:---|:---|:--
+`Info`|`info`|`[]ExternalContactUnassigned`| 离职成员的客户
+`IsLast`|`is_last`|`bool`| 是否是最后一条记录
+`NextCursor`|`next_cursor`|`string`| 分页查询游标,已经查完则返回空("")
+
+```go
+// ExternalContactTransferStatus 客户接替结果状态
+type ExternalContactTransferStatus uint8
+
+const (
+	// ExternalContactTransferStatusSuccess 1-接替完毕
+	ExternalContactTransferStatusSuccess ExternalContactTransferStatus = 1
+	// ExternalContactTransferStatusWait 2-等待接替
+	ExternalContactTransferStatusWait ExternalContactTransferStatus = 2
+	// ExternalContactTransferStatusRefused 3-客户拒绝
+	ExternalContactTransferStatusRefused ExternalContactTransferStatus = 3
+	// ExternalContactTransferStatusExhausted 4-接替成员客户达到上限
+	ExternalContactTransferStatusExhausted ExternalContactTransferStatus = 4
+	// ExternalContactTransferStatusNoData 5-无接替记录
+	ExternalContactTransferStatusNoData ExternalContactTransferStatus = 5
+)
+
+```
+
+### `ExternalContactGroupChatTransferFailed` 离职成员的群再分配失败
+
+Name|JSON|Type|Doc
+:---|:---|:---|:--
+`ChatID`|`chat_id`|`string`| 没能成功继承的群ID
+`ErrCode`|`errcode`|`int`| 没能成功继承的群，错误码
+`ErrMsg`|`errmsg`|`string`| 没能成功继承的群，错误描述

docs/external_contact.md

@@ -1,5 +1,9 @@
 package workwx
 
+import (
+	"time"
+)
+
 // ListExternalContact 获取客户列表
 func (c *WorkwxApp) ListExternalContact(userID string) ([]string, error) {
 	resp, err := c.execExternalContactList(reqExternalContactList{
@@ -81,3 +85,72 @@ func (c *WorkwxApp) MarkExternalContactTag(userID, externalUserID string, addTag
 	})
 	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
+}