me.chanjar.weixin.cp.api.impl

类 WxCpExternalContactServiceImpl

java.lang.Object

me.chanjar.weixin.cp.api.impl.WxCpExternalContactServiceImpl

所有已实现的接口:

WxCpExternalContactService

public class WxCpExternalContactServiceImpl
extends Object
implements WxCpExternalContactService

构造器概要

构造器

构造器和说明
WxCpExternalContactServiceImpl(WxCpService mainService)

方法概要

限定符和类型	方法和说明
WxCpUserExternalContactInfo	getContactDetail(String userId) 获取客户详情.
WxCpUserExternalContactInfo	getExternalContact(String userId) 获取外部联系人详情.
WxCpUserExternalGroupChatInfo	getGroupChat(String chatId) 通过客户群ID，获取详情。
WxCpUserExternalGroupChatStatistic	getGroupChatStatistic(Date startTime, Integer orderBy, Integer orderAsc, Integer pageIndex, Integer pageSize, String[] userIds, String[] partyIds) 获取指定日期全天的统计数据。
WxCpUserExternalUserBehaviorStatistic	getUserBehaviorStatistic(Date startTime, Date endTime, String[] userIds, String[] partyIds) 企业可通过此接口获取成员联系客户的数据，包括发起申请数、新增客户数、聊天数、发送消息数和删除/拉黑成员的客户数等指标。
List<String>	listExternalContacts(String userId) 获取客户列表.
List<String>	listFollowUser() 企业和第三方服务商可通过此接口获取配置了客户联系功能的成员(Customer Contact)列表。
WxCpUserExternalGroupChatList	listGroupChat(Integer pageIndex, Integer pageSize, int status, String[] userIds, String[] partyIds) 该接口用于获取配置过客户群管理的客户群列表。
WxCpUserExternalUnassignList	listUnassignedList(Integer pageIndex, Integer pageSize) 企业和第三方可通过此接口，获取所有离职成员的客户列表，并可进一步调用离职成员的外部联系人再分配接口将这些客户重新分配给其他企业成员。
WxCpBaseResp	transferExternalContact(String externalUserid, String handOverUserid, String takeOverUserid) 企业可通过此接口，将已离职成员的外部联系人分配给另一个成员接替联系。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

WxCpExternalContactServiceImpl

public WxCpExternalContactServiceImpl(WxCpService mainService)

方法详细资料

getExternalContact

public WxCpUserExternalContactInfo getExternalContact(String userId)
                                               throws WxErrorException

从接口复制的说明: WxCpExternalContactService

获取外部联系人详情.

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

指定者:

getExternalContact 在接口中 WxCpExternalContactService

参数:

userId - 外部联系人的userid

返回:

.

抛出:

WxErrorException

getContactDetail

public WxCpUserExternalContactInfo getContactDetail(String userId)
                                             throws WxErrorException

从接口复制的说明: WxCpExternalContactService

获取客户详情.

 企业可通过此接口，根据外部联系人的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仅包含应用可见范围之内的成员。
 

指定者:

getContactDetail 在接口中 WxCpExternalContactService

参数:

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

返回:

.

抛出:

WxErrorException - .

listExternalContacts

public List<String> listExternalContacts(String userId)
                                  throws WxErrorException

从接口复制的说明: WxCpExternalContactService

获取客户列表.

   企业可通过此接口获取指定成员添加的客户列表。客户是指配置了客户联系功能的成员所添加的外部联系人。没有配置客户联系功能的成员，所添加的外部联系人将不会作为客户返回。

 请求方式：GET（HTTPS）
 请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN&userid=USERID

 权限说明：

 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）；
 第三方应用需拥有“企业客户”权限。
 第三方/自建应用只能获取到可见范围内的配置了客户联系功能的成员。
 

指定者:

listExternalContacts 在接口中 WxCpExternalContactService

参数:

userId - 企业成员的userid

返回:

List of External wx id

抛出:

WxErrorException - .

listFollowUser

public List<String> listFollowUser()
                            throws WxErrorException

从接口复制的说明: WxCpExternalContactService

企业和第三方服务商可通过此接口获取配置了客户联系功能的成员(Customer Contact)列表。

   企业需要使用外部联系人管理secret所获取的accesstoken来调用（accesstoken如何获取？）；
   第三方应用需拥有“企业客户”权限。
   第三方应用只能获取到可见范围内的配置了客户联系功能的成员
 

指定者:

listFollowUser 在接口中 WxCpExternalContactService

返回:

List of CpUser id

抛出:

WxErrorException - .

listUnassignedList

public WxCpUserExternalUnassignList listUnassignedList(Integer pageIndex,
                                                       Integer pageSize)
                                                throws WxErrorException

从接口复制的说明: WxCpExternalContactService

企业和第三方可通过此接口，获取所有离职成员的客户列表，并可进一步调用离职成员的外部联系人再分配接口将这些客户重新分配给其他企业成员。

指定者:

listUnassignedList 在接口中 WxCpExternalContactService

返回:

抛出:

WxErrorException

transferExternalContact

public WxCpBaseResp transferExternalContact(String externalUserid,
                                            String handOverUserid,
                                            String takeOverUserid)
                                     throws WxErrorException

从接口复制的说明: WxCpExternalContactService

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

指定者:

transferExternalContact 在接口中 WxCpExternalContactService

返回:

抛出:

WxErrorException

listGroupChat

public WxCpUserExternalGroupChatList listGroupChat(Integer pageIndex,
                                                   Integer pageSize,
                                                   int status,
                                                   String[] userIds,
                                                   String[] partyIds)
                                            throws WxErrorException

从接口复制的说明: WxCpExternalContactService

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

指定者:

listGroupChat 在接口中 WxCpExternalContactService

抛出:

WxErrorException

getGroupChat

public WxCpUserExternalGroupChatInfo getGroupChat(String chatId)
                                           throws WxErrorException

从接口复制的说明: WxCpExternalContactService

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

指定者:

getGroupChat 在接口中 WxCpExternalContactService

返回:

抛出:

WxErrorException

getUserBehaviorStatistic

public WxCpUserExternalUserBehaviorStatistic getUserBehaviorStatistic(Date startTime,
                                                                      Date endTime,
                                                                      String[] userIds,
                                                                      String[] partyIds)
                                                               throws WxErrorException

从接口复制的说明: WxCpExternalContactService

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

指定者:

getUserBehaviorStatistic 在接口中 WxCpExternalContactService

返回:

抛出:

WxErrorException

getGroupChatStatistic

public WxCpUserExternalGroupChatStatistic getGroupChatStatistic(Date startTime,
                                                                Integer orderBy,
                                                                Integer orderAsc,
                                                                Integer pageIndex,
                                                                Integer pageSize,
                                                                String[] userIds,
                                                                String[] partyIds)
                                                         throws WxErrorException

从接口复制的说明: WxCpExternalContactService

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

指定者:

getGroupChatStatistic 在接口中 WxCpExternalContactService

返回:

抛出:

WxErrorException