node-easywechat 2.7.2 → 2.8.0

package/dist/MiniProgram/Application.d.ts

@@ -10,6 +10,7 @@ import CustomerServiceClient from '../OfficialAccount/CustomerService/CustomerSe
 import UniformMessageClient from './UniformMessage/UniformMessageClient';
 import ActivityMessageClient from './ActivityMessage/ActivityMessageClient';
 import OpenDataClient from './OpenData/OpenDataClient';
+import PhoneNumberClient from './PhoneNumber/PhoneNumberClient';
 import PluginClient from './Plugin/PluginClient';
 import PluginDevClient from './Plugin/PluginDevClient';
 import MiniProgramBase from './Base/MiniProgramBase';
@@ -23,6 +24,7 @@ import SearchClient from './Search/SearchClient';
 import MediaClient from '../BaseService/Media/MediaClient';
 import ContentSecurityClient from '../BaseService/ContentSecurity/ContentSecurityClient';
 import { EasyWechatConfig } from '../Core/Types';
+import UrlLinkClient from './UrlLink/UrlLinkClient';
 import UrlSchemeClient from './UrlScheme/UrlSchemeClient';
 import RiskControlClient from './RiskControl/RiskControlClient';
 import LiveClient from './Live/LiveClient';
@@ -40,6 +42,7 @@ export default class MiniProgram extends BaseApplication {
     uniform_message: UniformMessageClient;
     activity_message: ActivityMessageClient;
     open_data: OpenDataClient;
+    phone_number: PhoneNumberClient;
     plugin: PluginClient;
     plugin_dev: PluginDevClient;
     base: MiniProgramBase;
@@ -52,6 +55,7 @@ export default class MiniProgram extends BaseApplication {
     search: SearchClient;
     media: MediaClient;
     content_security: ContentSecurityClient;
+    url_link: UrlLinkClient;
     url_scheme: UrlSchemeClient;
     risk_control: RiskControlClient;
     live: LiveClient;

package/dist/MiniProgram/Application.js

@@ -24,6 +24,7 @@ const CustomerServiceClient_1 = __importDefault(require("../OfficialAccount/Cust
 const UniformMessageClient_1 = __importDefault(require("./UniformMessage/UniformMessageClient"));
 const ActivityMessageClient_1 = __importDefault(require("./ActivityMessage/ActivityMessageClient"));
 const OpenDataClient_1 = __importDefault(require("./OpenData/OpenDataClient"));
+const PhoneNumberClient_1 = __importDefault(require("./PhoneNumber/PhoneNumberClient"));
 const PluginClient_1 = __importDefault(require("./Plugin/PluginClient"));
 const PluginDevClient_1 = __importDefault(require("./Plugin/PluginDevClient"));
 const MiniProgramBase_1 = __importDefault(require("./Base/MiniProgramBase"));
@@ -36,6 +37,7 @@ const RealtimeLogClient_1 = __importDefault(require("./RealtimeLog/RealtimeLogCl
 const SearchClient_1 = __importDefault(require("./Search/SearchClient"));
 const MediaClient_1 = __importDefault(require("../BaseService/Media/MediaClient"));
 const ContentSecurityClient_1 = __importDefault(require("../BaseService/ContentSecurity/ContentSecurityClient"));
+const UrlLinkClient_1 = __importDefault(require("./UrlLink/UrlLinkClient"));
 const UrlSchemeClient_1 = __importDefault(require("./UrlScheme/UrlSchemeClient"));
 const RiskControlClient_1 = __importDefault(require("./RiskControl/RiskControlClient"));
 const LiveClient_1 = __importDefault(require("./Live/LiveClient"));
@@ -55,6 +57,7 @@ class MiniProgram extends BaseApplication_1.default {
         this.uniform_message = null;
         this.activity_message = null;
         this.open_data = null;
+        this.phone_number = null;
         this.plugin = null;
         this.plugin_dev = null;
         this.base = null;
@@ -67,6 +70,7 @@ class MiniProgram extends BaseApplication_1.default {
         this.search = null;
         this.media = null;
         this.content_security = null;
+        this.url_link = null;
         this.url_scheme = null;
         this.risk_control = null;
         this.live = null;
@@ -126,6 +130,9 @@ class MiniProgram extends BaseApplication_1.default {
         this.offsetSet('open_data', function (app) {
             return new OpenDataClient_1.default(app);
         });
+        this.offsetSet('phone_number', function (app) {
+            return new PhoneNumberClient_1.default(app);
+        });
         this.offsetSet('plugin', function (app) {
             return new PluginClient_1.default(app);
         });
@@ -156,6 +163,9 @@ class MiniProgram extends BaseApplication_1.default {
         this.offsetSet('search', function (app) {
             return new SearchClient_1.default(app);
         });
+        this.offsetSet('url_link', function (app) {
+            return new UrlLinkClient_1.default(app);
+        });
         this.offsetSet('url_scheme', function (app) {
             return new UrlSchemeClient_1.default(app);
         });

package/dist/MiniProgram/PhoneNumber/PhoneNumberClient.d.ts

@@ -0,0 +1,10 @@
+import BaseClient from '../../Core/BaseClient';
+export default class PhoneNumber extends BaseClient {
+    /**
+     * 获取用户手机号
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/phonenumber/phonenumber.getPhoneNumber.html
+     * @param code [前端获取code方法](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/getPhoneNumber.html)
+     * @returns
+     */
+    getUserPhoneNumber(code: string): Promise<any>;
+}

package/dist/MiniProgram/PhoneNumber/PhoneNumberClient.js

@@ -0,0 +1,20 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseClient_1 = __importDefault(require("../../Core/BaseClient"));
+class PhoneNumber extends BaseClient_1.default {
+    /**
+     * 获取用户手机号
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/phonenumber/phonenumber.getPhoneNumber.html
+     * @param code [前端获取code方法](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/getPhoneNumber.html)
+     * @returns
+     */
+    getUserPhoneNumber(code) {
+        return this.httpPostJson('wxa/business/getuserphonenumber', {
+            code
+        });
+    }
+}
+exports.default = PhoneNumber;

package/dist/MiniProgram/Union/UnionClient.d.ts

@@ -10,4 +10,7 @@ export default class UnionClient extends BaseClient {
     getOrderInfo(orderIdList: string[]): Promise<any>;
     searchOrder(page?: number, startTimestamp?: string, endTimestamp?: string, commissionStatus?: string): Promise<any>;
     getFeaturedProducts(params: object): Promise<any>;
+    getTargetPlanInfo(params: object): Promise<any>;
+    applyJoinTargetPlan(params: object): Promise<any>;
+    getTargetPlanStatus(params: object): Promise<any>;
 }

package/dist/MiniProgram/Union/UnionClient.js

@@ -56,5 +56,14 @@ class UnionClient extends BaseClient_1.default {
     getFeaturedProducts(params) {
         return this.httpGet('union/promoter/product/select', params);
     }
+    getTargetPlanInfo(params) {
+        return this.httpGet('union/promoter/target/plan_info', params);
+    }
+    applyJoinTargetPlan(params) {
+        return this.httpPostJson('union/promoter/target/apply_target', params);
+    }
+    getTargetPlanStatus(params) {
+        return this.httpGet('union/promoter/target/apply_status', params);
+    }
 }
 exports.default = UnionClient;

package/dist/MiniProgram/UrlLink/UrlLinkClient.d.ts

@@ -0,0 +1,4 @@
+import BaseClient from '../../Core/BaseClient';
+export default class UrlLink extends BaseClient {
+    generate(params?: object): Promise<any>;
+}

package/dist/MiniProgram/UrlLink/UrlLinkClient.js

@@ -0,0 +1,12 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseClient_1 = __importDefault(require("../../Core/BaseClient"));
+class UrlLink extends BaseClient_1.default {
+    generate(params = {}) {
+        return this.httpPostJson('wxa/generate_urllink', params);
+    }
+}
+exports.default = UrlLink;

package/dist/Payment/Jssdk/JssdkClient.d.ts

@@ -23,4 +23,16 @@ export default class JssdkClient extends BaseClient {
      * @param json 是否返回json字符串，默认：true
      */
     shareAddressConfig(accessToken: string | AccessToken, json?: Boolean): Promise<any>;
+    /**
+     * 生成联系人配置
+     * @param params
+     * @param json 是否返回JSON字符串，默认：false
+     */
+    contractConfig(params: object, json?: Boolean): Promise<any>;
+    /**
+     * 生成小程序红包配置
+     * @param pkg
+     * @param json 是否返回JSON字符串，默认：false
+     */
+    miniprogramRedpackConfig(pkg: string, json?: Boolean): Promise<any>;
 }

package/dist/Payment/Jssdk/JssdkClient.js

@@ -86,5 +86,37 @@ class JssdkClient extends JssdkClient_1.default {
             return json ? JSON.stringify(params) : params;
         });
     }
+    /**
+     * 生成联系人配置
+     * @param params
+     * @param json 是否返回JSON字符串，默认：false
+     */
+    contractConfig(params, json = false) {
+        return __awaiter(this, void 0, void 0, function* () {
+            params['appid'] = this.app.config.app_id;
+            params['timestamp'] = Utils_1.getTimestamp() + '';
+            params['sign'] = Utils_1.makeSignature(params, this.app.config.key, 'md5');
+            return json ? JSON.stringify(params) : params;
+        });
+    }
+    /**
+     * 生成小程序红包配置
+     * @param pkg
+     * @param json 是否返回JSON字符串，默认：false
+     */
+    miniprogramRedpackConfig(pkg, json = false) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let params = {
+                appId: this.app.config.app_id,
+                timeStamp: Utils_1.getTimestamp() + '',
+                nonceStr: Utils_1.randomString(16),
+                package: pkg,
+            };
+            params['paySign'] = Utils_1.makeSignature(params, '', 'md5');
+            params['signType'] = 'MD5';
+            delete params.appId;
+            return json ? JSON.stringify(params) : params;
+        });
+    }
 }
 exports.default = JssdkClient;

package/dist/Work/ExternalContact/Client.d.ts

@@ -1,23 +1,166 @@
 import BaseClient from '../../Core/BaseClient';
 export default class ExternalContactClient extends BaseClient {
+    /**
+     * 获取配置了客户联系功能的成员列表
+     * @see https://work.weixin.qq.com/api/doc#90000/90135/91554
+     * @returns
+     */
     getFollowUsers(): Promise<any>;
+    /**
+     * 获取外部联系人列表
+     * @see https://work.weixin.qq.com/api/doc#90000/90135/91555
+     * @param userId
+     * @returns
+     */
     list(userId: string): Promise<any>;
+    /**
+     * 获取外部联系人详情
+     * @see https://work.weixin.qq.com/api/doc#90000/90135/91556
+     * @param externalUserId
+     * @returns
+     */
     get(externalUserId: string): Promise<any>;
-    batchGet(userId: string, cursor?: string, limit?: number): Promise<any>;
-    batchGetByUser(userId: string, cursor?: string, limit?: number): Promise<any>;
+    /**
+     * 批量获取客户详情
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92994
+     * @param userIdList
+     * @param cursor
+     * @param limit
+     * @returns
+     */
+    batchGet(userIdList: string[], cursor?: string, limit?: number): Promise<any>;
+    /**
+     * 批量获取外部联系人详情
+     * @see https://work.weixin.qq.com/api/doc/90001/90143/93010
+     * @param userIdList
+     * @param cursor
+     * @param limit
+     * @returns
+     */
+    batchGetByUser(userIdList: string[], cursor?: string, limit?: number): Promise<any>;
+    /**
+     * 修改客户备注信息
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92115
+     * @param data
+     * @returns
+     */
     remark(data: object): Promise<any>;
+    /**
+     * 获取离职成员的客户列表
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92124
+     * @param pageId
+     * @param pageSize
+     * @param cursor
+     * @returns
+     */
     getUnassigned(pageId?: number, pageSize?: number, cursor?: string): Promise<any>;
+    /**
+     * 离职成员的外部联系人再分配
+     * @see https://work.weixin.qq.com/api/doc#90000/90135/91564
+     * @param externalUserId
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @param transferSuccessMessage
+     * @returns
+     */
     transfer(externalUserId: string, handoverUserId: string, takeoverUserId: string, transferSuccessMessage: string): Promise<any>;
+    /**
+     * 分配在职成员的客户
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92125
+     * @param externalUserId
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @param transferSuccessMessage
+     * @returns
+     */
     transferCustomer(externalUserId: string, handoverUserId: string, takeoverUserId: string, transferSuccessMessage: string): Promise<any>;
+    /**
+     * 分配离职成员的客户
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/94081
+     * @param externalUserId
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @returns
+     */
     resignedTransferCustomer(externalUserId: string, handoverUserId: string, takeoverUserId: string): Promise<any>;
+    /**
+     * 离职成员的群再分配
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92127
+     * @param chatIds
+     * @param newOwner
+     * @returns
+     */
     transferGroupChat(chatIds: string[], newOwner: string): Promise<any>;
+    /**
+     * 查询客户接替状态
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/94082
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @param cursor
+     * @returns
+     */
     transferResult(handoverUserId: string, takeoverUserId: string, cursor?: string): Promise<any>;
+    /**
+     * 查询客户接替结果
+     * @see https://work.weixin.qq.com/api/doc/90001/90143/93009
+     * @param externalUserId
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @returns
+     */
     getTransferResult(externalUserId: string, handoverUserId: string, takeoverUserId: string): Promise<any>;
+    /**
+     * 获取客户群列表
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92120
+     * @param data
+     * @returns
+     */
     getGroupChats(data: object): Promise<any>;
-    getGroupChat(chatId: string): Promise<any>;
+    /**
+     * 获取客户群详情
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92122
+     * @param chatId
+     * @param needName
+     * @returns
+     */
+    getGroupChat(chatId: string, needName?: number): Promise<any>;
+    /**
+     * 获取企业标签库
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92117#获取企业标签库
+     * @param tagIds
+     * @param groupIds
+     * @returns
+     */
     getCorpTags(tagIds: string[], groupIds: string[]): Promise<any>;
+    /**
+     * 添加企业客户标签
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92117#添加企业客户标签
+     * @param data
+     * @returns
+     */
     addCorpTag(data: object): Promise<any>;
+    /**
+     * 编辑企业客户标签
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92117#编辑企业客户标签
+     * @param id
+     * @param name
+     * @param order
+     * @returns
+     */
     updateCorpTag(id: string, name?: string, order?: number): Promise<any>;
+    /**
+     * 删除企业客户标签
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92117#删除企业客户标签
+     * @param tagId
+     * @param groupId
+     * @returns
+     */
     deleteCorpTag(tagId: string[], groupId: string[]): Promise<any>;
+    /**
+     * 编辑客户企业标签
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92118
+     * @param data
+     * @returns
+     */
     markTags(data: object): Promise<any>;
 }

package/dist/Work/ExternalContact/Client.js

@@ -5,43 +5,105 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const BaseClient_1 = __importDefault(require("../../Core/BaseClient"));
 class ExternalContactClient extends BaseClient_1.default {
+    /**
+     * 获取配置了客户联系功能的成员列表
+     * @see https://work.weixin.qq.com/api/doc#90000/90135/91554
+     * @returns
+     */
     getFollowUsers() {
         return this.httpGet('cgi-bin/externalcontact/get_follow_user_list');
     }
+    /**
+     * 获取外部联系人列表
+     * @see https://work.weixin.qq.com/api/doc#90000/90135/91555
+     * @param userId
+     * @returns
+     */
     list(userId) {
         return this.httpGet('cgi-bin/externalcontact/list', {
             userid: userId,
         });
     }
+    /**
+     * 获取外部联系人详情
+     * @see https://work.weixin.qq.com/api/doc#90000/90135/91556
+     * @param externalUserId
+     * @returns
+     */
     get(externalUserId) {
         return this.httpGet('cgi-bin/externalcontact/get', {
             external_userid: externalUserId,
         });
     }
-    batchGet(userId, cursor = '', limit = 1) {
+    /**
+     * 批量获取客户详情
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92994
+     * @param userIdList
+     * @param cursor
+     * @param limit
+     * @returns
+     */
+    batchGet(userIdList, cursor = '', limit = 1) {
         return this.httpPostJson('cgi-bin/externalcontact/batch/get_by_user', {
-            userid: userId,
+            userid_list: userIdList,
             cursor,
             limit,
         });
     }
-    batchGetByUser(userId, cursor = '', limit = 1) {
+    /**
+     * 批量获取外部联系人详情
+     * @see https://work.weixin.qq.com/api/doc/90001/90143/93010
+     * @param userIdList
+     * @param cursor
+     * @param limit
+     * @returns
+     */
+    batchGetByUser(userIdList, cursor = '', limit = 1) {
         return this.httpPostJson('cgi-bin/externalcontact/batch/get_by_user', {
-            userid: userId,
+            userid_list: userIdList,
             cursor,
             limit,
         });
     }
+    /**
+     * 修改客户备注信息
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92115
+     * @param data
+     * @returns
+     */
     remark(data) {
         return this.httpPostJson('cgi-bin/externalcontact/remark', data);
     }
+    /**
+     * 获取离职成员的客户列表
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92124
+     * @param pageId
+     * @param pageSize
+     * @param cursor
+     * @returns
+     */
     getUnassigned(pageId = 0, pageSize = 1000, cursor = null) {
-        return this.httpPostJson('cgi-bin/externalcontact/get_unassigned_list', {
+        let params = {
             page_id: pageId,
             page_size: pageSize,
             cursor,
+        };
+        Object.keys(params).map(key => {
+            if (params[key] === null || params[key] === undefined) {
+                delete params[key];
+            }
         });
+        return this.httpPostJson('cgi-bin/externalcontact/get_unassigned_list', params);
     }
+    /**
+     * 离职成员的外部联系人再分配
+     * @see https://work.weixin.qq.com/api/doc#90000/90135/91564
+     * @param externalUserId
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @param transferSuccessMessage
+     * @returns
+     */
     transfer(externalUserId, handoverUserId, takeoverUserId, transferSuccessMessage) {
         return this.httpPostJson('cgi-bin/externalcontact/transfer', {
             external_userid: externalUserId,
@@ -50,6 +112,15 @@ class ExternalContactClient extends BaseClient_1.default {
             transfer_success_msg: transferSuccessMessage,
         });
     }
+    /**
+     * 分配在职成员的客户
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92125
+     * @param externalUserId
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @param transferSuccessMessage
+     * @returns
+     */
     transferCustomer(externalUserId, handoverUserId, takeoverUserId, transferSuccessMessage) {
         return this.httpPostJson('cgi-bin/externalcontact/transfer_customer', {
             external_userid: externalUserId,
@@ -58,6 +129,14 @@ class ExternalContactClient extends BaseClient_1.default {
             transfer_success_msg: transferSuccessMessage,
         });
     }
+    /**
+     * 分配离职成员的客户
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/94081
+     * @param externalUserId
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @returns
+     */
     resignedTransferCustomer(externalUserId, handoverUserId, takeoverUserId) {
         return this.httpPostJson('cgi-bin/externalcontact/resigned/transfer_customer', {
             external_userid: externalUserId,
@@ -65,12 +144,27 @@ class ExternalContactClient extends BaseClient_1.default {
             takeover_userid: takeoverUserId,
         });
     }
+    /**
+     * 离职成员的群再分配
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92127
+     * @param chatIds
+     * @param newOwner
+     * @returns
+     */
     transferGroupChat(chatIds, newOwner) {
         return this.httpPostJson('cgi-bin/externalcontact/groupchat/transfer', {
             chat_id_list: chatIds,
             new_owner: newOwner,
         });
     }
+    /**
+     * 查询客户接替状态
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/94082
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @param cursor
+     * @returns
+     */
     transferResult(handoverUserId, takeoverUserId, cursor = null) {
         return this.httpPostJson('cgi-bin/externalcontact/resigned/transfer_result', {
             handover_userid: handoverUserId,
@@ -78,6 +172,14 @@ class ExternalContactClient extends BaseClient_1.default {
             cursor,
         });
     }
+    /**
+     * 查询客户接替结果
+     * @see https://work.weixin.qq.com/api/doc/90001/90143/93009
+     * @param externalUserId
+     * @param handoverUserId
+     * @param takeoverUserId
+     * @returns
+     */
     getTransferResult(externalUserId, handoverUserId, takeoverUserId) {
         return this.httpPostJson('cgi-bin/externalcontact/get_transfer_result', {
             external_userid: externalUserId,
@@ -85,23 +187,58 @@ class ExternalContactClient extends BaseClient_1.default {
             takeover_userid: takeoverUserId,
         });
     }
+    /**
+     * 获取客户群列表
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92120
+     * @param data
+     * @returns
+     */
     getGroupChats(data) {
         return this.httpPostJson('cgi-bin/externalcontact/groupchat/list', data);
     }
-    getGroupChat(chatId) {
+    /**
+     * 获取客户群详情
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92122
+     * @param chatId
+     * @param needName
+     * @returns
+     */
+    getGroupChat(chatId, needName = 0) {
         return this.httpPostJson('cgi-bin/externalcontact/groupchat/get', {
             chat_id: chatId,
+            need_name: needName,
         });
     }
+    /**
+     * 获取企业标签库
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92117#获取企业标签库
+     * @param tagIds
+     * @param groupIds
+     * @returns
+     */
     getCorpTags(tagIds, groupIds) {
         return this.httpPostJson('cgi-bin/externalcontact/get_corp_tag_list', {
             tag_id: tagIds,
             group_id: groupIds,
         });
     }
+    /**
+     * 添加企业客户标签
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92117#添加企业客户标签
+     * @param data
+     * @returns
+     */
     addCorpTag(data) {
         return this.httpPostJson('cgi-bin/externalcontact/add_corp_tag', data);
     }
+    /**
+     * 编辑企业客户标签
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92117#编辑企业客户标签
+     * @param id
+     * @param name
+     * @param order
+     * @returns
+     */
     updateCorpTag(id, name = null, order = null) {
         let params = {
             id,
@@ -114,12 +251,25 @@ class ExternalContactClient extends BaseClient_1.default {
         }
         return this.httpPostJson('cgi-bin/externalcontact/edit_corp_tag', params);
     }
+    /**
+     * 删除企业客户标签
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92117#删除企业客户标签
+     * @param tagId
+     * @param groupId
+     * @returns
+     */
     deleteCorpTag(tagId, groupId) {
         return this.httpPostJson('cgi-bin/externalcontact/del_corp_tag', {
             tag_id: tagId,
             group_id: groupId,
         });
     }
+    /**
+     * 编辑客户企业标签
+     * @see https://work.weixin.qq.com/api/doc/90000/90135/92118
+     * @param data
+     * @returns
+     */
     markTags(data) {
         return this.httpPostJson('cgi-bin/externalcontact/mark_tag', data);
     }

package/dist/Work/ExternalContact/MessageClient.d.ts

@@ -5,8 +5,53 @@ export default class MessageClient extends BaseClient {
     protected imageMessage: object;
     protected linkMessage: object;
     protected miniprogramMessage: object;
+    /**
+     * 添加企业群发消息模板
+     * @param msg
+     * @returns
+     */
     submit(msg: object): Promise<any>;
+    /**
+     * 获取企业群发消息发送结果
+     * @param msgId
+     * @returns
+     */
     get(msgId: string): Promise<any>;
+    /**
+     * 获取群发记录列表
+     * @param chatType 群发任务的类型，默认为single，表示发送给客户，group表示发送给客户群
+     * @param startTime 群发任务记录开始时间
+     * @param endTime 群发任务记录结束时间
+     * @param creator 群发任务创建人企业账号id
+     * @param filterType 创建人类型。0：企业发表 1：个人发表 2：所有，包括个人创建以及企业创建，默认情况下为所有类型
+     * @param limit 返回的最大记录数，整型，最大值100，默认值50，超过最大值时取默认值
+     * @param cursor 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
+     * @returns
+     */
+    getGroupmsgListV2(chatType: string, startTime: number, endTime: number, creator?: string, filterType?: number, limit?: number, cursor?: string): Promise<any>;
+    /**
+     * 获取群发成员发送任务列表
+     * @param msgId 群发消息的id，通过获取群发记录列表接口返回
+     * @param limit 返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值
+     * @param cursor 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
+     * @returns
+     */
+    getGroupmsgTask(msgId: string, limit?: number, cursor?: string): Promise<any>;
+    /**
+     * 获取企业群发成员执行结果
+     * @param msgId 群发消息的id，通过获取群发记录列表接口返回
+     * @param userId 发送成员userid，通过获取群发成员发送任务列表接口返回
+     * @param limit 返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值
+     * @param cursor 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
+     * @returns
+     */
+    getGroupmsgSendResult(msgId: string, userId: string, limit?: number, cursor?: string): Promise<any>;
+    /**
+     * 发送新客户欢迎语
+     * @param welcomeCode
+     * @param msg
+     * @returns
+     */
     sendWelcome(welcomeCode: string, msg: object): Promise<any>;
     protected formatMessage(data: object): object;
     protected formatFields(data: object, defaults: object): object;

package/dist/Work/ExternalContact/MessageClient.js

@@ -26,15 +26,101 @@ class MessageClient extends BaseClient_1.default {
             page: '',
         };
     }
+    /**
+     * 添加企业群发消息模板
+     * @param msg
+     * @returns
+     */
     submit(msg) {
         let params = this.formatMessage(msg);
         return this.httpPostJson('cgi-bin/externalcontact/add_msg_template', params);
     }
+    /**
+     * 获取企业群发消息发送结果
+     * @param msgId
+     * @returns
+     */
     get(msgId) {
         return this.httpPostJson('cgi-bin/externalcontact/get_group_msg_result', {
             msgid: msgId,
         });
     }
+    /**
+     * 获取群发记录列表
+     * @param chatType 群发任务的类型，默认为single，表示发送给客户，group表示发送给客户群
+     * @param startTime 群发任务记录开始时间
+     * @param endTime 群发任务记录结束时间
+     * @param creator 群发任务创建人企业账号id
+     * @param filterType 创建人类型。0：企业发表 1：个人发表 2：所有，包括个人创建以及企业创建，默认情况下为所有类型
+     * @param limit 返回的最大记录数，整型，最大值100，默认值50，超过最大值时取默认值
+     * @param cursor 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
+     * @returns
+     */
+    getGroupmsgListV2(chatType, startTime, endTime, creator = null, filterType = null, limit = null, cursor = null) {
+        let params = {
+            chat_type: chatType,
+            start_time: startTime,
+            end_time: endTime,
+            creator: creator,
+            filter_type: filterType,
+            limit: limit,
+            cursor: cursor,
+        };
+        Object.keys(params).map(key => {
+            if (params[key] === null || params[key] === undefined) {
+                delete params[key];
+            }
+        });
+        return this.httpPostJson('cgi-bin/externalcontact/get_groupmsg_list_v2', params);
+    }
+    /**
+     * 获取群发成员发送任务列表
+     * @param msgId 群发消息的id，通过获取群发记录列表接口返回
+     * @param limit 返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值
+     * @param cursor 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
+     * @returns
+     */
+    getGroupmsgTask(msgId, limit = null, cursor = null) {
+        let params = {
+            msgid: msgId,
+            limit: limit,
+            cursor: cursor,
+        };
+        Object.keys(params).map(key => {
+            if (params[key] === null || params[key] === undefined) {
+                delete params[key];
+            }
+        });
+        return this.httpPostJson('cgi-bin/externalcontact/get_groupmsg_task', params);
+    }
+    /**
+     * 获取企业群发成员执行结果
+     * @param msgId 群发消息的id，通过获取群发记录列表接口返回
+     * @param userId 发送成员userid，通过获取群发成员发送任务列表接口返回
+     * @param limit 返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值
+     * @param cursor 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
+     * @returns
+     */
+    getGroupmsgSendResult(msgId, userId, limit = null, cursor = null) {
+        let params = {
+            msgid: msgId,
+            userid: userId,
+            limit: limit,
+            cursor: cursor,
+        };
+        Object.keys(params).map(key => {
+            if (params[key] === null || params[key] === undefined) {
+                delete params[key];
+            }
+        });
+        return this.httpPostJson('cgi-bin/externalcontact/get_groupmsg_send_result', params);
+    }
+    /**
+     * 发送新客户欢迎语
+     * @param welcomeCode
+     * @param msg
+     * @returns
+     */
     sendWelcome(welcomeCode, msg) {
         let formattedMsg = this.formatMessage(msg);
         let params = Utils_1.merge(Utils_1.merge({}, formattedMsg), {

package/node-easywechat.file_cache.easywechat.kernel.access_token.8a9684b45da7de42a06a70ba01a7005a.cache

@@ -1 +1 @@
-{"data":{"errcode":0,"errmsg":"ok","access_token":"moke-token","expires_in":7200},"lifeTime":1633062831}
+{"data":{"errcode":0,"errmsg":"ok","access_token":"moke-token","expires_in":7200},"lifeTime":1641409629}

package/node-easywechat.file_cache.easywechat.kernel.access_token.c3d06edaf326aad75d32f31348df787a.cache

@@ -1 +1 @@
-{"data":{"errcode":0,"errmsg":"ok"},"lifeTime":1633062831}
+{"data":{"errcode":0,"errmsg":"ok"},"lifeTime":1641409628}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-easywechat",
-  "version": "2.7.2",
+  "version": "2.8.0",
   "description": "EasyWechat SDK for Node.js (NOT OFFICIAL)",
   "main": "dist/index.js",
   "scripts": {