com.kdayun.wecom.cp.api

接口 WxCpExternalContactService

所有已知实现类:

WxCpExternalContactServiceImpl

public interface WxCpExternalContactService

<pre> 外部联系人管理接口，企业微信的外部联系人的接口和通讯录接口已经拆离 Created by Joe Cao on 2019/6/14 </pre>

作者:

JoeCao

方法概要

限定符和类型	方法和说明
WxCpContactWayResult	addContactWay(@NonNull WxCpContactWayInfo info) 配置客户联系「联系我」方式 <pre> 企业可以在管理后台-客户联系中配置成员的「联系我」的二维码或者小程序按钮，客户通过扫描二维码或点击小程序上的按钮，即可获取成员联系方式，主动联系到成员。
WxCpUserExternalTagGroupInfo	addCorpTag(WxCpUserExternalTagGroupInfo tagGroup) <pre> 企业可通过此接口向客户标签库中添加新的标签组和标签，每个企业最多可配置3000个企业标签。
java.lang.String	addGroupWelcomeTemplate(WxCpGroupWelcomeTemplateResult template) <pre> 添加入群欢迎语素材。
WxCpAddMomentResult	addMomentTask(WxCpAddMomentTask task) <pre> 企业和第三方应用可通过该接口创建客户朋友圈的发表任务。
WxCpMsgTemplateAddResult	addMsgTemplate(WxCpMsgTemplate wxCpMsgTemplate) 添加企业群发消息任务 企业可通过此接口添加企业群发消息的任务并通知客服人员发送给相关客户或客户群。
WxCpBaseResp	closeTempChat(@NonNull java.lang.String userId, @NonNull java.lang.String externalUserId) 结束临时会话 <pre> 将指定的企业成员和客户之前的临时会话断开，断开前会自动下发已配置的结束语。
java.lang.String	convertToOpenid(java.lang.String externalUserid) 企业和服务商可通过此接口，将微信外部联系人的userid转为微信openid，用于调用支付相关接口。
WxCpBaseResp	delCorpTag(java.lang.String[] tagId, java.lang.String[] groupId) <pre> 企业可通过此接口删除客户标签库中的标签，或删除整个标签组。
WxCpBaseResp	deleteContactWay(@NonNull java.lang.String configId) 删除企业已配置的「联系我」方式 <pre> 删除一个已配置的「联系我」二维码或者「联系我」小程序按钮。
WxCpBaseResp	delGroupWelcomeTemplate(java.lang.String templateId, java.lang.String agentId) <pre> 删除入群欢迎语素材。
WxCpBaseResp	editCorpTag(java.lang.String id, java.lang.String name, java.lang.Integer order) <pre> 企业可通过此接口编辑客户标签/标签组的名称或次序值。
WxCpBaseResp	editGroupWelcomeTemplate(WxCpGroupWelcomeTemplateResult template) <pre> 编辑入群欢迎语素材。
WxCpBaseResp	finishExternalUserIdMigration(java.lang.String corpid) 设置迁移完成 <pre> 文档地址：https://open.work.weixin.qq.com/api/doc/35863#转换external_userid 企业授权确认之后，且服务商完成了新旧external_userid的迁移，即可主动将该企业设置为“迁移完成”， 设置之后，从该企业获取到的将是新的external_userid。
WxCpExternalContactInfo	getContactDetail(java.lang.String userId, java.lang.String cursor) 获取客户详情.
WxCpExternalContactBatchInfo	getContactDetailBatch(java.lang.String[] userIdList, java.lang.String cursor, java.lang.Integer limit) 批量获取客户详情.
WxCpContactWayInfo	getContactWay(@NonNull java.lang.String configId) 获取企业已配置的「联系我」方式 <pre> 批量获取企业配置的「联系我」二维码和「联系我」小程序按钮。
WxCpUserExternalTagGroupList	getCorpTagList(java.lang.String[] tagId) <pre> 企业可通过此接口获取企业客户标签详情。
WxCpUserExternalTagGroupList	getCorpTagList(java.lang.String[] tagId, java.lang.String[] groupId) <pre> 企业可通过此接口获取企业客户标签详情。
WxCpExternalContactInfo	getExternalContact(java.lang.String userId) 已过时。 建议使用 getContactDetail(String, String)
WxCpUserExternalGroupChatInfo	getGroupChat(java.lang.String chatId, java.lang.Integer needName) <pre> 通过客户群ID，获取详情。
WxCpUserExternalGroupChatStatistic	getGroupChatStatistic(java.util.Date startTime, java.lang.Integer orderBy, java.lang.Integer orderAsc, java.lang.Integer pageIndex, java.lang.Integer pageSize, java.lang.String[] userIds, java.lang.String[] partyIds) <pre> 获取指定日期全天的统计数据。
WxCpGroupMsgListResult	getGroupMsgListV2(java.lang.String chatType, @NonNull java.util.Date startTime, @NonNull java.util.Date endTime, java.lang.String creator, java.lang.Integer filterType, java.lang.Integer limit, java.lang.String cursor) <pre> 企业和第三方应用可通过此接口获取企业与成员的群发记录。
WxCpGroupMsgResult	getGroupMsgResult(java.lang.String msgid, java.lang.Integer limit, java.lang.String cursor) <pre> 企业跟第三方应用可通过该接口获取到创建企业群发的群发发送结果。
WxCpGroupMsgSendResult	getGroupMsgSendResult(java.lang.String msgid, java.lang.String userid, java.lang.Integer limit, java.lang.String cursor) <pre> 企业和第三方应用可通过此接口获取企业与成员的群发记录。
WxCpGroupMsgTaskResult	getGroupMsgTask(java.lang.String msgid, java.lang.Integer limit, java.lang.String cursor) <pre> 获取群发成员发送任务列表。
WxCpGroupWelcomeTemplateResult	getGroupWelcomeTemplate(java.lang.String templateId) <pre> 获取入群欢迎语素材。
WxCpGetMomentComments	getMomentComments(java.lang.String momentId, java.lang.String userId) <pre> 获取客户朋友圈全部的发表记录 获取客户朋友圈的互动数据 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>
WxCpGetMomentCustomerList	getMomentCustomerList(java.lang.String momentId, java.lang.String userId, java.lang.String cursor, java.lang.Integer limit) <pre> 获取客户朋友圈全部的发表记录 获取客户朋友圈发表时选择的可见范围 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>
WxCpGetMomentList	getMomentList(java.lang.Long startTime, java.lang.Long endTime, java.lang.String creator, java.lang.Integer filterType, java.lang.String cursor, java.lang.Integer limit) <pre> 获取客户朋友圈全部的发表记录 获取企业全部的发表列表 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>
WxCpGetMomentSendResult	getMomentSendResult(java.lang.String momentId, java.lang.String userId, java.lang.String cursor, java.lang.Integer limit) <pre> 获取客户朋友圈全部的发表记录 获取客户朋友圈发表后的可见客户列表 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>
WxCpGetMomentTask	getMomentTask(java.lang.String momentId, java.lang.String cursor, java.lang.Integer limit) <pre> 获取客户朋友圈全部的发表记录 获取客户朋友圈企业发表的列表 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>
WxCpGetMomentTaskResult	getMomentTaskResult(java.lang.String jobId) <pre> 由于发表任务的创建是异步执行的，应用需要再调用该接口以获取创建的结果。
WxCpNewExternalUserIdList	getNewExternalUserId(java.lang.String[] externalUserIdList) 转换external_userid <pre> 文档地址：https://open.work.weixin.qq.com/api/doc/35863#转换external_userid 对于历史已授权的企业，在2022年3月1号之前，所有接口与回调返回的external_userid仍然为旧的external_userid， 从2022年3月1号0点开始，所有输入与返回的external_userid字段，将启用升级后的external_userid。
WxCpProductAlbumResult	getProductAlbum(java.lang.String productId) <pre> 获取商品图册 https://work.weixin.qq.com/api/doc/90000/90135/95096#获取商品图册 </pre>
WxCpProductAlbumListResult	getProductAlbumList(java.lang.Integer limit, java.lang.String cursor) <pre> 获取商品图册 https://work.weixin.qq.com/api/doc/90000/90135/95096#获取商品图册列表 </pre>
WxCpUserExternalUserBehaviorStatistic	getUserBehaviorStatistic(java.util.Date startTime, java.util.Date endTime, java.lang.String[] userIds, java.lang.String[] partyIds) <pre> 企业可通过此接口获取成员联系客户的数据，包括发起申请数、新增客户数、聊天数、发送消息数和删除/拉黑成员的客户数等指标。
java.util.List<java.lang.String>	listExternalContacts(java.lang.String userId) 获取客户列表.
java.util.List<java.lang.String>	listFollowers() 企业和第三方服务商可通过此接口获取配置了客户联系功能的成员(Customer Contact)列表。
WxCpUserExternalGroupChatList	listGroupChat(java.lang.Integer pageIndex, java.lang.Integer pageSize, int status, java.lang.String[] userIds, java.lang.String[] partyIds) 已过时。 请使用 listGroupChat(Integer, String, int, String[])
WxCpUserExternalGroupChatList	listGroupChat(java.lang.Integer limit, java.lang.String cursor, int status, java.lang.String[] userIds) <pre> 该接口用于获取配置过客户群管理的客户群列表。
WxCpUserExternalUnassignList	listUnassignedList(java.lang.Integer pageId, java.lang.String cursor, java.lang.Integer pageSize) 获取待分配的离职成员列表 企业和第三方可通过此接口，获取所有离职成员的客户列表，并可进一步调用分配离职成员的客户接口将这些客户重新分配给其他企业成员。
WxCpBaseResp	markTag(java.lang.String userid, java.lang.String externalUserid, java.lang.String[] addTag, java.lang.String[] removeTag) <pre> 企业可通过此接口为指定成员的客户添加上由企业统一配置的标签。
java.lang.String	opengidToChatid(java.lang.String opengid) 客户群opengid转换 <pre> 文档地址：https://open.work.weixin.qq.com/api/doc/90000/90135/94822 用户在微信里的客户群里打开小程序时，某些场景下可以获取到群的opengid，如果该群是企业微信的客户群， 则企业或第三方可以调用此接口将一个opengid转换为客户群chat_id 权限说明： 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）
WxCpUserTransferCustomerResp	resignedTransferCustomer(WxCpUserTransferCustomerReq req) 企业可通过此接口，分配离职成员的客户给其他成员。
WxCpUserTransferResultResp	resignedTransferResult(java.lang.String handOverUserid, java.lang.String takeOverUserid, java.lang.String cursor) 企业和第三方可通过此接口查询离职成员的客户分配情况。
void	sendWelcomeMsg(WxCpWelcomeMsg msg) 发送新客户欢迎语 <pre> 企业微信在向企业推送添加外部联系人事件时，会额外返回一个welcome_code，企业以此为凭据调用接口，即可通过成员向新添加的客户发送个性化的欢迎语。
java.lang.String	toServiceExternalUserid(java.lang.String externalUserid) 代开发应用external_userid转换 <pre> 文档地址：https://work.weixin.qq.com/api/doc/90001/90143/95195 企业同时安装服务商第三方应用以及授权代开发自建应用的时，服务商可使用该接口将代开发应用获取到的外部联系人id跟第三方应用的id进行关联， 该接口可将代开发自建应用获取到的external_userid转换为服务商第三方应用的external_userid。
WxCpUserTransferCustomerResp	transferCustomer(WxCpUserTransferCustomerReq req) 企业可通过此接口，转接在职成员的客户给其他成员。
WxCpBaseResp	transferExternalContact(java.lang.String externalUserid, java.lang.String handOverUserid, java.lang.String takeOverUserid) 已过时。 此后续将不再更新维护, 建议使用 transferCustomer(WxCpUserTransferCustomerReq)
WxCpUserExternalGroupChatTransferResp	transferGroupChat(java.lang.String[] chatIds, java.lang.String newOwner) 企业可通过此接口，将已离职成员为群主的群，分配给另一个客服成员。
WxCpUserTransferResultResp	transferResult(java.lang.String handOverUserid, java.lang.String takeOverUserid, java.lang.String cursor) 企业和第三方可通过此接口查询在职成员的客户转接情况。
java.lang.String	unionidToExternalUserid(java.lang.String unionid, java.lang.String openid) 服务商为企业代开发微信小程序的场景，服务商可通过此接口，将微信客户的unionid转为external_userid。
WxCpExternalUserIdList	unionidToExternalUserid3rd(java.lang.String unionid, java.lang.String openid, java.lang.String corpid) 企业客户微信unionid的升级 - unionid查询external_userid <pre> 文档地址：https://open.work.weixin.qq.com/api/doc/35863#4.2%20unionid%E6%9F%A5%E8%AF%A2external_userid 当微信用户在微信中使用第三方应用的小程序或公众号时，第三方可将获取到的unionid与openid，调用此接口转换为企业客户external_userid。
WxCpBaseResp	updateContactWay(@NonNull WxCpContactWayInfo info) 更新企业已配置的「联系我」方式 <pre> 更新企业配置的「联系我」二维码和「联系我」小程序按钮中的信息，如使用人员和备注等。
void	updateRemark(WxCpUpdateRemarkRequest request) 修改客户备注信息.
me.chanjar.weixin.common.bean.result.WxMediaUploadResult	uploadAttachment(java.lang.String mediaType, java.lang.Integer attachmentType, java.io.File file) <pre> 上传附件资源 https://open.work.weixin.qq.com/api/doc/90001/90143/95178 </pre>
me.chanjar.weixin.common.bean.result.WxMediaUploadResult	uploadAttachment(java.lang.String mediaType, java.lang.String fileType, java.lang.Integer attachmentType, java.io.InputStream inputStream) <pre> 上传附件资源 https://open.work.weixin.qq.com/api/doc/90001/90143/95178 </pre>

方法详细资料

addContactWay

WxCpContactWayResult addContactWay(@NonNull
                                   @NonNull WxCpContactWayInfo info)
                            throws me.chanjar.weixin.common.error.WxErrorException

配置客户联系「联系我」方式 <pre> 企业可以在管理后台-客户联系中配置成员的「联系我」的二维码或者小程序按钮，客户通过扫描二维码或点击小程序上的按钮，即可获取成员联系方式，主动联系到成员。 企业可通过此接口为具有客户联系功能的成员生成专属的「联系我」二维码或者「联系我」按钮。 如果配置的是「联系我」按钮，需要开发者的小程序接入小程序插件。 注意: 通过API添加的「联系我」不会在管理端进行展示，每个企业可通过API最多配置50万个「联系我」。 用户需要妥善存储返回的config_id，config_id丢失可能导致用户无法编辑或删除「联系我」。 临时会话模式不占用「联系我」数量，但每日最多添加10万个，并且仅支持单人。 临时会话模式的二维码，添加好友完成后该二维码即刻失效。 </pre>

参数:

info - 客户联系「联系我」方式

返回:

wx cp contact way result

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getContactWay

WxCpContactWayInfo getContactWay(@NonNull
                                 @NonNull java.lang.String configId)
                          throws me.chanjar.weixin.common.error.WxErrorException

获取企业已配置的「联系我」方式 <pre> 批量获取企业配置的「联系我」二维码和「联系我」小程序按钮。 </pre>

参数:

configId - 联系方式的配置id,必填

返回:

contact way

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

updateContactWay

WxCpBaseResp updateContactWay(@NonNull
                              @NonNull WxCpContactWayInfo info)
                       throws me.chanjar.weixin.common.error.WxErrorException

更新企业已配置的「联系我」方式 <pre> 更新企业配置的「联系我」二维码和「联系我」小程序按钮中的信息，如使用人员和备注等。 </pre>

参数:

info - 客户联系「联系我」方式

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

deleteContactWay

WxCpBaseResp deleteContactWay(@NonNull
                              @NonNull java.lang.String configId)
                       throws me.chanjar.weixin.common.error.WxErrorException

删除企业已配置的「联系我」方式 <pre> 删除一个已配置的「联系我」二维码或者「联系我」小程序按钮。 </pre>

参数:

configId - 企业联系方式的配置id,必填

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

closeTempChat

WxCpBaseResp closeTempChat(@NonNull
                           @NonNull java.lang.String userId,
                           @NonNull
                           @NonNull java.lang.String externalUserId)
                    throws me.chanjar.weixin.common.error.WxErrorException

结束临时会话 <pre> 将指定的企业成员和客户之前的临时会话断开，断开前会自动下发已配置的结束语。 注意：请保证传入的企业成员和客户之间有仍然有效的临时会话, 通过其他方式的添加外部联系人无法通过此接口关闭会话。 </pre>

参数:

userId - the user id

externalUserId - the external user id

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getExternalContact

@Deprecated
WxCpExternalContactInfo getExternalContact(java.lang.String userId)
                                                 throws me.chanjar.weixin.common.error.WxErrorException

已过时。 建议使用 getContactDetail(String, String)

获取外部联系人详情. <pre> 企业可通过此接口，根据外部联系人的userid，拉取外部联系人详情。权限说明： 企业需要使用外部联系人管理secret所获取的accesstoken来调用 第三方应用需拥有“企业客户”权限。 第三方应用调用时，返回的跟进人follow_user仅包含应用可见范围之内的成员。 </pre>

参数:

userId - 外部联系人的userid

返回:

. external contact

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getContactDetail

WxCpExternalContactInfo getContactDetail(java.lang.String userId,
                                         java.lang.String cursor)
                                  throws me.chanjar.weixin.common.error.WxErrorException

获取客户详情. <pre> 企业可通过此接口，根据外部联系人的userid（如何获取?），拉取客户详情。 请求方式：GET（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get?access_token=ACCESS_TOKEN&external_userid=EXTERNAL_USERID 权限说明： 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）； 第三方/自建应用调用时，返回的跟进人follow_user仅包含应用可见范围之内的成员。 </pre>

参数:

userId - 外部联系人的userid，注意不是企业成员的帐号

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

返回:

. contact detail

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

convertToOpenid

java.lang.String convertToOpenid(java.lang.String externalUserid)
                          throws me.chanjar.weixin.common.error.WxErrorException

企业和服务商可通过此接口，将微信外部联系人的userid转为微信openid，用于调用支付相关接口。暂不支持企业微信外部联系人（ExternalUserid为wo开头）的userid转openid。

参数:

externalUserid - 微信外部联系人的userid

返回:

该企业的外部联系人openid

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

unionidToExternalUserid

java.lang.String unionidToExternalUserid(@NotNull
                                         java.lang.String unionid,
                                         java.lang.String openid)
                                  throws me.chanjar.weixin.common.error.WxErrorException

服务商为企业代开发微信小程序的场景，服务商可通过此接口，将微信客户的unionid转为external_userid。 <pre> 文档地址：https://work.weixin.qq.com/api/doc/90001/90143/93274 服务商代开发小程序指企业使用的小程序为企业主体的，非服务商主体的小程序。 场景：企业客户在微信端从企业主体的小程序（非服务商应用）登录，同时企业在企业微信安装了服务商的第三方应用，服务商可以调用该接口将登录用户的unionid转换为服务商全局唯一的外部联系人id 权限说明： 仅认证企业可调用 unionid必须是企业主体下的unionid。即unionid的主体（为绑定了该小程序的微信开放平台账号主体）需与当前企业的主体一致。 unionid的主体（即微信开放平台账号主体）需认证 该客户的跟进人必须在应用的可见范围之内 </pre>

参数:

unionid - 微信客户的unionid

openid - openid

返回:

该企业的外部联系人ID

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

toServiceExternalUserid

java.lang.String toServiceExternalUserid(@NotNull
                                         java.lang.String externalUserid)
                                  throws me.chanjar.weixin.common.error.WxErrorException

代开发应用external_userid转换 <pre> 文档地址：https://work.weixin.qq.com/api/doc/90001/90143/95195 企业同时安装服务商第三方应用以及授权代开发自建应用的时，服务商可使用该接口将代开发应用获取到的外部联系人id跟第三方应用的id进行关联， 该接口可将代开发自建应用获取到的external_userid转换为服务商第三方应用的external_userid。 权限说明： 该企业授权了该服务商第三方应用,且授权的第三方应用具备“企业客户权限-客户基础信息”权限 该客户的跟进人必须在应用的可见范围之内 应用需具备“企业客户权限-客户基础信息”权限 </pre>

参数:

externalUserid - 代开发自建应用获取到的外部联系人ID

返回:

该服务商第三方应用下的企业的外部联系人ID

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

unionidToExternalUserid3rd

WxCpExternalUserIdList unionidToExternalUserid3rd(@NotNull
                                                  java.lang.String unionid,
                                                  @NotNull
                                                  java.lang.String openid,
                                                  java.lang.String corpid)
                                           throws me.chanjar.weixin.common.error.WxErrorException

企业客户微信unionid的升级 - unionid查询external_userid <pre> 文档地址：https://open.work.weixin.qq.com/api/doc/35863#4.2%20unionid%E6%9F%A5%E8%AF%A2external_userid 当微信用户在微信中使用第三方应用的小程序或公众号时，第三方可将获取到的unionid与openid，调用此接口转换为企业客户external_userid。 该接口调用频次有限，每个服务商每小时仅可调用1万次，仅用于微信用户主动使用第三方应用的场景来调用，服务商切不可滥用。 同时建议服务商的小程序路径或公众号页面链接带上corpid参数，如此可明确地转换出该企业对应的external_userid，以获得更好的性能。 权限说明： 该企业授权了该服务商第三方应用 调用频率最大为10000次/小时 unionid和openid的主体需与服务商的主体一致 openid与unionid必须是在同一个小程序或同一个公众号获取到的 </pre>

参数:

unionid - 微信客户的unionid

openid - 微信客户的openid

corpid - 需要换取的企业corpid，不填则拉取所有企业

返回:

该服务商第三方应用下的企业的外部联系人ID

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

getNewExternalUserId

WxCpNewExternalUserIdList getNewExternalUserId(java.lang.String[] externalUserIdList)
                                        throws me.chanjar.weixin.common.error.WxErrorException

转换external_userid <pre> 文档地址：https://open.work.weixin.qq.com/api/doc/35863#转换external_userid 对于历史已授权的企业，在2022年3月1号之前，所有接口与回调返回的external_userid仍然为旧的external_userid， 从2022年3月1号0点开始，所有输入与返回的external_userid字段，将启用升级后的external_userid。 所以服务商需要在此之前完成历史数据的迁移整改 权限说明： 该企业授权了该服务商第三方应用 external_userid对应的跟进人需要在应用可见范围内 </pre>

参数:

externalUserIdList - 微信客户的unionid

返回:

List 新外部联系人id

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

finishExternalUserIdMigration

WxCpBaseResp finishExternalUserIdMigration(@NotNull
                                           java.lang.String corpid)
                                    throws me.chanjar.weixin.common.error.WxErrorException

设置迁移完成 <pre> 文档地址：https://open.work.weixin.qq.com/api/doc/35863#转换external_userid 企业授权确认之后，且服务商完成了新旧external_userid的迁移，即可主动将该企业设置为“迁移完成”， 设置之后，从该企业获取到的将是新的external_userid。注意，该接口需要使用provider_access_token来调用， 对于有多个应用的服务商，可逐个应用进行external_userid的转换，最后再使用provider_access_token调用该接口完成设置。 权限说明： 该企业授权了该服务商第三方应用 </pre>

参数:

corpid - 企业corpid

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

opengidToChatid

java.lang.String opengidToChatid(@NotNull
                                 java.lang.String opengid)
                          throws me.chanjar.weixin.common.error.WxErrorException

客户群opengid转换 <pre> 文档地址：https://open.work.weixin.qq.com/api/doc/90000/90135/94822 用户在微信里的客户群里打开小程序时，某些场景下可以获取到群的opengid，如果该群是企业微信的客户群， 则企业或第三方可以调用此接口将一个opengid转换为客户群chat_id 权限说明： 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？） 第三方应用需具有“企业客户权限-客户基础信息”权限 对于第三方/自建应用，群主必须在应用的可见范围 仅支持企业服务人员创建的客户群 仅可转换出自己企业下的客户群chat_id </pre>

参数:

opengid - 小程序在微信获取到的群ID，参见wx.getGroupEnterInfo(https://developers.weixin.qq.com/miniprogram/dev/api/open-api/group/wx.getGroupEnterInfo.html)

返回:

客户群ID，可以用来调用获取客户群详情

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

getContactDetailBatch

WxCpExternalContactBatchInfo getContactDetailBatch(java.lang.String[] userIdList,
                                                   java.lang.String cursor,
                                                   java.lang.Integer limit)
                                            throws me.chanjar.weixin.common.error.WxErrorException

批量获取客户详情. <pre> 企业/第三方可通过此接口获取指定成员添加的客户信息列表。 请求方式：POST（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/batch/get_by_user?access_token=ACCESS_TOKEN 权限说明： 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）； 第三方/自建应用调用时，返回的跟进人follow_user仅包含应用可见范围之内的成员。 </pre>

参数:

userIdList - 企业成员的userid列表，注意不是外部联系人的帐号

cursor - the cursor

limit - the limit

返回:

wx cp user external contact batch info

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

updateRemark

void updateRemark(WxCpUpdateRemarkRequest request)
           throws me.chanjar.weixin.common.error.WxErrorException

修改客户备注信息. <pre> 企业可通过此接口修改指定用户添加的客户的备注信息。 请求方式: POST(HTTP) 请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/remark?access_token=ACCESS_TOKEN 文档地址：https://work.weixin.qq.com/api/doc/90000/90135/92115 </pre>

参数:

request - 备注信息请求

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

listExternalContacts

java.util.List<java.lang.String> listExternalContacts(java.lang.String userId)
                                               throws me.chanjar.weixin.common.error.WxErrorException

获取客户列表. <pre> 企业可通过此接口获取指定成员添加的客户列表。客户是指配置了客户联系功能的成员所添加的外部联系人。没有配置客户联系功能的成员，所添加的外部联系人将不会作为客户返回。 请求方式：GET（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN&userid=USERID 权限说明： 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）； 第三方应用需拥有“企业客户”权限。 第三方/自建应用只能获取到可见范围内的配置了客户联系功能的成员。 </pre>

参数:

userId - 企业成员的userid

返回:

List of External wx id

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

listFollowers

java.util.List<java.lang.String> listFollowers()
                                        throws me.chanjar.weixin.common.error.WxErrorException

企业和第三方服务商可通过此接口获取配置了客户联系功能的成员(Customer Contact)列表。 <pre> 企业需要使用外部联系人管理secret所获取的accesstoken来调用（accesstoken如何获取？）； 第三方应用需拥有“企业客户”权限。 第三方应用只能获取到可见范围内的配置了客户联系功能的成员 </pre>

返回:

List of CpUser id

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

listUnassignedList

WxCpUserExternalUnassignList listUnassignedList(java.lang.Integer pageId,
                                                java.lang.String cursor,
                                                java.lang.Integer pageSize)
                                         throws me.chanjar.weixin.common.error.WxErrorException

获取待分配的离职成员列表 企业和第三方可通过此接口，获取所有离职成员的客户列表，并可进一步调用分配离职成员的客户接口将这些客户重新分配给其他企业成员。 请求方式：POST（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_unassigned_list?access_token=ACCESS_TOKEN

参数:

pageId - 分页查询，要查询页号，从0开始

cursor - 分页查询游标，字符串类型，适用于数据量较大的情况，如果使用该参数则无需填写page_id，该参数由上一次调用返回

pageSize - 每次返回的最大记录数，默认为1000，最大值为1000

返回:

WxCpUserExternalUnassignList

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常

transferExternalContact

@Deprecated
WxCpBaseResp transferExternalContact(java.lang.String externalUserid,
                                                  java.lang.String handOverUserid,
                                                  java.lang.String takeOverUserid)
                                           throws me.chanjar.weixin.common.error.WxErrorException

已过时。 此后续将不再更新维护, 建议使用 transferCustomer(WxCpUserTransferCustomerReq)

企业可通过此接口，将已离职成员的外部联系人分配给另一个成员接替联系。

参数:

externalUserid - the external userid

handOverUserid - the hand over userid

takeOverUserid - the take over userid

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

transferCustomer

WxCpUserTransferCustomerResp transferCustomer(WxCpUserTransferCustomerReq req)
                                       throws me.chanjar.weixin.common.error.WxErrorException

企业可通过此接口，转接在职成员的客户给其他成员。 <per> external_userid必须是handover_userid的客户（即配置了客户联系功能的成员所添加的联系人）。 在职成员的每位客户最多被分配2次。客户被转接成功后，将有90个自然日的服务关系保护期，保护期内的客户无法再次被分配。 <p> 权限说明： * 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 第三方应用需拥有“企业客户权限-客户联系-在职继承”权限 接替成员必须在此第三方应用或自建应用的可见范围内。 接替成员需要配置了客户联系功能。 接替成员需要在企业微信激活且已经过实名认证。 </per>

参数:

req - 转接在职成员的客户给其他成员请求实体

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

transferResult

WxCpUserTransferResultResp transferResult(@NotNull
                                          java.lang.String handOverUserid,
                                          @NotNull
                                          java.lang.String takeOverUserid,
                                          java.lang.String cursor)
                                   throws me.chanjar.weixin.common.error.WxErrorException

企业和第三方可通过此接口查询在职成员的客户转接情况。 <per> 权限说明： <p> 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 第三方应用需拥有“企业客户权限- 客户联系-在职继承”权限 接替成员必须在此第三方应用或自建应用的可见范围内。 </per>

参数:

handOverUserid - 原添加成员的userid

takeOverUserid - 接替成员的userid

cursor - 分页查询的cursor，每个分页返回的数据不会超过1000条；不填或为空表示获取第一个分页；

返回:

客户转接接口实体

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

resignedTransferCustomer

WxCpUserTransferCustomerResp resignedTransferCustomer(WxCpUserTransferCustomerReq req)
                                               throws me.chanjar.weixin.common.error.WxErrorException

企业可通过此接口，分配离职成员的客户给其他成员。 <per> handover_userid必须是已离职用户。 external_userid必须是handover_userid的客户（即配置了客户联系功能的成员所添加的联系人）。 在职成员的每位客户最多被分配2次。客户被转接成功后，将有90个自然日的服务关系保护期，保护期内的客户无法再次被分配。 <p> 权限说明： <p> 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 第三方应用需拥有“企业客户权限-客户联系-离职分配”权限 接替成员必须在此第三方应用或自建应用的可见范围内。 接替成员需要配置了客户联系功能。 接替成员需要在企业微信激活且已经过实名认证。 </per>

参数:

req - 转接在职成员的客户给其他成员请求实体

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

resignedTransferResult

WxCpUserTransferResultResp resignedTransferResult(@NotNull
                                                  java.lang.String handOverUserid,
                                                  @NotNull
                                                  java.lang.String takeOverUserid,
                                                  java.lang.String cursor)
                                           throws me.chanjar.weixin.common.error.WxErrorException

企业和第三方可通过此接口查询离职成员的客户分配情况。 <per> 权限说明： <p> 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 第三方应用需拥有“企业客户权限-客户联系-在职继承”权限 接替成员必须在此第三方应用或自建应用的可见范围内。 </per>

参数:

handOverUserid - 原添加成员的userid

takeOverUserid - 接替成员的userid

cursor - 分页查询的cursor，每个分页返回的数据不会超过1000条；不填或为空表示获取第一个分页；

返回:

客户转接接口实体

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

listGroupChat

@Deprecated
WxCpUserExternalGroupChatList listGroupChat(java.lang.Integer pageIndex,
                                                         java.lang.Integer pageSize,
                                                         int status,
                                                         java.lang.String[] userIds,
                                                         java.lang.String[] partyIds)
                                                  throws me.chanjar.weixin.common.error.WxErrorException

已过时。 请使用 listGroupChat(Integer, String, int, String[])

<pre> 该接口用于获取配置过客户群管理的客户群列表。 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 暂不支持第三方调用。 微信文档：https://work.weixin.qq.com/api/doc/90000/90135/92119 </pre>

参数:

pageIndex - the page index

pageSize - the page size

status - the status

userIds - the user ids

partyIds - the party ids

返回:

the wx cp user external group chat list

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

listGroupChat

WxCpUserExternalGroupChatList listGroupChat(java.lang.Integer limit,
                                            java.lang.String cursor,
                                            int status,
                                            java.lang.String[] userIds)
                                     throws me.chanjar.weixin.common.error.WxErrorException

<pre> 该接口用于获取配置过客户群管理的客户群列表。 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 暂不支持第三方调用。 微信文档：https://work.weixin.qq.com/api/doc/90000/90135/92119 </pre>

参数:

limit - 分页，预期请求的数据量，取值范围 1 ~ 1000

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用不填

status - 客户群跟进状态过滤。0 - 所有列表(即不过滤) 1 - 离职待继承 2 - 离职继承中 3 - 离职继承完成 默认为0

userIds - 群主过滤。如果不填，表示获取应用可见范围内全部群主的数据（但是不建议这么用，如果可见范围人数超过1000人，为了防止数据包过大，会报错 81017）;用户ID列表。最多100个

返回:

the wx cp user external group chat list

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getGroupChat

WxCpUserExternalGroupChatInfo getGroupChat(java.lang.String chatId,
                                           java.lang.Integer needName)
                                    throws me.chanjar.weixin.common.error.WxErrorException

<pre> 通过客户群ID，获取详情。包括群名、群成员列表、群成员入群时间、入群方式。（客户群是由具有客户群使用权限的成员创建的外部群） 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 暂不支持第三方调用。 微信文档：https://work.weixin.qq.com/api/doc/90000/90135/92122 </pre>

参数:

chatId - the chat id

needName - needName

返回:

group chat

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

transferGroupChat

WxCpUserExternalGroupChatTransferResp transferGroupChat(java.lang.String[] chatIds,
                                                        java.lang.String newOwner)
                                                 throws me.chanjar.weixin.common.error.WxErrorException

企业可通过此接口，将已离职成员为群主的群，分配给另一个客服成员。 <per> 注意：： <p> 群主离职了的客户群，才可继承 继承给的新群主，必须是配置了客户联系功能的成员 继承给的新群主，必须有设置实名 继承给的新群主，必须有激活企业微信 同一个人的群，限制每天最多分配300个给新群主 <p> 权限说明: <p> 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 第三方应用需拥有“企业客户权限-客户联系-分配离职成员的客户群”权限 对于第三方/自建应用，群主必须在应用的可见范围。 </per>

参数:

chatIds - 需要转群主的客户群ID列表。取值范围： 1 ~ 100

newOwner - 新群主ID

返回:

分配结果，主要是分配失败的群列表

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getUserBehaviorStatistic

WxCpUserExternalUserBehaviorStatistic getUserBehaviorStatistic(java.util.Date startTime,
                                                               java.util.Date endTime,
                                                               java.lang.String[] userIds,
                                                               java.lang.String[] partyIds)
                                                        throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业可通过此接口获取成员联系客户的数据，包括发起申请数、新增客户数、聊天数、发送消息数和删除/拉黑成员的客户数等指标。 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 第三方应用需拥有“企业客户”权限。 第三方/自建应用调用时传入的userid和partyid要在应用的可见范围内; </pre>

参数:

startTime - the start time

endTime - the end time

userIds - the user ids

partyIds - the party ids

返回:

user behavior statistic

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getGroupChatStatistic

WxCpUserExternalGroupChatStatistic getGroupChatStatistic(java.util.Date startTime,
                                                         java.lang.Integer orderBy,
                                                         java.lang.Integer orderAsc,
                                                         java.lang.Integer pageIndex,
                                                         java.lang.Integer pageSize,
                                                         java.lang.String[] userIds,
                                                         java.lang.String[] partyIds)
                                                  throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取指定日期全天的统计数据。注意，企业微信仅存储60天的数据。 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。 暂不支持第三方调用。 </pre>

参数:

startTime - the start time

orderBy - the order by

orderAsc - the order asc

pageIndex - the page index

pageSize - the page size

userIds - the user ids

partyIds - the party ids

返回:

group chat statistic

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

addMsgTemplate

WxCpMsgTemplateAddResult addMsgTemplate(WxCpMsgTemplate wxCpMsgTemplate)
                                 throws me.chanjar.weixin.common.error.WxErrorException

添加企业群发消息任务 企业可通过此接口添加企业群发消息的任务并通知客服人员发送给相关客户或客户群。（注：企业微信终端需升级到2.7.5版本及以上） 注意：调用该接口并不会直接发送消息给客户/客户群，需要相关的客服人员操作以后才会实际发送（客服人员的企业微信需要升级到2.7.5及以上版本） 同一个企业每个自然月内仅可针对一个客户/客户群发送4条消息，超过限制的用户将会被忽略。 <p> 请求方式: POST(HTTP) <p> 请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_msg_template?access_token=ACCESS_TOKEN <p> 文档地址：https://work.weixin.qq.com/api/doc/90000/90135/92135

参数:

wxCpMsgTemplate - the wx cp msg template

返回:

the wx cp msg template add result

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

sendWelcomeMsg

void sendWelcomeMsg(WxCpWelcomeMsg msg)
             throws me.chanjar.weixin.common.error.WxErrorException

发送新客户欢迎语 <pre> 企业微信在向企业推送添加外部联系人事件时，会额外返回一个welcome_code，企业以此为凭据调用接口，即可通过成员向新添加的客户发送个性化的欢迎语。 为了保证用户体验以及避免滥用，企业仅可在收到相关事件后20秒内调用，且只可调用一次。 如果企业已经在管理端为相关成员配置了可用的欢迎语，则推送添加外部联系人事件时不会返回welcome_code。 每次添加新客户时可能有多个企业自建应用/第三方应用收到带有welcome_code的回调事件，但仅有最先调用的可以发送成功。后续调用将返回41051（externaluser has started chatting）错误，请用户根据实际使用需求，合理设置应用可见范围，避免冲突。 请求方式: POST(HTTP) 请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/send_welcome_msg?access_token=ACCESS_TOKEN 文档地址：https://work.weixin.qq.com/api/doc/90000/90135/92137 </pre>

参数:

msg - .

抛出:

me.chanjar.weixin.common.error.WxErrorException - .

getCorpTagList

WxCpUserExternalTagGroupList getCorpTagList(java.lang.String[] tagId)
                                     throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业可通过此接口获取企业客户标签详情。 </pre>

参数:

tagId - the tag id

返回:

corp tag list

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getCorpTagList

WxCpUserExternalTagGroupList getCorpTagList(java.lang.String[] tagId,
                                            java.lang.String[] groupId)
                                     throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业可通过此接口获取企业客户标签详情。 若tag_id和group_id均为空，则返回所有标签。 同时传递tag_id和group_id时，忽略tag_id，仅以group_id作为过滤条件。 </pre>

参数:

tagId - the tag id

groupId - the tagGroup id

返回:

corp tag list

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

addCorpTag

WxCpUserExternalTagGroupInfo addCorpTag(WxCpUserExternalTagGroupInfo tagGroup)
                                 throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业可通过此接口向客户标签库中添加新的标签组和标签，每个企业最多可配置3000个企业标签。 暂不支持第三方调用。 </pre>

参数:

tagGroup - the tag group

返回:

wx cp user external tag group info

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

editCorpTag

WxCpBaseResp editCorpTag(java.lang.String id,
                         java.lang.String name,
                         java.lang.Integer order)
                  throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业可通过此接口编辑客户标签/标签组的名称或次序值。 暂不支持第三方调用。 </pre>

参数:

id - the id

name - the name

order - the order

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

delCorpTag

WxCpBaseResp delCorpTag(java.lang.String[] tagId,
                        java.lang.String[] groupId)
                 throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业可通过此接口删除客户标签库中的标签，或删除整个标签组。 暂不支持第三方调用。 </pre>

参数:

tagId - the tag id

groupId - the group id

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

markTag

WxCpBaseResp markTag(java.lang.String userid,
                     java.lang.String externalUserid,
                     java.lang.String[] addTag,
                     java.lang.String[] removeTag)
              throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业可通过此接口为指定成员的客户添加上由企业统一配置的标签。 https://work.weixin.qq.com/api/doc/90000/90135/92117 </pre>

参数:

userid - the userid

externalUserid - the external userid

addTag - the add tag

removeTag - the remove tag

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

addMomentTask

WxCpAddMomentResult addMomentTask(WxCpAddMomentTask task)
                           throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业和第三方应用可通过该接口创建客户朋友圈的发表任务。 https://open.work.weixin.qq.com/api/doc/90000/90135/95094 </pre>

参数:

task - 任务

返回:

wx cp add moment result

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getMomentTaskResult

WxCpGetMomentTaskResult getMomentTaskResult(java.lang.String jobId)
                                     throws me.chanjar.weixin.common.error.WxErrorException

<pre> 由于发表任务的创建是异步执行的，应用需要再调用该接口以获取创建的结果。 https://open.work.weixin.qq.com/api/doc/90000/90135/95094 </pre>

参数:

jobId - 异步任务id，最大长度为64字节，由创建发表内容到客户朋友圈任务接口获取

返回:

WxCpGetMomentTaskResult

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常

getMomentList

WxCpGetMomentList getMomentList(java.lang.Long startTime,
                                java.lang.Long endTime,
                                java.lang.String creator,
                                java.lang.Integer filterType,
                                java.lang.String cursor,
                                java.lang.Integer limit)
                         throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取客户朋友圈全部的发表记录 获取企业全部的发表列表 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>

参数:

startTime - 朋友圈记录开始时间。Unix时间戳

endTime - 朋友圈记录结束时间。Unix时间戳

creator - 朋友圈创建人的userid

filterType - 朋友圈类型。0：企业发表 1：个人发表 2：所有，包括个人创建以及企业创建，默认情况下为所有类型

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

limit - 返回的最大记录数，整型，最大值100，默认值100，超过最大值时取默认值

返回:

WxCpGetMomentList

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常

getMomentTask

WxCpGetMomentTask getMomentTask(java.lang.String momentId,
                                java.lang.String cursor,
                                java.lang.Integer limit)
                         throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取客户朋友圈全部的发表记录 获取客户朋友圈企业发表的列表 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>

参数:

momentId - 朋友圈id,仅支持企业发表的朋友圈id

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

limit - 返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值

返回:

WxCpGetMomentTask

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常

getMomentCustomerList

WxCpGetMomentCustomerList getMomentCustomerList(java.lang.String momentId,
                                                java.lang.String userId,
                                                java.lang.String cursor,
                                                java.lang.Integer limit)
                                         throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取客户朋友圈全部的发表记录 获取客户朋友圈发表时选择的可见范围 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>

参数:

momentId - 朋友圈id

userId - 企业发表成员userid，如果是企业创建的朋友圈，可以通过获取客户朋友圈企业发表的 列表获取已发表成员userid，如果是个人创建的朋友圈，创建人userid就是企业发表成员userid

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

limit - 返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值

返回:

WxCpGetMomentCustomerList

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常

getMomentSendResult

WxCpGetMomentSendResult getMomentSendResult(java.lang.String momentId,
                                            java.lang.String userId,
                                            java.lang.String cursor,
                                            java.lang.Integer limit)
                                     throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取客户朋友圈全部的发表记录 获取客户朋友圈发表后的可见客户列表 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>

参数:

momentId - 朋友圈id

userId - 企业发表成员userid，如果是企业创建的朋友圈，可以通过获取客户朋友圈企业发表的列表获取已发表成员userid， 如果是个人创建的朋友圈，创建人userid就是企业发表成员userid

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

limit - 返回的最大记录数，整型，最大值5000，默认值3000，超过最大值时取默认值

返回:

WxCpGetMomentSendResult

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常

getMomentComments

WxCpGetMomentComments getMomentComments(java.lang.String momentId,
                                        java.lang.String userId)
                                 throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取客户朋友圈全部的发表记录 获取客户朋友圈的互动数据 https://open.work.weixin.qq.com/api/doc/90000/90135/93333 </pre>

参数:

momentId - 朋友圈id

userId - 企业发表成员userid，如果是企业创建的朋友圈，可以通过获取客户朋友圈企业发表的列表获取已发表成员userid， 如果是个人创建的朋友圈，创建人userid就是企业发表成员userid

返回:

WxCpGetMomentComments

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常

getGroupMsgListV2

WxCpGroupMsgListResult getGroupMsgListV2(java.lang.String chatType,
                                         @NonNull
                                         @NonNull java.util.Date startTime,
                                         @NonNull
                                         @NonNull java.util.Date endTime,
                                         java.lang.String creator,
                                         java.lang.Integer filterType,
                                         java.lang.Integer limit,
                                         java.lang.String cursor)
                                  throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业和第三方应用可通过此接口获取企业与成员的群发记录。 https://work.weixin.qq.com/api/doc/90000/90135/93338 </pre>

参数:

chatType - 群发任务的类型，默认为single，表示发送给客户，group表示发送给客户群

startTime - 群发任务记录开始时间

endTime - 群发任务记录结束时间

creator - 群发任务创建人企业账号id

filterType - 创建人类型。0：企业发表 1：个人发表 2：所有，包括个人创建以及企业创建，默认情况下为所有类型

limit - 返回的最大记录数，整型，最大值100，默认值50，超过最大值时取默认值

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getGroupMsgSendResult

WxCpGroupMsgSendResult getGroupMsgSendResult(java.lang.String msgid,
                                             java.lang.String userid,
                                             java.lang.Integer limit,
                                             java.lang.String cursor)
                                      throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业和第三方应用可通过此接口获取企业与成员的群发记录。 https://work.weixin.qq.com/api/doc/90000/90135/93338#获取企业群发成员执行结果 </pre>

参数:

msgid - 群发消息的id，通过获取群发记录列表接口返回

userid - 发送成员userid，通过获取群发成员发送任务列表接口返回

limit - 返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getGroupMsgResult

WxCpGroupMsgResult getGroupMsgResult(java.lang.String msgid,
                                     java.lang.Integer limit,
                                     java.lang.String cursor)
                              throws me.chanjar.weixin.common.error.WxErrorException

<pre> 企业跟第三方应用可通过该接口获取到创建企业群发的群发发送结果。 https://work.weixin.qq.com/api/doc/16251 </pre>

参数:

msgid - 群发消息的id，通过创建企业群发接口返回

limit - 返回的最大记录数，整型，最大值10000，默认值10000

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getGroupMsgTask

WxCpGroupMsgTaskResult getGroupMsgTask(java.lang.String msgid,
                                       java.lang.Integer limit,
                                       java.lang.String cursor)
                                throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取群发成员发送任务列表。 https://work.weixin.qq.com/api/doc/90000/90135/93338#获取群发成员发送任务列表 </pre>

参数:

msgid - 群发消息的id，通过获取群发记录列表接口返回

limit - 返回的最大记录数，整型，最大值1000，默认值500，超过最大值时取默认值

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

addGroupWelcomeTemplate

java.lang.String addGroupWelcomeTemplate(WxCpGroupWelcomeTemplateResult template)
                                  throws me.chanjar.weixin.common.error.WxErrorException

<pre> 添加入群欢迎语素材。 https://open.work.weixin.qq.com/api/doc/90000/90135/92366#添加入群欢迎语素材 </pre>

参数:

template - 素材内容

返回:

template_id 欢迎语素材id

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

editGroupWelcomeTemplate

WxCpBaseResp editGroupWelcomeTemplate(WxCpGroupWelcomeTemplateResult template)
                               throws me.chanjar.weixin.common.error.WxErrorException

<pre> 编辑入群欢迎语素材。 https://open.work.weixin.qq.com/api/doc/90000/90135/92366#编辑入群欢迎语素材 </pre>

参数:

template - 素材内容

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getGroupWelcomeTemplate

WxCpGroupWelcomeTemplateResult getGroupWelcomeTemplate(@NotNull
                                                       java.lang.String templateId)
                                                throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取入群欢迎语素材。 https://open.work.weixin.qq.com/api/doc/90000/90135/92366#获取入群欢迎语素材 </pre>

参数:

templateId - 群欢迎语的素材id

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

delGroupWelcomeTemplate

WxCpBaseResp delGroupWelcomeTemplate(@NotNull
                                     java.lang.String templateId,
                                     java.lang.String agentId)
                              throws me.chanjar.weixin.common.error.WxErrorException

<pre> 删除入群欢迎语素材。 企业可通过此API删除入群欢迎语素材，且仅能删除调用方自己创建的入群欢迎语素材。 https://open.work.weixin.qq.com/api/doc/90000/90135/92366#删除入群欢迎语素材 </pre>

参数:

templateId - 群欢迎语的素材id

templateId - 授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数

agentId - agentId

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getProductAlbumList

WxCpProductAlbumListResult getProductAlbumList(java.lang.Integer limit,
                                               java.lang.String cursor)
                                        throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取商品图册 https://work.weixin.qq.com/api/doc/90000/90135/95096#获取商品图册列表 </pre>

参数:

limit - 返回的最大记录数，整型，最大值100，默认值50，超过最大值时取默认值

cursor - 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

getProductAlbum

WxCpProductAlbumResult getProductAlbum(java.lang.String productId)
                                throws me.chanjar.weixin.common.error.WxErrorException

<pre> 获取商品图册 https://work.weixin.qq.com/api/doc/90000/90135/95096#获取商品图册 </pre>

参数:

productId - 商品id

返回:

wx cp base resp

抛出:

me.chanjar.weixin.common.error.WxErrorException - the wx error exception

uploadAttachment

me.chanjar.weixin.common.bean.result.WxMediaUploadResult uploadAttachment(java.lang.String mediaType,
                                                                          java.lang.String fileType,
                                                                          java.lang.Integer attachmentType,
                                                                          java.io.InputStream inputStream)
                                                                   throws me.chanjar.weixin.common.error.WxErrorException,
                                                                          java.io.IOException

<pre> 上传附件资源 https://open.work.weixin.qq.com/api/doc/90001/90143/95178 </pre>

参数:

mediaType - mediaType

fileType - fileType

attachmentType - attachmentType

inputStream - inputStream

返回:

WxMediaUploadResult

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常

java.io.IOException - 出错抛出异常

uploadAttachment

me.chanjar.weixin.common.bean.result.WxMediaUploadResult uploadAttachment(java.lang.String mediaType,
                                                                          java.lang.Integer attachmentType,
                                                                          java.io.File file)
                                                                   throws me.chanjar.weixin.common.error.WxErrorException

<pre> 上传附件资源 https://open.work.weixin.qq.com/api/doc/90001/90143/95178 </pre>

参数:

mediaType - mediaType

attachmentType - attachmentType

file - file

返回:

WxMediaUploadResult 出错抛出异常

抛出:

me.chanjar.weixin.common.error.WxErrorException - 出错抛出异常