|
|
@@ -24,25 +24,54 @@ public interface WxCpExternalContactService { |
|
|
|
* </pre> |
|
|
|
* |
|
|
|
* @param userId 外部联系人的userid |
|
|
|
* @return . |
|
|
|
* @deprecated 建议使用 {@link #getContactDetail(String)} |
|
|
|
*/ |
|
|
|
@Deprecated |
|
|
|
WxCpUserExternalContactInfo getExternalContact(String userId) throws 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> |
|
|
|
* |
|
|
|
* @param userId 外部联系人的userid,注意不是企业成员的帐号 |
|
|
|
* @return . |
|
|
|
* @throws WxErrorException . |
|
|
|
*/ |
|
|
|
WxCpUserExternalContactInfo getContactDetail(String userId) throws WxErrorException; |
|
|
|
|
|
|
|
/** |
|
|
|
* 获取客户列表. |
|
|
|
* <pre> |
|
|
|
* 企业可通过此接口获取指定成员添加的客户列表。客户是指配置了客户联系功能的成员所添加的外部联系人。没有配置客户联系功能的成员,所添加的外部联系人将不会作为客户返回。 |
|
|
|
* |
|
|
|
* 请求方式:GET(HTTPS) |
|
|
|
* 请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN&userid=USERID |
|
|
|
* |
|
|
|
* 权限说明: |
|
|
|
* |
|
|
|
* 企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用(accesstoken如何获取?); |
|
|
|
* 第三方应用需拥有“企业客户”权限。 |
|
|
|
* 第三方应用调用时,返回的跟进人follow_user仅包含应用可见范围之内的成员。 |
|
|
|
* 第三方/自建应用只能获取到可见范围内的配置了客户联系功能的成员。 |
|
|
|
* </pre> |
|
|
|
* |
|
|
|
* @param userId 外部联系人的userid |
|
|
|
* @param userId 企业成员的userid |
|
|
|
* @return List of External wx id |
|
|
|
* @throws WxErrorException . |
|
|
|
*/ |
|
|
|
List<String> listExternalContacts(String userId) throws WxErrorException; |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* 企业和第三方服务商可通过此接口获取配置了客户联系功能的成员(Customer Contact)列表。 |
|
|
|
* <pre> |
|
|
@@ -52,7 +81,9 @@ public interface WxCpExternalContactService { |
|
|
|
* </pre> |
|
|
|
* |
|
|
|
* @return List of CpUser id |
|
|
|
* @throws WxErrorException . |
|
|
|
*/ |
|
|
|
@Deprecated |
|
|
|
List<String> listFollowUser() throws WxErrorException; |
|
|
|
|
|
|
|
} |