yx lin
4 months ago
committed by
GitHub
GitHub
185 changed files with 7252 additions and 12 deletions
@ -0,0 +1,3 @@ |
|||||
|
<Weavers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="FodyWeavers.xsd"> |
||||
|
<ConfigureAwait ContinueOnCapturedContext="false" /> |
||||
|
</Weavers> |
||||
@ -0,0 +1,30 @@ |
|||||
|
<?xml version="1.0" encoding="utf-8"?> |
||||
|
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"> |
||||
|
<!-- This file was generated by Fody. Manual changes to this file will be lost when your project is rebuilt. --> |
||||
|
<xs:element name="Weavers"> |
||||
|
<xs:complexType> |
||||
|
<xs:all> |
||||
|
<xs:element name="ConfigureAwait" minOccurs="0" maxOccurs="1"> |
||||
|
<xs:complexType> |
||||
|
<xs:attribute name="ContinueOnCapturedContext" type="xs:boolean" /> |
||||
|
</xs:complexType> |
||||
|
</xs:element> |
||||
|
</xs:all> |
||||
|
<xs:attribute name="VerifyAssembly" type="xs:boolean"> |
||||
|
<xs:annotation> |
||||
|
<xs:documentation>'true' to run assembly verification (PEVerify) on the target assembly after all weavers have been executed.</xs:documentation> |
||||
|
</xs:annotation> |
||||
|
</xs:attribute> |
||||
|
<xs:attribute name="VerifyIgnoreCodes" type="xs:string"> |
||||
|
<xs:annotation> |
||||
|
<xs:documentation>A comma-separated list of error codes that can be safely ignored in assembly verification.</xs:documentation> |
||||
|
</xs:annotation> |
||||
|
</xs:attribute> |
||||
|
<xs:attribute name="GenerateXsd" type="xs:boolean"> |
||||
|
<xs:annotation> |
||||
|
<xs:documentation>'false' to turn off automatic generation of the XML Schema file.</xs:documentation> |
||||
|
</xs:annotation> |
||||
|
</xs:attribute> |
||||
|
</xs:complexType> |
||||
|
</xs:element> |
||||
|
</xs:schema> |
||||
@ -0,0 +1,27 @@ |
|||||
|
<Project Sdk="Microsoft.NET.Sdk"> |
||||
|
|
||||
|
<Import Project="..\..\..\..\configureawait.props" /> |
||||
|
<Import Project="..\..\..\..\common.props" /> |
||||
|
|
||||
|
<PropertyGroup> |
||||
|
<TargetFrameworks>netstandard2.0;netstandard2.1;net8.0;net9.0</TargetFrameworks> |
||||
|
<AssemblyName>LINGYUN.Abp.WeChat.Work.ExternalContact</AssemblyName> |
||||
|
<PackageId>LINGYUN.Abp.WeChat.Work.ExternalContact</PackageId> |
||||
|
<GenerateAssemblyConfigurationAttribute>false</GenerateAssemblyConfigurationAttribute> |
||||
|
<GenerateAssemblyCompanyAttribute>false</GenerateAssemblyCompanyAttribute> |
||||
|
<GenerateAssemblyProductAttribute>false</GenerateAssemblyProductAttribute> |
||||
|
<GenerateDocumentationFile>True</GenerateDocumentationFile> |
||||
|
<Nullable>enable</Nullable> |
||||
|
<RootNamespace /> |
||||
|
</PropertyGroup> |
||||
|
|
||||
|
<ItemGroup> |
||||
|
<None Remove="LINGYUN\Abp\WeChat\Work\ExternalContact\Localization\Resources\*.json" /> |
||||
|
<EmbeddedResource Include="LINGYUN\Abp\WeChat\Work\ExternalContact\Localization\Resources\*.json" /> |
||||
|
</ItemGroup> |
||||
|
|
||||
|
<ItemGroup> |
||||
|
<ProjectReference Include="..\LINGYUN.Abp.WeChat.Work\LINGYUN.Abp.WeChat.Work.csproj" /> |
||||
|
</ItemGroup> |
||||
|
|
||||
|
</Project> |
||||
@ -0,0 +1,78 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common; |
||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
using LINGYUN.Abp.WeChat.Work.Localization; |
||||
|
using Volo.Abp.Localization; |
||||
|
using Volo.Abp.Modularity; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact; |
||||
|
|
||||
|
[DependsOn(typeof(AbpWeChatWorkModule))] |
||||
|
public class AbpWeChatWorkExternalContactModule : AbpModule |
||||
|
{ |
||||
|
public override void ConfigureServices(ServiceConfigurationContext context) |
||||
|
{ |
||||
|
Configure<AbpWeChatWorkMessageResolveOptions>(options => |
||||
|
{ |
||||
|
// 企业客户变更事件
|
||||
|
options.MapEvent("change_external_contact", context => |
||||
|
{ |
||||
|
var changeType = context.GetMessageData("ChangeType"); |
||||
|
return changeType switch |
||||
|
{ |
||||
|
"add_external_contact" => context.GetWeChatMessage<ExternalContactCreateEvent>(), |
||||
|
"edit_external_contact" => context.GetWeChatMessage<ExternalContactUpdateEvent>(), |
||||
|
"add_half_external_contact" => context.GetWeChatMessage<ExternalContactCreateHalfEvent>(), |
||||
|
"del_external_contact" => context.GetWeChatMessage<ExternalContactDeleteEvent>(), |
||||
|
"del_follow_user" => context.GetWeChatMessage<ExternalContactDeleteFollowUserEvent>(), |
||||
|
"transfer_fail" => context.GetWeChatMessage<ExternalContactTransferFailEvent>(), |
||||
|
_ => throw new AbpWeChatException($"Contact change event change_external_contact:{changeType} is not mounted!"), |
||||
|
}; |
||||
|
}); |
||||
|
// 客户群变更事件
|
||||
|
options.MapEvent("change_external_chat", context => |
||||
|
{ |
||||
|
var changeType = context.GetMessageData("ChangeType"); |
||||
|
switch (changeType) |
||||
|
{ |
||||
|
case "create": return context.GetWeChatMessage<ExternalChatCreateEvent>(); |
||||
|
case "update": |
||||
|
// 客户群变更事件
|
||||
|
var updateDetail = context.GetMessageData("UpdateDetail"); |
||||
|
return updateDetail switch |
||||
|
{ |
||||
|
"add_member" => context.GetWeChatMessage<ExternalChatAddMemberEvent>(), |
||||
|
"del_member" => context.GetWeChatMessage<ExternalChaDelMemberEvent>(), |
||||
|
"change_owner" => context.GetWeChatMessage<ExternalChatChangeOwnerEvent>(), |
||||
|
"change_name" => context.GetWeChatMessage<ExternalChatChangeNameEvent>(), |
||||
|
"change_notice" => context.GetWeChatMessage<ExternalChatChangeNoticeEvent>(), |
||||
|
_ => throw new AbpWeChatException($"Contact change event change_external_chat:{changeType}:{updateDetail} is not mounted!"), |
||||
|
}; |
||||
|
case "dismiss": return context.GetWeChatMessage<ExternalChatDismissEvent>(); |
||||
|
default: throw new AbpWeChatException($"Contact change event change_external_chat:{changeType} is not mounted!"); |
||||
|
} |
||||
|
}); |
||||
|
// 企业客户标签事件
|
||||
|
options.MapEvent("change_external_tag", context => |
||||
|
{ |
||||
|
var changeType = context.GetMessageData("ChangeType"); |
||||
|
return changeType switch |
||||
|
{ |
||||
|
"create" => context.GetWeChatMessage<ExternalTagCreateEvent>(), |
||||
|
"update" => context.GetWeChatMessage<ExternalTagUpdateEvent>(), |
||||
|
"delete" => context.GetWeChatMessage<ExternalTagDeleteEvent>(), |
||||
|
"shuffle" => context.GetWeChatMessage<ExternalTagShuffleEvent>(), |
||||
|
_ => throw new AbpWeChatException($"Contact change event change_external_tag:{changeType} is not mounted!"), |
||||
|
}; |
||||
|
}); |
||||
|
}); |
||||
|
|
||||
|
Configure<AbpLocalizationOptions>(options => |
||||
|
{ |
||||
|
options.Resources |
||||
|
.Get<WeChatWorkResource>() |
||||
|
.AddVirtualJson("/LINGYUN/Abp/WeChat/Work/ExternalContact/Localization/Resources"); |
||||
|
}); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,24 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Response; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments; |
||||
|
/// <summary>
|
||||
|
/// 附件资源接口
|
||||
|
/// </summary>
|
||||
|
public interface IWeChatWorkAttachmentProvider |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 上传附件资源
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/90253"/>
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkUploadAttachmentResponse> UploadAsync( |
||||
|
WeChatWorkUploadAttachmentRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
} |
||||
@ -0,0 +1,20 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Models; |
||||
|
/// <summary>
|
||||
|
/// 附件类型
|
||||
|
/// </summary>
|
||||
|
[Description("附件类型")] |
||||
|
public enum AttachmentType |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 朋友圈
|
||||
|
/// </summary>
|
||||
|
[Description("朋友圈")] |
||||
|
Moments = 1, |
||||
|
/// <summary>
|
||||
|
/// 商品图册
|
||||
|
/// </summary>
|
||||
|
[Description("商品图册")] |
||||
|
ProductCatalogue = 2, |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Models; |
||||
|
/// <summary>
|
||||
|
/// 媒体文件类型
|
||||
|
/// </summary>
|
||||
|
[Description("媒体文件类型")] |
||||
|
public enum MediaType |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 图片
|
||||
|
/// </summary>
|
||||
|
[Description("图片")] |
||||
|
Image = 1, |
||||
|
/// <summary>
|
||||
|
/// 视频
|
||||
|
/// </summary>
|
||||
|
[Description("视频")] |
||||
|
Video = 2, |
||||
|
/// <summary>
|
||||
|
/// 普通文件
|
||||
|
/// </summary>
|
||||
|
[Description("普通文件")] |
||||
|
File = 3, |
||||
|
} |
||||
@ -0,0 +1,41 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Models; |
||||
|
using Volo.Abp; |
||||
|
using Volo.Abp.Content; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Request; |
||||
|
/// <summary>
|
||||
|
/// 上传附件资源请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/95098" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkUploadAttachmentRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 媒体文件类型
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
public MediaType MediaType { get; } |
||||
|
/// <summary>
|
||||
|
/// 附件类型
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
public AttachmentType AttachmentType { get; } |
||||
|
/// <summary>
|
||||
|
/// 媒体文件
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
public IRemoteStreamContent Content { get; } |
||||
|
public WeChatWorkUploadAttachmentRequest( |
||||
|
MediaType mediaType, |
||||
|
AttachmentType attachmentType, |
||||
|
IRemoteStreamContent content) |
||||
|
{ |
||||
|
Check.NotNull(content, nameof(content)); |
||||
|
|
||||
|
MediaType = mediaType; |
||||
|
AttachmentType = attachmentType; |
||||
|
Content = content; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,35 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Response; |
||||
|
/// <summary>
|
||||
|
/// 上传附件资源响应结果
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/95098" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkUploadAttachmentResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 媒体文件类型，分别有图片（image）、语音（voice）、视频（video），普通文件(file)
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("type")] |
||||
|
[JsonPropertyName("type")] |
||||
|
public string MediaType { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 媒体文件上传后获取的唯一标识，三天有效，可使用获取临时素材接口获取
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("media_id")] |
||||
|
[JsonPropertyName("media_id")] |
||||
|
public string MediaId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 媒体文件上传时间戳
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("created_at")] |
||||
|
[JsonPropertyName("created_at")] |
||||
|
public long CreatedAt { get; set; } |
||||
|
} |
||||
@ -0,0 +1,41 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments.Response; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Features; |
||||
|
using LINGYUN.Abp.WeChat.Work.Token; |
||||
|
using Microsoft.Extensions.DependencyInjection; |
||||
|
using System.Net.Http; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
using Volo.Abp.DependencyInjection; |
||||
|
using Volo.Abp.Features; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Attachments; |
||||
|
|
||||
|
[RequiresFeature(WeChatWorkExternalContactFeatureNames.Enable)] |
||||
|
public class WeChatWorkAttachmentProvider : IWeChatWorkAttachmentProvider, ISingletonDependency |
||||
|
{ |
||||
|
protected IHttpClientFactory HttpClientFactory { get; } |
||||
|
protected IWeChatWorkTokenProvider WeChatWorkTokenProvider { get; } |
||||
|
|
||||
|
public WeChatWorkAttachmentProvider( |
||||
|
IHttpClientFactory httpClientFactory, |
||||
|
IWeChatWorkTokenProvider weChatWorkTokenProvider) |
||||
|
{ |
||||
|
HttpClientFactory = httpClientFactory; |
||||
|
WeChatWorkTokenProvider = weChatWorkTokenProvider; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkUploadAttachmentResponse> UploadAsync( |
||||
|
WeChatWorkUploadAttachmentRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.UploadAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkUploadAttachmentResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,24 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts.Response; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts; |
||||
|
/// <summary>
|
||||
|
/// 外部联系人接口
|
||||
|
/// </summary>
|
||||
|
public interface IWeChatWorkExternalContactProvider |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 获取已服务的外部联系人
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/99434" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetExternalContactListResponse> GetExternalContactListAsync( |
||||
|
WeChatWorkGetExternalContactListRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
} |
||||
@ -0,0 +1,73 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts.Models; |
||||
|
/// <summary>
|
||||
|
/// 外部联系人
|
||||
|
/// </summary>
|
||||
|
public class ExternalContactInfo |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 是否被成员标记为客户
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("is_customer")] |
||||
|
[JsonPropertyName("is_customer")] |
||||
|
public bool IsCustomer { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人临时ID
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
///
|
||||
|
/// 外部联系人临时id是一个外部联系人的唯一标识，企业可根据此id对外部联系人进行去重统计。<br />
|
||||
|
/// 但外部联系人临时id仅在一轮遍历查询（从首个分页查询开始到最后一个分页查询完毕）中唯一；<br />
|
||||
|
/// 每次请求首个数据分页（cursor为空）时，返回的外部联系人临时id和next_cursor将发生变化。
|
||||
|
/// </remarks>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("tmp_openid")] |
||||
|
[JsonPropertyName("tmp_openid")] |
||||
|
public string TmpOpenId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的externaluserid（如果是客户才返回）
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("external_userid")] |
||||
|
[JsonPropertyName("external_userid")] |
||||
|
public string? ExternalUserId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 脱敏后的外部联系人昵称（如果是其他外部联系人才返回）
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("name")] |
||||
|
[JsonPropertyName("name")] |
||||
|
public string? Name { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 添加此外部联系人的企业成员或外部联系人所在群聊的群主userid
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("follow_userid")] |
||||
|
[JsonPropertyName("follow_userid")] |
||||
|
public string? FollowUserId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人所在的群聊ID（如果群聊被成员标记为客户群才返回）
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("chat_id")] |
||||
|
[JsonPropertyName("chat_id")] |
||||
|
public string? ChatId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人所在群聊的群名（如果群聊未被成员标记为客户群才返回）
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("chat_name")] |
||||
|
[JsonPropertyName("chat_name")] |
||||
|
public string? ChatName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人首次添加/进群的时间
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("add_time")] |
||||
|
[JsonPropertyName("add_time")] |
||||
|
public long AddTime { get; set; } |
||||
|
} |
||||
@ -0,0 +1,36 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts.Request; |
||||
|
/// <summary>
|
||||
|
/// 获取已服务的外部联系人请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/99434" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetExternalContactListRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// cursor具有有效期，请勿缓存后使用
|
||||
|
/// </remarks>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("cursor")] |
||||
|
[JsonPropertyName("cursor")] |
||||
|
public string? Cursor { get; } |
||||
|
/// <summary>
|
||||
|
/// 返回的最大记录数，整型，默认为1000
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("limit")] |
||||
|
[JsonPropertyName("limit")] |
||||
|
public int? Limit { get; } |
||||
|
public WeChatWorkGetExternalContactListRequest(string? cursor = null, int? limit = 1000) |
||||
|
{ |
||||
|
Cursor = cursor; |
||||
|
Limit = limit; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,29 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取已服务的外部联系人响应结果
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92994" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetExternalContactListResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 外部联系人列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("info_list")] |
||||
|
[JsonPropertyName("info_list")] |
||||
|
public ExternalContactInfo[] InfoList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 分页游标，再下次请求时填写以获取之后分页的记录，如果已经没有更多的数据则返回空,有效期为4小时
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("next_cursor")] |
||||
|
[JsonPropertyName("next_cursor")] |
||||
|
public string? NextCursor { get; set; } |
||||
|
} |
||||
@ -0,0 +1,44 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts.Response; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Features; |
||||
|
using LINGYUN.Abp.WeChat.Work.Token; |
||||
|
using Microsoft.Extensions.DependencyInjection; |
||||
|
using System.Net.Http; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
using Volo.Abp; |
||||
|
using Volo.Abp.DependencyInjection; |
||||
|
using Volo.Abp.Features; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Contacts; |
||||
|
|
||||
|
[RequiresFeature(WeChatWorkExternalContactFeatureNames.Enable)] |
||||
|
public class WeChatWorkExternalContactProvider : IWeChatWorkExternalContactProvider, ISingletonDependency |
||||
|
{ |
||||
|
protected IHttpClientFactory HttpClientFactory { get; } |
||||
|
protected IWeChatWorkTokenProvider WeChatWorkTokenProvider { get; } |
||||
|
|
||||
|
public WeChatWorkExternalContactProvider( |
||||
|
IHttpClientFactory httpClientFactory, |
||||
|
IWeChatWorkTokenProvider weChatWorkTokenProvider) |
||||
|
{ |
||||
|
HttpClientFactory = httpClientFactory; |
||||
|
WeChatWorkTokenProvider = weChatWorkTokenProvider; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetExternalContactListResponse> GetExternalContactListAsync( |
||||
|
WeChatWorkGetExternalContactListRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
Check.NotNull(request, nameof(request)); |
||||
|
|
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetExternalContactListAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetExternalContactListResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,62 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers; |
||||
|
/// <summary>
|
||||
|
/// 客户管理接口
|
||||
|
/// </summary>
|
||||
|
public interface IWeChatWorkCustomerProvider |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 获取客户列表
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92113" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="userId">企业成员的userid</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetCustomerListResponse> GetCustomerListAsync( |
||||
|
string userId, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 批量获取客户详情
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92994" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkBulkGetCustomerResponse> BulkGetCustomerAsync( |
||||
|
WeChatWorkBulkGetCustomerRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 获取客户详情
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92114" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="externalUserid">外部联系人的userid，注意不是企业成员的账号</param>
|
||||
|
/// <param name="cursor">上次请求返回的next_cursor</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetCustomerResponse> GetCustomerAsync( |
||||
|
string externalUserid, |
||||
|
string? cursor = null, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 修改客户备注信息
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92115" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkResponse> UpdateCustomerRemarkAsync( |
||||
|
WeChatWorkUpdateCustomerRemarkRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
} |
||||
@ -0,0 +1,87 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers; |
||||
|
/// <summary>
|
||||
|
/// 客户联系规则组管理
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883" />
|
||||
|
/// </remarks>
|
||||
|
public interface IWeChatWorkCustomerStrategyProvider |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 获取规则组列表
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E5%88%97%E8%A1%A8" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetCustomerStrategyListResponse> GetCustomerStrategyListAsync( |
||||
|
WeChatWorkGetCustomerStrategyListRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 获取规则组
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E8%AF%A6%E6%83%85" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetCustomerStrategyResponse> GetCustomerStrategyAsync( |
||||
|
WeChatWorkGetCustomerStrategyRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 获取规则组管理范围
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetCustomerStrategyRangeResponse> GetCustomerStrategyRangeAsync( |
||||
|
WeChatWorkGetCustomerStrategyRangeRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 创建新的规则组
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E5%88%9B%E5%BB%BA%E6%96%B0%E7%9A%84%E8%A7%84%E5%88%99%E7%BB%84" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkCreateCustomerStrategyResponse> CreateCustomerStrategyAsync( |
||||
|
WeChatWorkCreateCustomerStrategyRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 编辑规则组及其管理范围
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E7%BC%96%E8%BE%91%E8%A7%84%E5%88%99%E7%BB%84%E5%8F%8A%E5%85%B6%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkResponse> UpdateCustomerStrategyAsync( |
||||
|
WeChatWorkUpdateCustomerStrategyRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 删除规则组
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E5%88%A0%E9%99%A4%E8%A7%84%E5%88%99%E7%BB%84" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkResponse> DeleteCustomerStrategyAsync( |
||||
|
WeChatWorkDeleteCustomerStrategyRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
} |
||||
@ -0,0 +1,18 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 规则组
|
||||
|
/// </summary>
|
||||
|
public class CustomerStrategy |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组id
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy_id")] |
||||
|
[JsonPropertyName("strategy_id")] |
||||
|
public int StrategyId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,46 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 规则组详情
|
||||
|
/// </summary>
|
||||
|
public class CustomerStrategyInfo : CustomerStrategy |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 父规则组id， 如果当前规则组没父规则组，则为0
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("parent_id")] |
||||
|
[JsonPropertyName("parent_id")] |
||||
|
public int ParentId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 规则组名称
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy_name")] |
||||
|
[JsonPropertyName("strategy_name")] |
||||
|
public string StrategyName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 规则组创建时间戳
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("create_time")] |
||||
|
[JsonPropertyName("create_time")] |
||||
|
public long CreateTime { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 规则组管理员userid列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("admin_list")] |
||||
|
[JsonPropertyName("admin_list")] |
||||
|
public string[] AdminList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 规则组权限
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("privilege")] |
||||
|
[JsonPropertyName("privilege")] |
||||
|
public CustomerStrategyPrivilege Privilege { get; set; } |
||||
|
} |
||||
@ -0,0 +1,183 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 规则组权限
|
||||
|
/// </summary>
|
||||
|
public class CustomerStrategyPrivilege |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 查看客户列表，基础权限，不可取消
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("view_customer_list")] |
||||
|
[JsonPropertyName("view_customer_list")] |
||||
|
public bool ViewCustomerList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 查看客户统计数据，基础权限，不可取消
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("view_customer_data")] |
||||
|
[JsonPropertyName("view_customer_data")] |
||||
|
public bool ViewCustomerData { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 查看群聊列表，基础权限，不可取消
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("view_room_list")] |
||||
|
[JsonPropertyName("view_room_list")] |
||||
|
public bool ViewRoomList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 可使用联系我，基础权限，不可取消
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("contact_me")] |
||||
|
[JsonPropertyName("contact_me")] |
||||
|
public bool ContactMe { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 可加入群聊，基础权限，不可取消
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("join_room")] |
||||
|
[JsonPropertyName("join_room")] |
||||
|
public bool JoinRoom { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许分享客户给其他成员，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("share_customer")] |
||||
|
[JsonPropertyName("share_customer")] |
||||
|
public bool ShareCustomer { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许分配离职成员客户，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("oper_resign_customer")] |
||||
|
[JsonPropertyName("oper_resign_customer")] |
||||
|
public bool OperResignCustomer { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许分配离职成员客户群，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("oper_resign_group")] |
||||
|
[JsonPropertyName("oper_resign_group")] |
||||
|
public bool OperResignGroup { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许给企业客户发送消息，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("send_customer_msg")] |
||||
|
[JsonPropertyName("send_customer_msg")] |
||||
|
public bool SendCustomerMsg { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许配置欢迎语，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("edit_welcome_msg")] |
||||
|
[JsonPropertyName("edit_welcome_msg")] |
||||
|
public bool EditWelcomeMsg { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许查看成员联系客户统计，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("view_behavior_data")] |
||||
|
[JsonPropertyName("view_behavior_data")] |
||||
|
public bool ViewBehaviorData { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许查看群聊数据统计，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("view_room_data")] |
||||
|
[JsonPropertyName("view_room_data")] |
||||
|
public bool ViewRoomData { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许发送消息到企业的客户群，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("send_group_msg")] |
||||
|
[JsonPropertyName("send_group_msg")] |
||||
|
public bool SendGroupMsg { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 允许对企业客户群进行去重，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("room_deduplication")] |
||||
|
[JsonPropertyName("room_deduplication")] |
||||
|
public bool RoomDeduplication { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 配置快捷回复，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("rapid_reply")] |
||||
|
[JsonPropertyName("rapid_reply")] |
||||
|
public bool RapidReply { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 转接在职成员的客户，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("onjob_customer_transfer")] |
||||
|
[JsonPropertyName("onjob_customer_transfer")] |
||||
|
public bool OnjobCustomerTransfer { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 编辑企业成员防骚扰规则，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("edit_anti_spam_rule")] |
||||
|
[JsonPropertyName("edit_anti_spam_rule")] |
||||
|
public bool EditAntiSpamRule { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 导出客户列表，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("export_customer_list")] |
||||
|
[JsonPropertyName("export_customer_list")] |
||||
|
public bool ExportCustomerList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 导出成员客户统计，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("export_customer_data")] |
||||
|
[JsonPropertyName("export_customer_data")] |
||||
|
public bool ExportCustomerData { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 导出客户群列表，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("export_customer_group_list")] |
||||
|
[JsonPropertyName("export_customer_group_list")] |
||||
|
public bool ExportCustomerGroupList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 配置企业客户标签，默认为true
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("manage_customer_tag")] |
||||
|
[JsonPropertyName("manage_customer_tag")] |
||||
|
public bool ManageCustomerTag { get; set; } |
||||
|
|
||||
|
public static CustomerStrategyPrivilege Default() |
||||
|
{ |
||||
|
return new CustomerStrategyPrivilege |
||||
|
{ |
||||
|
ViewCustomerList = true, |
||||
|
ViewCustomerData = true, |
||||
|
ViewRoomList = true, |
||||
|
ContactMe = true, |
||||
|
JoinRoom = true, |
||||
|
ShareCustomer = true, |
||||
|
EditWelcomeMsg = true, |
||||
|
ViewBehaviorData = true, |
||||
|
ViewRoomData = true, |
||||
|
SendGroupMsg = true, |
||||
|
RoomDeduplication = true, |
||||
|
RapidReply = true, |
||||
|
OnjobCustomerTransfer = true, |
||||
|
EditAntiSpamRule = true, |
||||
|
ExportCustomerList = true, |
||||
|
ExportCustomerData = true, |
||||
|
ExportCustomerGroupList = true, |
||||
|
ManageCustomerTag = true, |
||||
|
}; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,61 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 规则组管理范围
|
||||
|
/// </summary>
|
||||
|
public class CustomerStrategyRange |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 节点类型
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("type")] |
||||
|
[JsonPropertyName("type")] |
||||
|
public CustomerStrategyRangeType Type { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 管理范围内配置的成员userid，仅 Type为<see cref="CustomerStrategyRangeType.Member"/> 时返回
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("userid")] |
||||
|
[JsonPropertyName("userid")] |
||||
|
public string? UserId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 管理范围内配置的部门partyid，仅 Type为<see cref="CustomerStrategyRangeType.Part"/> 时返回
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("partyid")] |
||||
|
[JsonPropertyName("partyid")] |
||||
|
public int? PartyId { get; set; } |
||||
|
|
||||
|
public CustomerStrategyRange() |
||||
|
{ |
||||
|
|
||||
|
} |
||||
|
|
||||
|
private CustomerStrategyRange( |
||||
|
CustomerStrategyRangeType type, |
||||
|
string? userId = null, |
||||
|
int? partyId = null) |
||||
|
{ |
||||
|
Type = type; |
||||
|
UserId = userId; |
||||
|
PartyId = partyId; |
||||
|
} |
||||
|
|
||||
|
public static CustomerStrategyRange Member(string userId) |
||||
|
{ |
||||
|
Check.NotNullOrWhiteSpace(userId, nameof(userId)); |
||||
|
|
||||
|
return new CustomerStrategyRange(CustomerStrategyRangeType.Member, userId); |
||||
|
} |
||||
|
public static CustomerStrategyRange Party(int partyId) |
||||
|
{ |
||||
|
Check.NotDefaultOrNull<int>(partyId, nameof(partyId)); |
||||
|
|
||||
|
return new CustomerStrategyRange(CustomerStrategyRangeType.Part, partyId: partyId); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,20 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 节点类型
|
||||
|
/// </summary>
|
||||
|
[Description("节点类型")] |
||||
|
public enum CustomerStrategyRangeType |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 成员
|
||||
|
/// </summary>
|
||||
|
[Description("成员")] |
||||
|
Member = 1, |
||||
|
/// <summary>
|
||||
|
/// 部门
|
||||
|
/// </summary>
|
||||
|
[Description("部门")] |
||||
|
Part = 2 |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 外部联系人性别
|
||||
|
/// </summary>
|
||||
|
[Description("外部联系人性别")] |
||||
|
public enum ExternalContactGender |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 未知
|
||||
|
/// </summary>
|
||||
|
[Description("未知")] |
||||
|
None = 0, |
||||
|
/// <summary>
|
||||
|
/// 男性
|
||||
|
/// </summary>
|
||||
|
[Description("男性")] |
||||
|
Male = 1, |
||||
|
/// <summary>
|
||||
|
/// 女性
|
||||
|
/// </summary>
|
||||
|
[Description("女性")] |
||||
|
FeMale = 2, |
||||
|
} |
||||
@ -0,0 +1,88 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 外部联系人信息
|
||||
|
/// </summary>
|
||||
|
public class ExternalContactInfo |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的userid
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("external_userid")] |
||||
|
[JsonPropertyName("external_userid")] |
||||
|
public string ExternalUserId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的名称
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 如果是微信用户，则返回其微信昵称。<br />
|
||||
|
/// 如果是企业微信联系人，则返回其设置对外展示的别名或实名
|
||||
|
/// </remarks>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("name")] |
||||
|
[JsonPropertyName("name")] |
||||
|
public string Name { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人头像
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("avatar")] |
||||
|
[JsonPropertyName("avatar")] |
||||
|
public string? Avatar { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的类型
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("type")] |
||||
|
[JsonPropertyName("type")] |
||||
|
public ExternalContactType Type { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人性别
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("gender")] |
||||
|
[JsonPropertyName("gender")] |
||||
|
public ExternalContactGender Gender { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人在微信开放平台的唯一身份标识（微信unionid），通过此字段企业可将外部联系人与公众号/小程序用户关联起来。<br />
|
||||
|
/// 仅当联系人类型是微信用户，且企业绑定了微信开发者ID有此字段
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("unionid")] |
||||
|
[JsonPropertyName("unionid")] |
||||
|
public string? UnionId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的职位，如果外部企业或用户选择隐藏职位，则不返回，仅当联系人类型是企业微信用户时有此字段
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("position")] |
||||
|
[JsonPropertyName("position")] |
||||
|
public string? Position { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人所在企业的简称，仅当联系人类型是企业微信用户时有此字段
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("corp_name")] |
||||
|
[JsonPropertyName("corp_name")] |
||||
|
public string? CorpName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人所在企业的主体名称，仅当联系人类型是企业微信用户时有此字段<br />
|
||||
|
/// 仅企业自建应用可获取
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("corp_full_name")] |
||||
|
[JsonPropertyName("corp_full_name")] |
||||
|
public string? CorpFullName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的自定义展示信息
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("external_profile")] |
||||
|
[JsonPropertyName("external_profile")] |
||||
|
public ExternalProfile? ExternalProfile { get; set; } |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 外部联系人列表
|
||||
|
/// </summary>
|
||||
|
public class ExternalContactList |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 客户的基本信息
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("external_contact")] |
||||
|
[JsonPropertyName("external_contact")] |
||||
|
public ExternalContactInfo ExternalContact { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 企业成员客户跟进信息
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("follow_info")] |
||||
|
[JsonPropertyName("follow_info")] |
||||
|
public FollowUser FollowUser { get; set; } |
||||
|
} |
||||
@ -0,0 +1,20 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 外部联系人类型
|
||||
|
/// </summary>
|
||||
|
[Description("外部联系人类型")] |
||||
|
public enum ExternalContactType |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 微信用户
|
||||
|
/// </summary>
|
||||
|
[Description("微信用户")] |
||||
|
WeChat = 1, |
||||
|
/// <summary>
|
||||
|
/// 企业微信用户
|
||||
|
/// </summary>
|
||||
|
[Description("企业微信用户")] |
||||
|
WeChatWork = 2, |
||||
|
} |
||||
@ -0,0 +1,92 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Collections.Generic; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 添加了外部联系人的企业成员
|
||||
|
/// </summary>
|
||||
|
public class FollowUser |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 添加了此外部联系人的企业成员userid
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("userid")] |
||||
|
[JsonPropertyName("userid")] |
||||
|
public string UserId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 发起添加的userid<br />
|
||||
|
/// 如果成员主动添加，为成员的userid；<br />
|
||||
|
/// 如果是客户主动添加，则为客户的外部联系人userid；<br />
|
||||
|
/// 如果是内部成员共享/管理员分配，则为对应的成员/管理员userid
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("oper_userid")] |
||||
|
[JsonPropertyName("oper_userid")] |
||||
|
public string OperUserId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 企业自定义的state参数，用于区分客户具体是通过哪个「联系我」或获客链接添加
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("state")] |
||||
|
[JsonPropertyName("state")] |
||||
|
public string? State { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员对此外部联系人的备注
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("remark")] |
||||
|
[JsonPropertyName("remark")] |
||||
|
public string? Remark { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员对此外部联系人的描述
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("description")] |
||||
|
[JsonPropertyName("description")] |
||||
|
public string? Description { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员添加此外部联系人的时间
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("createtime")] |
||||
|
[JsonPropertyName("createtime")] |
||||
|
public long Createtime { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人所打标签列表
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("tags")] |
||||
|
[JsonPropertyName("tags")] |
||||
|
public List<FollowUserTag>? Tags { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员对此微信客户备注的企业名称（仅微信客户有该字段）
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("remark_corp_name")] |
||||
|
[JsonPropertyName("remark_corp_name")] |
||||
|
public string? RemarkCorpName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员对此客户备注的手机号码，代开发自建应用需要管理员授权才可以获取
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("remark_mobiles")] |
||||
|
[JsonPropertyName("remark_mobiles")] |
||||
|
public List<string>? RemarkMobiles { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员添加此客户的来源
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("add_way")] |
||||
|
[JsonPropertyName("add_way")] |
||||
|
public FollowUserAddWay AddWay { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员添加此客户的来源add_way为10时，对应的视频号信息
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("wechat_channels")] |
||||
|
[JsonPropertyName("wechat_channels")] |
||||
|
public FollowUserWechatChannel? WechatChannel { get; set; } |
||||
|
} |
||||
@ -0,0 +1,125 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户来源
|
||||
|
/// </summary>
|
||||
|
[Description("客户来源")] |
||||
|
public enum FollowUserAddWay |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 未知来源
|
||||
|
/// </summary>
|
||||
|
[Description("未知来源")] |
||||
|
None = 0, |
||||
|
/// <summary>
|
||||
|
/// 扫描二维码
|
||||
|
/// </summary>
|
||||
|
[Description("扫描二维码")] |
||||
|
ScanQrCode = 1, |
||||
|
/// <summary>
|
||||
|
/// 搜索手机号
|
||||
|
/// </summary>
|
||||
|
[Description("搜索手机号")] |
||||
|
SearchPhoneNumber = 2, |
||||
|
/// <summary>
|
||||
|
/// 名片分享
|
||||
|
/// </summary>
|
||||
|
[Description("名片分享")] |
||||
|
SharedCard = 3, |
||||
|
/// <summary>
|
||||
|
/// 群聊
|
||||
|
/// </summary>
|
||||
|
[Description("群聊")] |
||||
|
GroupChat = 4, |
||||
|
/// <summary>
|
||||
|
/// 手机通讯录
|
||||
|
/// </summary>
|
||||
|
[Description("手机通讯录")] |
||||
|
PhoneBook = 5, |
||||
|
/// <summary>
|
||||
|
/// 微信联系人
|
||||
|
/// </summary>
|
||||
|
[Description("微信联系人")] |
||||
|
WeChatContact = 6, |
||||
|
/// <summary>
|
||||
|
/// 安装第三方应用时自动添加的客服人员
|
||||
|
/// </summary>
|
||||
|
[Description("安装第三方应用时自动添加的客服人员")] |
||||
|
InstallThirdPartyApp = 8, |
||||
|
/// <summary>
|
||||
|
/// 搜索邮箱
|
||||
|
/// </summary>
|
||||
|
[Description("搜索邮箱")] |
||||
|
SearchEmail = 9, |
||||
|
/// <summary>
|
||||
|
/// 视频号添加
|
||||
|
/// </summary>
|
||||
|
[Description("视频号添加")] |
||||
|
WechatChannel = 10, |
||||
|
/// <summary>
|
||||
|
/// 通过日程参与人添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过日程参与人添加")] |
||||
|
SchedulePart = 11, |
||||
|
/// <summary>
|
||||
|
/// 通过会议参与人添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过会议参与人添加")] |
||||
|
MeetPart = 12, |
||||
|
/// <summary>
|
||||
|
/// 添加微信好友对应的企业微信
|
||||
|
/// </summary>
|
||||
|
[Description("添加微信好友对应的企业微信")] |
||||
|
WeChatFriend = 13, |
||||
|
/// <summary>
|
||||
|
/// 通过智慧硬件专属客服添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过智慧硬件专属客服添加")] |
||||
|
SmartHardware = 14, |
||||
|
/// <summary>
|
||||
|
/// 通过上门服务客服添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过上门服务客服添加")] |
||||
|
DoorService = 15, |
||||
|
/// <summary>
|
||||
|
/// 通过获客链接添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过获客链接添加")] |
||||
|
CustomerAcqLink = 16, |
||||
|
/// <summary>
|
||||
|
/// 通过定制开发添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过定制开发添加")] |
||||
|
CustomDevelopment = 17, |
||||
|
/// <summary>
|
||||
|
/// 通过需求回复添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过需求回复添加")] |
||||
|
DemandResponse = 18, |
||||
|
/// <summary>
|
||||
|
/// 通过第三方售前客服添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过第三方售前客服添加")] |
||||
|
ThirdPartyPreSales = 21, |
||||
|
/// <summary>
|
||||
|
/// 通过可能的商务伙伴添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过可能的商务伙伴添加")] |
||||
|
PotentialBusPart = 22, |
||||
|
/// <summary>
|
||||
|
/// 通过接受微信账号收到的好友申请添加
|
||||
|
/// </summary>
|
||||
|
[Description("通过接受微信账号收到的好友申请添加")] |
||||
|
WeChatFriendRequest = 24, |
||||
|
/// <summary>
|
||||
|
/// 内部成员共享
|
||||
|
/// </summary>
|
||||
|
[Description("内部成员共享")] |
||||
|
SharedByInternalMembers = 201, |
||||
|
/// <summary>
|
||||
|
/// 管理员/负责人分配
|
||||
|
/// </summary>
|
||||
|
[Description("管理员/负责人分配")] |
||||
|
AllocationByAdmin = 202 |
||||
|
} |
||||
@ -0,0 +1,39 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 外部联系人所打标签
|
||||
|
/// </summary>
|
||||
|
public class FollowUserTag |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 该成员添加此外部联系人所打标签的分组名称
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("group_name")] |
||||
|
[JsonPropertyName("group_name")] |
||||
|
public string? GroupName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员添加此外部联系人所打标签名称
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("tag_name")] |
||||
|
[JsonPropertyName("tag_name")] |
||||
|
public string TagName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员添加此外部联系人所打标签类型
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("type")] |
||||
|
[JsonPropertyName("type")] |
||||
|
public FollowUserTagType Type { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 该成员添加此外部联系人所打企业标签的id，用户自定义类型标签（type=2）不返回
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("tag_id")] |
||||
|
[JsonPropertyName("tag_id")] |
||||
|
public string? TagId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 标签类型
|
||||
|
/// </summary>
|
||||
|
[Description("标签类型")] |
||||
|
public enum FollowUserTagType |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 企业设置
|
||||
|
/// </summary>
|
||||
|
[Description("企业设置")] |
||||
|
EnterpriseSettings = 1, |
||||
|
/// <summary>
|
||||
|
/// 用户自定义
|
||||
|
/// </summary>
|
||||
|
[Description("用户自定义")] |
||||
|
UserCustom = 2, |
||||
|
/// <summary>
|
||||
|
/// 规则组标签
|
||||
|
/// </summary>
|
||||
|
[Description("规则组标签")] |
||||
|
RuleGroupTags = 3, |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 视频号信息
|
||||
|
/// </summary>
|
||||
|
public class FollowUserWechatChannel |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 视频号名称
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("nickname")] |
||||
|
[JsonPropertyName("nickname")] |
||||
|
public string NickName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 视频号添加场景
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("source")] |
||||
|
[JsonPropertyName("source")] |
||||
|
public FollowUserWechatChannelSource Source { get; set; } |
||||
|
} |
||||
@ -0,0 +1,30 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
/// <summary>
|
||||
|
/// 视频号添加场景
|
||||
|
/// </summary>
|
||||
|
[Description("视频号添加场景")] |
||||
|
public enum FollowUserWechatChannelSource |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 未知
|
||||
|
/// </summary>
|
||||
|
[Description("未知")] |
||||
|
None = 0, |
||||
|
/// <summary>
|
||||
|
/// 视频号主页
|
||||
|
/// </summary>
|
||||
|
[Description("视频号主页")] |
||||
|
Home = 1, |
||||
|
/// <summary>
|
||||
|
/// 视频号直播间
|
||||
|
/// </summary>
|
||||
|
[Description("视频号直播间")] |
||||
|
LiveRoom = 2, |
||||
|
/// <summary>
|
||||
|
/// 视频号留资服务
|
||||
|
/// </summary>
|
||||
|
[Description("视频号留资服务")] |
||||
|
RetentionService = 3 |
||||
|
} |
||||
@ -0,0 +1,55 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System; |
||||
|
using System.Collections.Generic; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
/// <summary>
|
||||
|
/// 创建新的规则组请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E5%88%9B%E5%BB%BA%E6%96%B0%E7%9A%84%E8%A7%84%E5%88%99%E7%BB%84" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkBulkGetCustomerRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 企业成员的userid列表，字符串类型，最多支持100个
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("userid_list")] |
||||
|
[JsonPropertyName("userid_list")] |
||||
|
public List<string> UserIds { get; } |
||||
|
/// <summary>
|
||||
|
/// 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("cursor")] |
||||
|
[JsonPropertyName("cursor")] |
||||
|
public string? Cursor { get; } |
||||
|
/// <summary>
|
||||
|
/// 返回的最大记录数，整型，最大值100，默认值50，超过最大值时取最大值
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("limit")] |
||||
|
[JsonPropertyName("limit")] |
||||
|
public int Limit { get; } |
||||
|
public WeChatWorkBulkGetCustomerRequest( |
||||
|
List<string> userIds, |
||||
|
string? cursor = null, |
||||
|
int limit = 50) |
||||
|
{ |
||||
|
Check.NotNullOrEmpty(userIds, nameof(userIds)); |
||||
|
Check.Range(limit, nameof(limit), 1, 100); |
||||
|
|
||||
|
if (userIds.Count > 100) |
||||
|
{ |
||||
|
throw new ArgumentException("The maximum number of userIds allowed in the list is only 100!"); |
||||
|
} |
||||
|
|
||||
|
UserIds = userIds; |
||||
|
Cursor = cursor; |
||||
|
Limit = limit; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,74 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
/// <summary>
|
||||
|
/// 批量获取客户详情请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92994" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkCreateCustomerStrategyRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 父规则组id
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("parent_id")] |
||||
|
[JsonPropertyName("parent_id")] |
||||
|
public int? ParentId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 规则组名称
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy_name")] |
||||
|
[JsonPropertyName("strategy_name")] |
||||
|
public string StrategyName { get; } |
||||
|
/// <summary>
|
||||
|
/// 规则组管理员userid列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("admin_list")] |
||||
|
[JsonPropertyName("admin_list")] |
||||
|
public string[] AdminList { get; } |
||||
|
/// <summary>
|
||||
|
/// 规则组权限
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("privilege")] |
||||
|
[JsonPropertyName("privilege")] |
||||
|
public CustomerStrategyPrivilege Privilege { get; } |
||||
|
/// <summary>
|
||||
|
/// 规则组管理范围
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("range")] |
||||
|
[JsonPropertyName("range")] |
||||
|
public CustomerStrategyRange[] Range { get; } |
||||
|
public WeChatWorkCreateCustomerStrategyRequest( |
||||
|
string strategyName, |
||||
|
string[] adminList, |
||||
|
CustomerStrategyPrivilege? privilege = null, |
||||
|
CustomerStrategyRange[]? range = null) |
||||
|
{ |
||||
|
Check.NotNullOrWhiteSpace(strategyName, nameof(strategyName)); |
||||
|
Check.NotNullOrEmpty(adminList, nameof(adminList)); |
||||
|
|
||||
|
if (adminList.Length > 20) |
||||
|
{ |
||||
|
throw new ArgumentException("Up to 20 admin list can be configured at a time!"); |
||||
|
} |
||||
|
if (range != null && range.Length > 100) |
||||
|
{ |
||||
|
throw new ArgumentException("Up to 100 management range can be configured at a time!"); |
||||
|
} |
||||
|
|
||||
|
StrategyName = strategyName; |
||||
|
AdminList = adminList; |
||||
|
Privilege = privilege ?? CustomerStrategyPrivilege.Default(); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,28 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
/// <summary>
|
||||
|
/// 删除规则组请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E5%88%A0%E9%99%A4%E8%A7%84%E5%88%99%E7%BB%84" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkDeleteCustomerStrategyRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组id
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy_id")] |
||||
|
[JsonPropertyName("strategy_id")] |
||||
|
public int StrategyId { get; } |
||||
|
public WeChatWorkDeleteCustomerStrategyRequest(int strategyId) |
||||
|
{ |
||||
|
Check.NotDefaultOrNull<int>(strategyId, nameof(strategyId)); |
||||
|
|
||||
|
StrategyId = strategyId; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,39 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
/// <summary>
|
||||
|
/// 获取规则组列表请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E5%88%97%E8%A1%A8" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetCustomerStrategyListRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 分页查询游标，首次调用可不填
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("cursor")] |
||||
|
[JsonPropertyName("cursor")] |
||||
|
public string? Cursor { get; } |
||||
|
/// <summary>
|
||||
|
/// 分页大小,默认为1000，最大不超过1000
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("limit")] |
||||
|
[JsonPropertyName("limit")] |
||||
|
public int? Limit { get; } |
||||
|
public WeChatWorkGetCustomerStrategyListRequest(string? cursor = null, int? limit = 1000) |
||||
|
{ |
||||
|
if (limit.HasValue) |
||||
|
{ |
||||
|
Check.Range(limit.Value, nameof(limit), 1, 1000); |
||||
|
} |
||||
|
|
||||
|
Cursor = cursor; |
||||
|
Limit = limit; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,47 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
/// <summary>
|
||||
|
/// 获取规则组管理范围请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetCustomerStrategyRangeRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组id
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy_id")] |
||||
|
[JsonPropertyName("strategy_id")] |
||||
|
public int StrategyId { get; } |
||||
|
/// <summary>
|
||||
|
/// 分页查询游标，首次调用可不填
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("cursor")] |
||||
|
[JsonPropertyName("cursor")] |
||||
|
public string? Cursor { get; } |
||||
|
/// <summary>
|
||||
|
/// 每个分页的成员/部门节点数，默认为1000，最大为1000
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("limit")] |
||||
|
[JsonPropertyName("limit")] |
||||
|
public int? Limit { get; } |
||||
|
public WeChatWorkGetCustomerStrategyRangeRequest(int strategyId, string? cursor = null, int? limit = 1000) |
||||
|
{ |
||||
|
if (limit.HasValue) |
||||
|
{ |
||||
|
Check.Range(limit.Value, nameof(limit), 1, 1000); |
||||
|
} |
||||
|
|
||||
|
StrategyId = strategyId; |
||||
|
Cursor = cursor; |
||||
|
Limit = limit; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
/// <summary>
|
||||
|
/// 获取规则组请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E8%AF%A6%E6%83%85" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetCustomerStrategyRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组id
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy_id")] |
||||
|
[JsonPropertyName("strategy_id")] |
||||
|
public int StrategyId { get; } |
||||
|
public WeChatWorkGetCustomerStrategyRequest(int strategyId) |
||||
|
{ |
||||
|
StrategyId = strategyId; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,86 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Collections.Generic; |
||||
|
using System.ComponentModel.DataAnnotations; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
/// <summary>
|
||||
|
/// 修改客户备注信息请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92115" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkUpdateCustomerRemarkRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 企业成员的userid
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("userid")] |
||||
|
[JsonPropertyName("userid")] |
||||
|
public string UserId { get; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人userid
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("external_userid")] |
||||
|
[JsonPropertyName("external_userid")] |
||||
|
public string ExternalUserId { get; } |
||||
|
/// <summary>
|
||||
|
/// 此用户对外部联系人的备注，最多20个字符
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[StringLength(20)] |
||||
|
[JsonProperty("remark")] |
||||
|
[JsonPropertyName("remark")] |
||||
|
public string? Remark { get; } |
||||
|
/// <summary>
|
||||
|
/// 此用户对外部联系人的描述，最多150个字符
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[StringLength(150)] |
||||
|
[JsonProperty("description")] |
||||
|
[JsonPropertyName("description")] |
||||
|
public string? Description { get; } |
||||
|
/// <summary>
|
||||
|
/// 此用户对外部联系人备注的所属公司名称，最多20个字符
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[StringLength(20)] |
||||
|
[JsonProperty("remark_company")] |
||||
|
[JsonPropertyName("remark_company")] |
||||
|
public string? RemarkCompany { get; } |
||||
|
/// <summary>
|
||||
|
/// 此用户对外部联系人备注的手机号
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("remark_mobiles")] |
||||
|
[JsonPropertyName("remark_mobiles")] |
||||
|
public List<string>? RemarkMobiles { get; } |
||||
|
/// <summary>
|
||||
|
/// 备注图片的mediaid
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("remark_pic_mediaid")] |
||||
|
[JsonPropertyName("remark_pic_mediaid")] |
||||
|
public string? RemarkPictureMediaId { get; } |
||||
|
public WeChatWorkUpdateCustomerRemarkRequest( |
||||
|
string userId, |
||||
|
string externalUserId, |
||||
|
string? remark = null, |
||||
|
string? description = null, |
||||
|
string? remarkCompany = null, |
||||
|
List<string>? remarkMobiles = null, |
||||
|
string? remarkPictureMediaId = null) |
||||
|
{ |
||||
|
UserId = Check.NotNullOrWhiteSpace(userId, nameof(userId)); |
||||
|
ExternalUserId = Check.NotNullOrWhiteSpace(externalUserId, nameof(externalUserId)); |
||||
|
Remark = Check.Length(remark, nameof(remark), 20); |
||||
|
Description = Check.Length(description, nameof(description), 150); |
||||
|
RemarkCompany = Check.Length(remarkCompany, nameof(remarkCompany), 20); |
||||
|
RemarkMobiles = remarkMobiles; |
||||
|
RemarkPictureMediaId = remarkPictureMediaId; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,75 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Collections.Generic; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
/// <summary>
|
||||
|
/// 编辑规则组及其管理范围请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883#%E7%BC%96%E8%BE%91%E8%A7%84%E5%88%99%E7%BB%84%E5%8F%8A%E5%85%B6%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkUpdateCustomerStrategyRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组id
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy_id")] |
||||
|
[JsonPropertyName("strategy_id")] |
||||
|
public int StrategyId { get; } |
||||
|
/// <summary>
|
||||
|
/// 规则组名称
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("strategy_name")] |
||||
|
[JsonPropertyName("strategy_name")] |
||||
|
public string? StrategyName { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 规则组管理员userid列表
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("admin_list")] |
||||
|
[JsonPropertyName("admin_list")] |
||||
|
public string[]? AdminList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 规则组权限
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("privilege")] |
||||
|
[JsonPropertyName("privilege")] |
||||
|
public CustomerStrategyPrivilege? Privilege { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 新增管理范围
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("range_add")] |
||||
|
[JsonPropertyName("range_add")] |
||||
|
public List<CustomerStrategyRange> CreateRange { get; private set; } |
||||
|
/// <summary>
|
||||
|
/// 删除管理范围
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("range_del")] |
||||
|
[JsonPropertyName("range_del")] |
||||
|
public List<CustomerStrategyRange> DeleteRange { get; private set; } |
||||
|
public WeChatWorkUpdateCustomerStrategyRequest( |
||||
|
int strategyId, |
||||
|
string? strategyName = null, |
||||
|
string[]? adminList = null, |
||||
|
CustomerStrategyPrivilege? privilege = null) |
||||
|
{ |
||||
|
Check.NotDefaultOrNull<int>(strategyId, nameof(strategyId)); |
||||
|
|
||||
|
StrategyId = strategyId; |
||||
|
StrategyName = strategyName; |
||||
|
AdminList = adminList; |
||||
|
Privilege = privilege; |
||||
|
|
||||
|
CreateRange = new List<CustomerStrategyRange>(); |
||||
|
DeleteRange = new List<CustomerStrategyRange>(); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,48 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Collections.Generic; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
/// <summary>
|
||||
|
/// 批量获取客户详情响应参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92994" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkBulkGetCustomerResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的userid列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("external_contact_list")] |
||||
|
[JsonPropertyName("external_contact_list")] |
||||
|
public List<ExternalContactList> ExternalUserId { get; set; } = new List<ExternalContactList>(); |
||||
|
/// <summary>
|
||||
|
/// 分页游标，再下次请求时填写以获取之后分页的记录，如果已经没有更多的数据则返回空
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("next_cursor")] |
||||
|
[JsonPropertyName("next_cursor")] |
||||
|
public string? NextCursor { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 若请求中所有userid都无有效互通许可，接口直接报错701008。如果部分userid无有效互通许可，接口返回成功
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("fail_info")] |
||||
|
[JsonPropertyName("fail_info")] |
||||
|
public WeChatWorkBulkGetCustomerFailInfo? FailInfo { get; set; } |
||||
|
} |
||||
|
|
||||
|
public class WeChatWorkBulkGetCustomerFailInfo |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 无许可的userid列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("next_cursor")] |
||||
|
[JsonPropertyName("next_cursor")] |
||||
|
public List<string> UnlicensedUseridList { get; set; } = new List<string>(); |
||||
|
} |
||||
@ -0,0 +1,21 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
/// <summary>
|
||||
|
/// 创建新的规则组响应参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkCreateCustomerStrategyResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组id
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy_id")] |
||||
|
[JsonPropertyName("strategy_id")] |
||||
|
public int StrategyId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,22 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Collections.Generic; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取客户列表响应参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92113" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetCustomerListResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的userid列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("external_userid")] |
||||
|
[JsonPropertyName("external_userid")] |
||||
|
public List<string> ExternalUserId { get; set; } = new List<string>(); |
||||
|
} |
||||
@ -0,0 +1,37 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Collections.Generic; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取客户详情响应参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92114" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetCustomerResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 外部联系人信息
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("external_contact")] |
||||
|
[JsonPropertyName("external_contact")] |
||||
|
public ExternalContactInfo ExternalContact { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 添加了此外部联系人的企业成员
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("follow_user")] |
||||
|
[JsonPropertyName("follow_user")] |
||||
|
public List<FollowUser> FollowUser { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 分页的cursor，当跟进人多于500人时返回
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("next_cursor")] |
||||
|
[JsonPropertyName("next_cursor")] |
||||
|
public string? NextCursor { get; set; } |
||||
|
} |
||||
@ -0,0 +1,29 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取规则组列表响应参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetCustomerStrategyListResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy")] |
||||
|
[JsonPropertyName("strategy")] |
||||
|
public CustomerStrategy[] Strategy { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 分页游标，用于查询下一个分页的数据，无更多数据时不返回
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("next_cursor")] |
||||
|
[JsonPropertyName("next_cursor")] |
||||
|
public string? NextCursor { get; set; } |
||||
|
} |
||||
@ -0,0 +1,30 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取规则组管理范围响应参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetCustomerStrategyRangeResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组管理范围
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("range")] |
||||
|
[JsonPropertyName("range")] |
||||
|
public CustomerStrategyRange[] Range { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 分页游标，用于查询下一个分页的数据，无更多数据时不返回
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("next_cursor")] |
||||
|
[JsonPropertyName("next_cursor")] |
||||
|
public string? NextCursor { get; set; } |
||||
|
} |
||||
@ -0,0 +1,22 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取规则组详情响应参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94883" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetCustomerStrategyResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 规则组详情
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("strategy")] |
||||
|
[JsonPropertyName("strategy")] |
||||
|
public CustomerStrategyInfo Strategy { get; set; } |
||||
|
} |
||||
@ -0,0 +1,93 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Features; |
||||
|
using LINGYUN.Abp.WeChat.Work.Token; |
||||
|
using Microsoft.Extensions.DependencyInjection; |
||||
|
using System.Net.Http; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
using Volo.Abp; |
||||
|
using Volo.Abp.DependencyInjection; |
||||
|
using Volo.Abp.Features; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers; |
||||
|
|
||||
|
[RequiresFeature(WeChatWorkExternalContactFeatureNames.Enable)] |
||||
|
public class WeChatWorkCustomerProvider : IWeChatWorkCustomerProvider, ISingletonDependency |
||||
|
{ |
||||
|
protected IHttpClientFactory HttpClientFactory { get; } |
||||
|
protected IWeChatWorkTokenProvider WeChatWorkTokenProvider { get; } |
||||
|
|
||||
|
public WeChatWorkCustomerProvider( |
||||
|
IHttpClientFactory httpClientFactory, |
||||
|
IWeChatWorkTokenProvider weChatWorkTokenProvider) |
||||
|
{ |
||||
|
HttpClientFactory = httpClientFactory; |
||||
|
WeChatWorkTokenProvider = weChatWorkTokenProvider; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetCustomerListResponse> GetCustomerListAsync( |
||||
|
string userId, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
Check.NotNullOrWhiteSpace(userId, nameof(userId)); |
||||
|
|
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetCustomerListAsync(token.AccessToken, userId, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetCustomerListResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkBulkGetCustomerResponse> BulkGetCustomerAsync( |
||||
|
WeChatWorkBulkGetCustomerRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
Check.NotNull(request, nameof(request)); |
||||
|
|
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.BulkGetCustomerAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkBulkGetCustomerResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetCustomerResponse> GetCustomerAsync( |
||||
|
string externalUserid, |
||||
|
string? cursor = null, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
Check.NotNullOrWhiteSpace(externalUserid, nameof(externalUserid)); |
||||
|
|
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetCustomerAsync(token.AccessToken, externalUserid, cursor, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetCustomerResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkResponse> UpdateCustomerRemarkAsync( |
||||
|
WeChatWorkUpdateCustomerRemarkRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
Check.NotNull(request, nameof(request)); |
||||
|
|
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.UpdateCustomerRemarkAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,111 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Customers.Response; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Features; |
||||
|
using LINGYUN.Abp.WeChat.Work.Token; |
||||
|
using Microsoft.Extensions.DependencyInjection; |
||||
|
using System.Net.Http; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
using Volo.Abp.DependencyInjection; |
||||
|
using Volo.Abp.Features; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Customers; |
||||
|
|
||||
|
[RequiresFeature(WeChatWorkExternalContactFeatureNames.Enable)] |
||||
|
public class WeChatWorkCustomerStrategyProvider : IWeChatWorkCustomerStrategyProvider, ISingletonDependency |
||||
|
{ |
||||
|
protected IHttpClientFactory HttpClientFactory { get; } |
||||
|
protected IWeChatWorkTokenProvider WeChatWorkTokenProvider { get; } |
||||
|
|
||||
|
public WeChatWorkCustomerStrategyProvider( |
||||
|
IHttpClientFactory httpClientFactory, |
||||
|
IWeChatWorkTokenProvider weChatWorkTokenProvider) |
||||
|
{ |
||||
|
HttpClientFactory = httpClientFactory; |
||||
|
WeChatWorkTokenProvider = weChatWorkTokenProvider; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetCustomerStrategyListResponse> GetCustomerStrategyListAsync( |
||||
|
WeChatWorkGetCustomerStrategyListRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetCustomerStrategyListAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetCustomerStrategyListResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetCustomerStrategyResponse> GetCustomerStrategyAsync( |
||||
|
WeChatWorkGetCustomerStrategyRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetCustomerStrategyAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetCustomerStrategyResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetCustomerStrategyRangeResponse> GetCustomerStrategyRangeAsync( |
||||
|
WeChatWorkGetCustomerStrategyRangeRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetCustomerStrategyRangeAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetCustomerStrategyRangeResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkCreateCustomerStrategyResponse> CreateCustomerStrategyAsync( |
||||
|
WeChatWorkCreateCustomerStrategyRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.CreateCustomerStrategyAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkCreateCustomerStrategyResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkResponse> UpdateCustomerStrategyAsync( |
||||
|
WeChatWorkUpdateCustomerStrategyRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.UpdateCustomerStrategyAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkResponse> DeleteCustomerStrategyAsync( |
||||
|
WeChatWorkDeleteCustomerStrategyRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.DeleteCustomerStrategyAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,31 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.Features; |
||||
|
using LINGYUN.Abp.WeChat.Work.Localization; |
||||
|
using Volo.Abp.Features; |
||||
|
using Volo.Abp.Localization; |
||||
|
using Volo.Abp.Validation.StringValues; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Features; |
||||
|
public class WeChatWorkExternalContactFeatureDefinitionProvider : FeatureDefinitionProvider |
||||
|
{ |
||||
|
public override void Define(IFeatureDefinitionContext context) |
||||
|
{ |
||||
|
var weChatFeature = context.GetGroupOrNull(WeChatWorkFeatureNames.GroupName); |
||||
|
if (weChatFeature == null) |
||||
|
{ |
||||
|
return; |
||||
|
} |
||||
|
|
||||
|
var group = weChatFeature.AddFeature(WeChatWorkExternalContactFeatureNames.GroupName); |
||||
|
group.CreateChild( |
||||
|
WeChatWorkExternalContactFeatureNames.Enable, |
||||
|
defaultValue: "false", |
||||
|
displayName: L("Features:ExternalContactEnable"), |
||||
|
description: L("Features:ExternalContactEnableDesc"), |
||||
|
valueType: new ToggleStringValueType(new BooleanValueValidator())); |
||||
|
} |
||||
|
|
||||
|
private static LocalizableString L(string name) |
||||
|
{ |
||||
|
return LocalizableString.Create<WeChatWorkResource>(name); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,14 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.Features; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Features; |
||||
|
/// <summary>
|
||||
|
/// 企业微信客户联系模块功能
|
||||
|
/// </summary>
|
||||
|
public static class WeChatWorkExternalContactFeatureNames |
||||
|
{ |
||||
|
public const string GroupName = WeChatWorkFeatureNames.GroupName + ".ExternalContact"; |
||||
|
/// <summary>
|
||||
|
/// 启用企业微信客户联系
|
||||
|
/// </summary>
|
||||
|
public const string Enable = GroupName + ".Enable"; |
||||
|
} |
||||
@ -0,0 +1,20 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Follows.Response; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Follows; |
||||
|
/// <summary>
|
||||
|
/// 企业服务人员管理接口
|
||||
|
/// </summary>
|
||||
|
public interface IWeChatWorkFollowUserProvider |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 获取配置了客户联系功能的成员列表
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92571" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetFollowUserListResponse> GetFollowUserListAsync(CancellationToken cancellationToken = default); |
||||
|
} |
||||
@ -0,0 +1,22 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Collections.Generic; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Follows.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取配置了客户联系功能的成员列表响应参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/91853" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetFollowUserListResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 配置了客户联系功能的成员userid列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("follow_user")] |
||||
|
[JsonPropertyName("follow_user")] |
||||
|
public List<string> FollowUser { get; set; } = new List<string>(); |
||||
|
} |
||||
@ -0,0 +1,38 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Features; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Follows.Response; |
||||
|
using LINGYUN.Abp.WeChat.Work.Token; |
||||
|
using Microsoft.Extensions.DependencyInjection; |
||||
|
using System.Net.Http; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
using Volo.Abp.DependencyInjection; |
||||
|
using Volo.Abp.Features; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Follows; |
||||
|
|
||||
|
[RequiresFeature(WeChatWorkExternalContactFeatureNames.Enable)] |
||||
|
public class WeChatWorkFollowUserProvider : IWeChatWorkFollowUserProvider, ISingletonDependency |
||||
|
{ |
||||
|
protected IHttpClientFactory HttpClientFactory { get; } |
||||
|
protected IWeChatWorkTokenProvider WeChatWorkTokenProvider { get; } |
||||
|
|
||||
|
public WeChatWorkFollowUserProvider( |
||||
|
IHttpClientFactory httpClientFactory, |
||||
|
IWeChatWorkTokenProvider weChatWorkTokenProvider) |
||||
|
{ |
||||
|
HttpClientFactory = httpClientFactory; |
||||
|
WeChatWorkTokenProvider = weChatWorkTokenProvider; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetFollowUserListResponse> GetFollowUserListAsync(CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetFollowUserListAsync(token.AccessToken, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetFollowUserListResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,48 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Response; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats; |
||||
|
/// <summary>
|
||||
|
/// 客户群管理接口
|
||||
|
/// </summary>
|
||||
|
public interface IWeChatWorkGroupChatProvider |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 获取客户群列表
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92120" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetGroupChatListResponse> GetGroupChatListAsync( |
||||
|
WeChatWorkGetGroupChatListRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 获取客户群详情
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92122" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkGetGroupChatResponse> GetGroupChatAsync( |
||||
|
WeChatWorkGetGroupChatRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
/// <summary>
|
||||
|
/// 客户群opengid转换
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94822" />
|
||||
|
/// </remarks>
|
||||
|
/// <param name="request">请求参数</param>
|
||||
|
/// <param name="cancellationToken"></param>
|
||||
|
/// <returns></returns>
|
||||
|
Task<WeChatWorkOpengIdToChatIdResponse> OpengIdToChatIdAsync( |
||||
|
WeChatWorkOpengIdToChatIdRequest request, |
||||
|
CancellationToken cancellationToken = default); |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群
|
||||
|
/// </summary>
|
||||
|
public class GroupChat |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 客户群ID
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("chat_id")] |
||||
|
[JsonPropertyName("chat_id")] |
||||
|
public string ChatId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 客户群跟进状态
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("status")] |
||||
|
[JsonPropertyName("status")] |
||||
|
public GroupChatStatus Status { get; set; } |
||||
|
} |
||||
@ -0,0 +1,67 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群详情
|
||||
|
/// </summary>
|
||||
|
public class GroupChatInfo |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 客户群ID
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("chat_id")] |
||||
|
[JsonPropertyName("chat_id")] |
||||
|
public string ChatId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 群名
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("name")] |
||||
|
[JsonPropertyName("name")] |
||||
|
public string Name { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 群主ID
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("owner")] |
||||
|
[JsonPropertyName("owner")] |
||||
|
public string Owner { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 群的创建时间
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("create_time")] |
||||
|
[JsonPropertyName("create_time")] |
||||
|
public long CreateTime { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 群公告
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("notice")] |
||||
|
[JsonPropertyName("notice")] |
||||
|
public string Notice { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 群成员列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("member_list")] |
||||
|
[JsonPropertyName("member_list")] |
||||
|
public GroupChatMember[] MemberList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 群管理员列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("admin_list")] |
||||
|
[JsonPropertyName("admin_list")] |
||||
|
public GroupChatManager[] AdminList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 当前群成员版本号。可以配合客户群变更事件减少主动调用本接口的次数
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("member_version")] |
||||
|
[JsonPropertyName("member_version")] |
||||
|
public string MemberVersion { get; set; } |
||||
|
} |
||||
@ -0,0 +1,18 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 邀请者
|
||||
|
/// </summary>
|
||||
|
public class GroupChatInvitor |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 邀请者的userid
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("userid")] |
||||
|
[JsonPropertyName("userid")] |
||||
|
public string UserId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,18 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 群管理员
|
||||
|
/// </summary>
|
||||
|
public class GroupChatManager |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 群管理员userid
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("userid")] |
||||
|
[JsonPropertyName("userid")] |
||||
|
public string UserId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,70 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 群成员
|
||||
|
/// </summary>
|
||||
|
public class GroupChatMember |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 群成员id
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("userid")] |
||||
|
[JsonPropertyName("userid")] |
||||
|
public string UserId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 成员类型
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("type")] |
||||
|
[JsonPropertyName("type")] |
||||
|
public GroupChatMemberType Type { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人在微信开放平台的唯一身份标识（微信unionid），通过此字段企业可将外部联系人与公众号/小程序用户关联起来。<br />
|
||||
|
/// 仅当群成员类型是微信用户（包括企业成员未添加好友），且企业绑定了微信开发者ID有此字段
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("unionid")] |
||||
|
[JsonPropertyName("unionid")] |
||||
|
public string? UnionId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 入群时间
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("join_time")] |
||||
|
[JsonPropertyName("join_time")] |
||||
|
public long JoinTime { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 入群方式
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("join_scene")] |
||||
|
[JsonPropertyName("join_scene")] |
||||
|
public GroupChatMemberJoinScene JoinScene { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 邀请者。目前仅当是由本企业内部成员邀请入群时会返回该值
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("invitor")] |
||||
|
[JsonPropertyName("invitor")] |
||||
|
public GroupChatInvitor? Invitor { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 在群里的昵称
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("group_nickname")] |
||||
|
[JsonPropertyName("group_nickname")] |
||||
|
public string? GroupNickname { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 名字。仅当 need_name = 1 时返回<br />
|
||||
|
/// 如果是微信用户，则返回其在微信中设置的名字<br />
|
||||
|
/// 如果是企业微信联系人，则返回其设置对外展示的别名或实名
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("name")] |
||||
|
[JsonPropertyName("name")] |
||||
|
public string? Name { get; set; } |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 入群方式
|
||||
|
/// </summary>
|
||||
|
[Description("入群方式")] |
||||
|
public enum GroupChatMemberJoinScene |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 由群成员邀请入群（直接邀请入群）
|
||||
|
/// </summary>
|
||||
|
[Description("直接邀请入群")] |
||||
|
DirectInvitation = 1, |
||||
|
/// <summary>
|
||||
|
/// 由群成员邀请入群（通过邀请链接入群）
|
||||
|
/// </summary>
|
||||
|
[Description("通过邀请链接入群")] |
||||
|
InvitationLink = 2, |
||||
|
/// <summary>
|
||||
|
/// 通过扫描群二维码入群
|
||||
|
/// </summary>
|
||||
|
[Description("通过扫描群二维码入群")] |
||||
|
ScanQrCode = 3, |
||||
|
} |
||||
@ -0,0 +1,20 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 成员类型
|
||||
|
/// </summary>
|
||||
|
[Description("成员类型")] |
||||
|
public enum GroupChatMemberType |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 企业成员
|
||||
|
/// </summary>
|
||||
|
[Description("企业成员")] |
||||
|
Internal = 1, |
||||
|
/// <summary>
|
||||
|
/// 外部联系人
|
||||
|
/// </summary>
|
||||
|
[Description("外部联系人")] |
||||
|
External = 2 |
||||
|
} |
||||
@ -0,0 +1,30 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群跟进状态
|
||||
|
/// </summary>
|
||||
|
[Description("客户群跟进状态")] |
||||
|
public enum GroupChatStatus |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 跟进人正常
|
||||
|
/// </summary>
|
||||
|
[Description("跟进人正常")] |
||||
|
Normal = 0, |
||||
|
/// <summary>
|
||||
|
/// 跟进人离职
|
||||
|
/// </summary>
|
||||
|
[Description("跟进人离职")] |
||||
|
Leaves = 1, |
||||
|
/// <summary>
|
||||
|
/// 离职继承中
|
||||
|
/// </summary>
|
||||
|
[Description("离职继承中")] |
||||
|
Resiging = 2, |
||||
|
/// <summary>
|
||||
|
/// 离职继承完成
|
||||
|
/// </summary>
|
||||
|
[Description(" 离职继承完成")] |
||||
|
ResignCompleted = 3, |
||||
|
} |
||||
@ -0,0 +1,31 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 群主过滤
|
||||
|
/// </summary>
|
||||
|
public class OwnerFilter |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 用户ID列表。最多100个
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("userid_list")] |
||||
|
[JsonPropertyName("userid_list")] |
||||
|
public string[] UserIdList { get; } |
||||
|
public OwnerFilter(string[] userIdList) |
||||
|
{ |
||||
|
Check.NotNullOrEmpty(userIdList, nameof(userIdList)); |
||||
|
|
||||
|
if (userIdList.Length > 100) |
||||
|
{ |
||||
|
throw new ArgumentException("The maximum number of parameters allowed for group owner filtering is only 100!"); |
||||
|
} |
||||
|
|
||||
|
UserIdList = userIdList; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,30 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群跟进状态过滤
|
||||
|
/// </summary>
|
||||
|
[Description("客户群跟进状态过滤")] |
||||
|
public enum StatusFilter |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 所有列表
|
||||
|
/// </summary>
|
||||
|
[Description("所有列表")] |
||||
|
All = 0, |
||||
|
/// <summary>
|
||||
|
/// 跟进人离职
|
||||
|
/// </summary>
|
||||
|
[Description("跟进人离职")] |
||||
|
Leaves = 1, |
||||
|
/// <summary>
|
||||
|
/// 离职继承中
|
||||
|
/// </summary>
|
||||
|
[Description("离职继承中")] |
||||
|
Resiging = 2, |
||||
|
/// <summary>
|
||||
|
/// 离职继承完成
|
||||
|
/// </summary>
|
||||
|
[Description(" 离职继承完成")] |
||||
|
ResignCompleted = 3, |
||||
|
} |
||||
@ -0,0 +1,50 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Request; |
||||
|
/// <summary>
|
||||
|
/// 获取客户群列表请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92120" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetGroupChatListRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 客户群跟进状态过滤
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("status_filter")] |
||||
|
[JsonPropertyName("status_filter")] |
||||
|
public StatusFilter? StatusFilter { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 客户群跟进状态过滤
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("owner_filter")] |
||||
|
[JsonPropertyName("owner_filter")] |
||||
|
public OwnerFilter[]? OwnerFilter { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用不填
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("cursor")] |
||||
|
[JsonPropertyName("cursor")] |
||||
|
public string? Cursor { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 分页，预期请求的数据量，取值范围 1 ~ 1000
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("limit")] |
||||
|
[JsonPropertyName("limit")] |
||||
|
public int Limit { get; } |
||||
|
public WeChatWorkGetGroupChatListRequest(int limit = 1000) |
||||
|
{ |
||||
|
Check.Range(limit, nameof(limit), 1, 1000); |
||||
|
|
||||
|
Limit = limit; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,36 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Request; |
||||
|
/// <summary>
|
||||
|
/// 获取客户群详情
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92122" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetGroupChatRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 客户群ID
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("chat_id")] |
||||
|
[JsonPropertyName("chat_id")] |
||||
|
public string ChatId { get; } |
||||
|
/// <summary>
|
||||
|
/// 是否需要返回群成员的名字group_chat.member_list.name。0-不返回；1-返回。默认不返回
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("need_name")] |
||||
|
[JsonPropertyName("need_name")] |
||||
|
public int? NeedName { get; } |
||||
|
public WeChatWorkGetGroupChatRequest(string chatId, bool needName = false) |
||||
|
{ |
||||
|
Check.NotNullOrWhiteSpace(chatId, nameof(chatId)); |
||||
|
|
||||
|
ChatId = chatId; |
||||
|
NeedName = needName ? 1 : 0; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,28 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
using Volo.Abp; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Request; |
||||
|
/// <summary>
|
||||
|
/// 客户群opengid转换请求参数
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94822" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkOpengIdToChatIdRequest : WeChatWorkRequest |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 小程序在微信获取到的群ID
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("opengid")] |
||||
|
[JsonPropertyName("opengid")] |
||||
|
public string OpengId { get; } |
||||
|
public WeChatWorkOpengIdToChatIdRequest(string opengId) |
||||
|
{ |
||||
|
Check.NotNullOrWhiteSpace(opengId, nameof(opengId)); |
||||
|
|
||||
|
OpengId = opengId; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,29 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取客户群列表响应结果
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92120" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetGroupChatListResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 客户群列表
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("group_chat_list")] |
||||
|
[JsonPropertyName("group_chat_list")] |
||||
|
public GroupChat[] GroupChatList { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 分页游标，下次请求时填写以获取之后分页的记录。如果该字段返回空则表示已没有更多数据
|
||||
|
/// </summary>
|
||||
|
[CanBeNull] |
||||
|
[JsonProperty("next_cursor")] |
||||
|
[JsonPropertyName("next_cursor")] |
||||
|
public string? NextCursor { get; set; } |
||||
|
} |
||||
@ -0,0 +1,22 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Models; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Response; |
||||
|
/// <summary>
|
||||
|
/// 获取客户群详情响应结果
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/92122" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkGetGroupChatResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 客户群详情
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("group_chat")] |
||||
|
[JsonPropertyName("group_chat")] |
||||
|
public GroupChatInfo GroupChat { get; set; } |
||||
|
} |
||||
@ -0,0 +1,21 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Response; |
||||
|
/// <summary>
|
||||
|
/// 客户群opengid转换响应结果
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// 详情见: <see href="https://developer.work.weixin.qq.com/document/path/94822" />
|
||||
|
/// </remarks>
|
||||
|
public class WeChatWorkOpengIdToChatIdResponse : WeChatWorkResponse |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 客户群ID，可以用来调用获取客户群详情
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("chat_id")] |
||||
|
[JsonPropertyName("chat_id")] |
||||
|
public string ChatId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,76 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.Features; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Request; |
||||
|
using LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats.Response; |
||||
|
using LINGYUN.Abp.WeChat.Work.Token; |
||||
|
using Microsoft.Extensions.DependencyInjection; |
||||
|
using System.Net.Http; |
||||
|
using System.Threading; |
||||
|
using System.Threading.Tasks; |
||||
|
using Volo.Abp; |
||||
|
using Volo.Abp.DependencyInjection; |
||||
|
using Volo.Abp.Features; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.GroupChats; |
||||
|
|
||||
|
[RequiresFeature(WeChatWorkExternalContactFeatureNames.Enable)] |
||||
|
public class WeChatWorkGroupChatProvider : IWeChatWorkGroupChatProvider, ISingletonDependency |
||||
|
{ |
||||
|
protected IHttpClientFactory HttpClientFactory { get; } |
||||
|
protected IWeChatWorkTokenProvider WeChatWorkTokenProvider { get; } |
||||
|
|
||||
|
public WeChatWorkGroupChatProvider( |
||||
|
IHttpClientFactory httpClientFactory, |
||||
|
IWeChatWorkTokenProvider weChatWorkTokenProvider) |
||||
|
{ |
||||
|
HttpClientFactory = httpClientFactory; |
||||
|
WeChatWorkTokenProvider = weChatWorkTokenProvider; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetGroupChatListResponse> GetGroupChatListAsync( |
||||
|
WeChatWorkGetGroupChatListRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
Check.NotNull(request, nameof(request)); |
||||
|
|
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetGroupChatListAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetGroupChatListResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkGetGroupChatResponse> GetGroupChatAsync( |
||||
|
WeChatWorkGetGroupChatRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
Check.NotNull(request, nameof(request)); |
||||
|
|
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.GetGroupChatAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkGetGroupChatResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
|
||||
|
public async virtual Task<WeChatWorkOpengIdToChatIdResponse> OpengIdToChatIdAsync( |
||||
|
WeChatWorkOpengIdToChatIdRequest request, |
||||
|
CancellationToken cancellationToken = default) |
||||
|
{ |
||||
|
Check.NotNull(request, nameof(request)); |
||||
|
|
||||
|
var token = await WeChatWorkTokenProvider.GetTokenAsync(cancellationToken); |
||||
|
var client = HttpClientFactory.CreateWeChatWorkApiClient(); |
||||
|
|
||||
|
using var response = await client.OpengIdToChatIdAsync(token.AccessToken, request, cancellationToken); |
||||
|
|
||||
|
var wechatResponse = await response.DeserializeObjectAsync<WeChatWorkOpengIdToChatIdResponse>(); |
||||
|
wechatResponse.ThrowIfNotSuccess(); |
||||
|
return wechatResponse; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,7 @@ |
|||||
|
{ |
||||
|
"culture": "en", |
||||
|
"texts": { |
||||
|
"Features:ExternalContactEnable": "Enable External Contact", |
||||
|
"Features:ExternalContactEnableDesc": "Enable the ability to provide the application with an Enterprise wechat customer contact interface." |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,7 @@ |
|||||
|
{ |
||||
|
"culture": "zh-Hans", |
||||
|
"texts": { |
||||
|
"Features:ExternalContactEnable": "启用客户联系", |
||||
|
"Features:ExternalContactEnableDesc": "启用以使应用拥有企业微信客户联系接口的能力." |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群成员退群事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_chat_del_member")] |
||||
|
public class ExternalChaDelMemberEvent : ExternalChatChangeMemberEvent |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 当是成员退群时有值。表示成员的退群方式<br />
|
||||
|
/// 0 - 自己退群<br />
|
||||
|
/// 1 - 群主/群管理员移出<br />
|
||||
|
/// </summary>
|
||||
|
[XmlElement("QuitScene")] |
||||
|
public ExternalChatMemberQuitScene QuitScene { get; set; } |
||||
|
|
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalChaDelMemberEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群成员入群事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_chat_add_member")] |
||||
|
public class ExternalChatAddMemberEvent : ExternalChatChangeMemberEvent |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 当是成员入群时有值。表示成员的入群方式<br />
|
||||
|
/// 0 - 由成员邀请入群（包括直接邀请入群和通过邀请链接入群）<br />
|
||||
|
/// 3 - 通过扫描群二维码入群<br />
|
||||
|
/// </summary>
|
||||
|
[XmlElement("JoinScene")] |
||||
|
public ExternalChatMemberJoinScene JoinScene { get; set; } |
||||
|
|
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalChatAddMemberEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,21 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群变更事件推送
|
||||
|
/// </summary>
|
||||
|
public abstract class ExternalChatChangeEvent : WeChatWorkEventMessage |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 变更类型
|
||||
|
/// </summary>
|
||||
|
[XmlElement("ChangeType")] |
||||
|
public string ChangeType { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 群ID
|
||||
|
/// </summary>
|
||||
|
[XmlElement("ChatId")] |
||||
|
public string ChatId { get; set; } |
||||
|
} |
||||
|
|
||||
@ -0,0 +1,39 @@ |
|||||
|
using System.Collections.Generic; |
||||
|
using System.Xml.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群成员变更事件推送
|
||||
|
/// </summary>
|
||||
|
public abstract class ExternalChatChangeMemberEvent : ExternalChatUpdateEvent |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 成员变更数量
|
||||
|
/// </summary>
|
||||
|
[XmlElement("MemChangeCnt")] |
||||
|
public int MemChangeCnt { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 变更的成员列表
|
||||
|
/// </summary>
|
||||
|
[XmlElement("MemChangeList")] |
||||
|
public List<ExternalChatChangeMember> MemChangeList { get; set; } = new List<ExternalChatChangeMember>(); |
||||
|
/// <summary>
|
||||
|
/// 变更前的群成员版本号
|
||||
|
/// </summary>
|
||||
|
[XmlElement("LastMemVer")] |
||||
|
public string LastMemVer { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 变更后的群成员版本号
|
||||
|
/// </summary>
|
||||
|
[XmlElement("CurMemVer")] |
||||
|
public string CurMemVer { get; set; } |
||||
|
} |
||||
|
|
||||
|
public class ExternalChatChangeMember |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 成员Id
|
||||
|
/// </summary>
|
||||
|
[XmlElement("Item")] |
||||
|
public string UserId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群群名变更事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_chat_change_name")] |
||||
|
public class ExternalChatChangeNameEvent : ExternalChatUpdateEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalChatChangeNameEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群群公告变更事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_chat_change_notice")] |
||||
|
public class ExternalChatChangeNoticeEvent : ExternalChatUpdateEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalChatChangeNoticeEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群群主变更事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_chat_change_owner")] |
||||
|
public class ExternalChatChangeOwnerEvent : ExternalChatUpdateEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalChatChangeOwnerEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群创建事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_chat_create")] |
||||
|
public class ExternalChatCreateEvent : ExternalChatChangeEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalChatCreateEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群解散事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_chat_dismiss")] |
||||
|
public class ExternalChatDismissEvent : ExternalChatChangeEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalChatDismissEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,20 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 成员的入群方式
|
||||
|
/// </summary>
|
||||
|
[Description("成员的入群方式")] |
||||
|
public enum ExternalChatMemberJoinScene |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 由成员邀请入群
|
||||
|
/// </summary>
|
||||
|
[Description("由成员邀请入群")] |
||||
|
MemberInvitation = 0, |
||||
|
/// <summary>
|
||||
|
/// 通过扫描群二维码入群
|
||||
|
/// </summary>
|
||||
|
[Description("通过扫描群二维码入群")] |
||||
|
ScanQrCode = 3 |
||||
|
} |
||||
@ -0,0 +1,20 @@ |
|||||
|
using System.ComponentModel; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 成员的退群方式
|
||||
|
/// </summary>
|
||||
|
[Description("成员的退群方式")] |
||||
|
public enum ExternalChatMemberQuitScene |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 自己退群
|
||||
|
/// </summary>
|
||||
|
[Description("自己退群")] |
||||
|
UserSelf = 0, |
||||
|
/// <summary>
|
||||
|
/// 群主/群管理员移出
|
||||
|
/// </summary>
|
||||
|
[Description("群主/群管理员移出")] |
||||
|
Admin = 1 |
||||
|
} |
||||
@ -0,0 +1,19 @@ |
|||||
|
using System.Xml.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户群变更事件推送
|
||||
|
/// </summary>
|
||||
|
public abstract class ExternalChatUpdateEvent : ExternalChatChangeEvent |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 变更详情。目前有以下几种：<br />
|
||||
|
/// add_member : 成员入群<br />
|
||||
|
/// del_member : 成员退群<br />
|
||||
|
/// change_owner : 群主变更<br />
|
||||
|
/// change_name : 群名变更<br />
|
||||
|
/// change_notice : 群公告变更
|
||||
|
/// </summary>
|
||||
|
[XmlElement("UpdateDetail")] |
||||
|
public string UpdateDetail { get; set; } |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 企业客户变更事件推送
|
||||
|
/// </summary>
|
||||
|
public abstract class ExternalContactChangeEvent : WeChatWorkEventMessage |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 变更类型
|
||||
|
/// </summary>
|
||||
|
[XmlElement("ChangeType")] |
||||
|
public string ChangeType { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 企业服务人员的UserID
|
||||
|
/// </summary>
|
||||
|
[XmlElement("UserID")] |
||||
|
public string UserId { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 外部联系人的userid，注意不是企业成员的账号
|
||||
|
/// </summary>
|
||||
|
[XmlElement("ExternalUserID")] |
||||
|
public string ExternalUserId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,28 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 添加企业客户事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_contact_create")] |
||||
|
public class ExternalContactCreateEvent : ExternalContactChangeEvent |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 添加此用户的「联系我」方式配置的state参数，或在获客链接中指定的customer_channel参数，可用于识别添加此用户的渠道
|
||||
|
/// </summary>
|
||||
|
[XmlElement("State")] |
||||
|
public string State { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 欢迎语code，可用于发送欢迎语
|
||||
|
/// </summary>
|
||||
|
[XmlElement("WelcomeCode")] |
||||
|
public string WelcomeCode { get; set; } |
||||
|
|
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalContactCreateEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,28 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 外部联系人免验证添加成员事件
|
||||
|
/// </summary>
|
||||
|
[EventName("external_contact_create_half")] |
||||
|
public class ExternalContactCreateHalfEvent : ExternalContactChangeEvent |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 添加此用户的「联系我」方式配置的state参数，或在获客链接中指定的customer_channel参数，可用于识别添加此用户的渠道
|
||||
|
/// </summary>
|
||||
|
[XmlElement("State")] |
||||
|
public string State { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 欢迎语code，可用于发送欢迎语
|
||||
|
/// </summary>
|
||||
|
[XmlElement("WelcomeCode")] |
||||
|
public string WelcomeCode { get; set; } |
||||
|
|
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalContactCreateHalfEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,23 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 删除企业客户事件
|
||||
|
/// </summary>
|
||||
|
[EventName("external_contact_delete")] |
||||
|
public class ExternalContactDeleteEvent : ExternalContactChangeEvent |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 删除客户的操作来源，DELETE_BY_TRANSFER表示此客户是因在职继承自动被转接成员删除
|
||||
|
/// </summary>
|
||||
|
[XmlElement("Source")] |
||||
|
public string Source { get; set; } |
||||
|
|
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalContactDeleteEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 删除跟进成员事件
|
||||
|
/// </summary>
|
||||
|
[EventName("external_contact_del_follow_user")] |
||||
|
public class ExternalContactDeleteFollowUserEvent : ExternalContactChangeEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalContactDeleteFollowUserEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,23 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 客户接替失败事件
|
||||
|
/// </summary>
|
||||
|
[EventName("external_contact_transfer_fail")] |
||||
|
public class ExternalContactTransferFailEvent : ExternalContactChangeEvent |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 接替失败的原因, customer_refused-客户拒绝， customer_limit_exceed-接替成员的客户数达到上限
|
||||
|
/// </summary>
|
||||
|
[XmlElement("FailReason")] |
||||
|
public string FailReason { get; set; } |
||||
|
|
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalContactTransferFailEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,17 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 编辑企业客户事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("external_contact_update")] |
||||
|
public class ExternalContactUpdateEvent : ExternalContactChangeEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalContactUpdateEvent>(this); |
||||
|
} |
||||
|
} |
||||
|
|
||||
@ -0,0 +1,20 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using System.Xml.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 企业客户标签变更事件推送
|
||||
|
/// </summary>
|
||||
|
public abstract class ExternalTagChangeEvent : WeChatWorkEventMessage |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 变更类型
|
||||
|
/// </summary>
|
||||
|
[XmlElement("ChangeType")] |
||||
|
public string ChangeType { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 标签或标签组所属的规则组id，只回调给“客户联系”应用
|
||||
|
/// </summary>
|
||||
|
[XmlElement("StrategyId")] |
||||
|
public string StrategyId { get; set; } |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 企业客户标签创建事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("change_external_tag_create")] |
||||
|
public class ExternalTagCreateEvent : ExternalTagChangeEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalTagCreateEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 企业客户标签删除事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("change_external_tag_delete")] |
||||
|
public class ExternalTagDeleteEvent : ExternalTagChangeEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalTagDeleteEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 企业客户标签重排事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("change_external_tag_shuffle")] |
||||
|
public class ExternalTagShuffleEvent : ExternalTagChangeEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalTagShuffleEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,16 @@ |
|||||
|
using LINGYUN.Abp.WeChat.Common.Messages; |
||||
|
using LINGYUN.Abp.WeChat.Work.Common.Messages; |
||||
|
using Volo.Abp.EventBus; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Messages.Models; |
||||
|
/// <summary>
|
||||
|
/// 企业客户标签变更事件推送
|
||||
|
/// </summary>
|
||||
|
[EventName("change_external_tag_update")] |
||||
|
public class ExternalTagUpdateEvent : ExternalTagChangeEvent |
||||
|
{ |
||||
|
public override WeChatMessageEto ToEto() |
||||
|
{ |
||||
|
return new WeChatWorkEventMessageEto<ExternalTagUpdateEvent>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,25 @@ |
|||||
|
using JetBrains.Annotations; |
||||
|
using Newtonsoft.Json; |
||||
|
using System.Text.Json.Serialization; |
||||
|
|
||||
|
namespace LINGYUN.Abp.WeChat.Work.ExternalContact.Models; |
||||
|
/// <summary>
|
||||
|
/// 成员对外属性
|
||||
|
/// </summary>
|
||||
|
public abstract class ExternalAttribute |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// 属性名称： 需要先确保在管理端有创建该属性，否则会忽略
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("name")] |
||||
|
[JsonPropertyName("name")] |
||||
|
public string Name { get; set; } |
||||
|
/// <summary>
|
||||
|
/// 属性类型
|
||||
|
/// </summary>
|
||||
|
[NotNull] |
||||
|
[JsonProperty("type")] |
||||
|
[JsonPropertyName("type")] |
||||
|
public ExternalAttributeType Type { get; set; } |
||||
|
} |
||||
Some files were not shown because too many files changed in this diff
Loading…
Reference in new issue