diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinKfExtensions.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinKfExtensions.cs index 5991e3a0..80478fe5 100644 --- a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinKfExtensions.cs +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinKfExtensions.cs @@ -310,26 +310,6 @@ namespace SKIT.FlurlHttpClient.Wechat.Work return await client.SendRequestWithJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken); } - - /// - /// 异步调用 [GET] /cgi-bin/kf/get_corp_qualification 接口。 - /// REF: https://developer.work.weixin.qq.com/document/path/95153 - /// - /// - /// - /// - /// - public static async Task ExecuteCgibinKfGetCorpQualificationAsync(this WechatWorkClient client, Models.CgibinKfGetCorpQualificationRequest request, CancellationToken cancellationToken = default) - { - if (client is null) throw new ArgumentNullException(nameof(client)); - if (request is null) throw new ArgumentNullException(nameof(request)); - - IFlurlRequest flurlReq = client - .CreateRequest(request, HttpMethod.Get, "cgi-bin", "kf", "get_corp_qualification") - .SetQueryParam("access_token", request.AccessToken); - - return await client.SendRequestWithJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken); - } #endregion /// @@ -394,5 +374,65 @@ namespace SKIT.FlurlHttpClient.Wechat.Work return await client.SendRequestWithJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken); } + + /// + /// 异步调用 [GET] /cgi-bin/kf/get_corp_qualification 接口。 + /// REF: https://developer.work.weixin.qq.com/document/path/95153 + /// + /// + /// + /// + /// + public static async Task ExecuteCgibinKfGetCorpQualificationAsync(this WechatWorkClient client, Models.CgibinKfGetCorpQualificationRequest request, CancellationToken cancellationToken = default) + { + if (client is null) throw new ArgumentNullException(nameof(client)); + if (request is null) throw new ArgumentNullException(nameof(request)); + + IFlurlRequest flurlReq = client + .CreateRequest(request, HttpMethod.Get, "cgi-bin", "kf", "get_corp_qualification") + .SetQueryParam("access_token", request.AccessToken); + + return await client.SendRequestWithJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken); + } + + /// + /// 异步调用 [POST] /cgi-bin/kf/get_corp_statistic 接口。 + /// REF: https://developer.work.weixin.qq.com/document/path/95489 + /// + /// + /// + /// + /// + public static async Task ExecuteCgibinKfGetCorpStatisticAsync(this WechatWorkClient client, Models.CgibinKfGetCorpStatisticRequest request, CancellationToken cancellationToken = default) + { + if (client is null) throw new ArgumentNullException(nameof(client)); + if (request is null) throw new ArgumentNullException(nameof(request)); + + IFlurlRequest flurlReq = client + .CreateRequest(request, HttpMethod.Post, "cgi-bin", "kf", "get_corp_statistic") + .SetQueryParam("access_token", request.AccessToken); + + return await client.SendRequestWithJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken); + } + + /// + /// 异步调用 [POST] /cgi-bin/kf/get_servicer_statistic 接口。 + /// REF: https://developer.work.weixin.qq.com/document/path/95490 + /// + /// + /// + /// + /// + public static async Task ExecuteCgibinKfGetServicerStatisticAsync(this WechatWorkClient client, Models.CgibinKfGetServicerStatisticRequest request, CancellationToken cancellationToken = default) + { + if (client is null) throw new ArgumentNullException(nameof(client)); + if (request is null) throw new ArgumentNullException(nameof(request)); + + IFlurlRequest flurlReq = client + .CreateRequest(request, HttpMethod.Post, "cgi-bin", "kf", "get_servicer_statistic") + .SetQueryParam("access_token", request.AccessToken); + + return await client.SendRequestWithJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken); + } } } diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetCorpStatisticRequest.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetCorpStatisticRequest.cs new file mode 100644 index 00000000..95c700b1 --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetCorpStatisticRequest.cs @@ -0,0 +1,29 @@ +namespace SKIT.FlurlHttpClient.Wechat.Work.Models +{ + /// + /// 表示 [POST] /cgi-bin/kf/get_corp_statistic 接口的请求。 + /// + public class CgibinKfGetCorpStatisticRequest : WechatWorkRequest + { + /// + /// 获取或设置客服帐号 ID。 + /// + [Newtonsoft.Json.JsonProperty("open_kfid")] + [System.Text.Json.Serialization.JsonPropertyName("open_kfid")] + public string? OpenKfId { get; set; } + + /// + /// 获取或设置起始日期的时间戳。 + /// + [Newtonsoft.Json.JsonProperty("start_time")] + [System.Text.Json.Serialization.JsonPropertyName("start_time")] + public long? StartTimestamp { get; set; } + + /// + /// 获取或设置结束日期的时间戳。 + /// + [Newtonsoft.Json.JsonProperty("end_time")] + [System.Text.Json.Serialization.JsonPropertyName("end_time")] + public long? EndTimestamp { get; set; } + } +} diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetCorpStatisticResponse.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetCorpStatisticResponse.cs new file mode 100644 index 00000000..d6ec10cf --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetCorpStatisticResponse.cs @@ -0,0 +1,90 @@ +namespace SKIT.FlurlHttpClient.Wechat.Work.Models +{ + /// + /// 表示 [POST] /cgi-bin/kf/get_corp_statistic 接口的响应。 + /// + public class CgibinKfGetCorpStatisticResponse : WechatWorkResponse + { + public static class Types + { + public class Statistic + { + public static class Types + { + public class Data + { + /// + /// 获取或设置咨询会话数。 + /// + [Newtonsoft.Json.JsonProperty("session_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("session_cnt")] + public int SessionCount { get; set; } + + /// + /// 获取或设置咨询客户数。 + /// + [Newtonsoft.Json.JsonProperty("customer_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("customer_cnt")] + public int CustomerCount { get; set; } + + /// + /// 获取或设置咨询消息数。 + /// + [Newtonsoft.Json.JsonProperty("customer_msg_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("customer_msg_cnt")] + public int CustomerMessageCount { get; set; } + + /// + /// 获取或设置升级服务客户数。 + /// + [Newtonsoft.Json.JsonProperty("upgrade_service_customer_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("upgrade_service_customer_cnt")] + public int UpgradeServiceCustomerCount { get; set; } + + /// + /// 获取或设置智能回复会话数。 + /// + [Newtonsoft.Json.JsonProperty("ai_session_reply_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("ai_session_reply_cnt")] + public int AISessionReplyCount { get; set; } + + /// + /// 获取或设置智能回复转人工率。 + /// + [Newtonsoft.Json.JsonProperty("ai_transfer_rate")] + [System.Text.Json.Serialization.JsonPropertyName("ai_transfer_rate")] + public double AITransferRate { get; set; } + + /// + /// 获取或设置智能回复知识命中率。 + /// + [Newtonsoft.Json.JsonProperty("ai_knowledge_hit_rate")] + [System.Text.Json.Serialization.JsonPropertyName("ai_knowledge_hit_rate")] + public double AIKnowledgeHitRate { get; set; } + } + } + + /// + /// 获取或设置统计日期时间戳。 + /// + [Newtonsoft.Json.JsonProperty("stat_time")] + [System.Text.Json.Serialization.JsonPropertyName("stat_time")] + public long StatisticsTimestamp { get; set; } + + /// + /// 获取或设置统计数据信息。 + /// + [Newtonsoft.Json.JsonProperty("statistic")] + [System.Text.Json.Serialization.JsonPropertyName("statistic")] + public Types.Data Data { get; set; } = default!; + } + } + + /// + /// 获取或设置统计数据列表。 + /// + [Newtonsoft.Json.JsonProperty("statistic_list")] + [System.Text.Json.Serialization.JsonPropertyName("statistic_list")] + public Types.Statistic[]? StatisticList { get; set; } = default!; + } +} diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetServicerStatisticRequest.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetServicerStatisticRequest.cs new file mode 100644 index 00000000..3a357bfb --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetServicerStatisticRequest.cs @@ -0,0 +1,36 @@ +namespace SKIT.FlurlHttpClient.Wechat.Work.Models +{ + /// + /// 表示 [POST] /cgi-bin/kf/get_servicer_statistic 接口的请求。 + /// + public class CgibinKfGetServicerStatisticRequest : WechatWorkRequest + { + /// + /// 获取或设置客服帐号 ID。 + /// + [Newtonsoft.Json.JsonProperty("open_kfid")] + [System.Text.Json.Serialization.JsonPropertyName("open_kfid")] + public string? OpenKfId { get; set; } + + /// + /// 获取或设置接待人员的 UserId。 + /// + [Newtonsoft.Json.JsonProperty("servicer_userid")] + [System.Text.Json.Serialization.JsonPropertyName("servicer_userid")] + public string? ServicerUserId { get; set; } + + /// + /// 获取或设置起始日期的时间戳。 + /// + [Newtonsoft.Json.JsonProperty("start_time")] + [System.Text.Json.Serialization.JsonPropertyName("start_time")] + public long? StartTimestamp { get; set; } + + /// + /// 获取或设置结束日期的时间戳。 + /// + [Newtonsoft.Json.JsonProperty("end_time")] + [System.Text.Json.Serialization.JsonPropertyName("end_time")] + public long? EndTimestamp { get; set; } + } +} diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetServicerStatisticResponse.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetServicerStatisticResponse.cs new file mode 100644 index 00000000..49798a13 --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinKf/CgibinKfGetServicerStatisticResponse.cs @@ -0,0 +1,146 @@ +namespace SKIT.FlurlHttpClient.Wechat.Work.Models +{ + /// + /// 表示 [POST] /cgi-bin/kf/get_servicer_statistic 接口的响应。 + /// + public class CgibinKfGetServicerStatisticResponse : WechatWorkResponse + { + public static class Types + { + public class Statistic + { + public static class Types + { + public class Data + { + /// + /// 获取或设置咨询会话数。 + /// + [Newtonsoft.Json.JsonProperty("session_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("session_cnt")] + public int SessionCount { get; set; } + + /// + /// 获取或设置咨询客户数。 + /// + [Newtonsoft.Json.JsonProperty("customer_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("customer_cnt")] + public int CustomerCount { get; set; } + + /// + /// 获取或设置咨询消息数。 + /// + [Newtonsoft.Json.JsonProperty("customer_msg_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("customer_msg_cnt")] + public int CustomerMessageCount { get; set; } + + /// + /// 获取或设置人工回复率。 + /// + [Newtonsoft.Json.JsonProperty("reply_rate")] + [System.Text.Json.Serialization.JsonPropertyName("reply_rate")] + public double ReplyRate { get; set; } + + /// + /// 获取或设置平均首次响应时长(单位:秒)。 + /// + [Newtonsoft.Json.JsonProperty("first_reply_average_sec")] + [System.Text.Json.Serialization.JsonPropertyName("first_reply_average_sec")] + public int FirstReplyAverageSeconds { get; set; } + + /// + /// 获取或设置满意度评价发送数。 + /// + [Newtonsoft.Json.JsonProperty("satisfaction_investgate_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("satisfaction_investgate_cnt")] + public int SatisfactionInvestgateCount { get; set; } + + /// + /// 获取或设置满意度参评率。 + /// + [Newtonsoft.Json.JsonProperty("satisfaction_participation_rate")] + [System.Text.Json.Serialization.JsonPropertyName("satisfaction_participation_rate")] + public double SatisfactionParticipationRate { get; set; } + + /// + /// 获取或设置“满意”评价占比。 + /// + [Newtonsoft.Json.JsonProperty("satisfied_rate")] + [System.Text.Json.Serialization.JsonPropertyName("satisfied_rate")] + public double SatisfiedRate { get; set; } + + /// + /// 获取或设置“一般”评价占比。 + /// + [Newtonsoft.Json.JsonProperty("middling_rate")] + [System.Text.Json.Serialization.JsonPropertyName("middling_rate")] + public double MiddlingRate { get; set; } + + /// + /// 获取或设置“不满意”评价占比。 + /// + [Newtonsoft.Json.JsonProperty("dissatisfied_rate")] + [System.Text.Json.Serialization.JsonPropertyName("dissatisfied_rate")] + public double DissatisfiedRate { get; set; } + + /// + /// 获取或设置升级服务客户数。 + /// + [Newtonsoft.Json.JsonProperty("upgrade_service_customer_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("upgrade_service_customer_cnt")] + public int UpgradeServiceCustomerCount { get; set; } + + /// + /// 获取或设置专员服务邀请数。 + /// + [Newtonsoft.Json.JsonProperty("upgrade_service_member_invite_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("upgrade_service_member_invite_cnt")] + public int UpgradeServiceMemberInviteCount { get; set; } + + /// + /// 获取或设置添加专员的客户数。 + /// + [Newtonsoft.Json.JsonProperty("upgrade_service_member_customer_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("upgrade_service_member_customer_cnt")] + public int UpgradeServiceMemberCustomerCount { get; set; } + + /// + /// 获取或设置客户群服务邀请数。 + /// + [Newtonsoft.Json.JsonProperty("upgrade_service_groupchat_invite_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("upgrade_service_groupchat_invite_cnt")] + public int UpgradeServiceGroupChatInviteCount { get; set; } + + /// + /// 获取或设置加入客户群的客户数。 + /// + [Newtonsoft.Json.JsonProperty("upgrade_service_groupchat_customer_cnt")] + [System.Text.Json.Serialization.JsonPropertyName("upgrade_service_groupchat_customer_cnt")] + public int UpgradeServiceGroupChatCustomerCount { get; set; } + } + } + + /// + /// 获取或设置统计日期时间戳。 + /// + [Newtonsoft.Json.JsonProperty("stat_date")] + [System.Text.Json.Serialization.JsonPropertyName("stat_date")] + public long StatisticsTimestamp { get; set; } + + /// + /// 获取或设置统计数据信息。 + /// + [Newtonsoft.Json.JsonProperty("statistic")] + [System.Text.Json.Serialization.JsonPropertyName("statistic")] + public Types.Data Data { get; set; } = default!; + } + } + + /// + /// 获取或设置统计数据列表。 + /// + [Newtonsoft.Json.JsonProperty("statistic_list")] + [System.Text.Json.Serialization.JsonPropertyName("statistic_list")] + public Types.Statistic[]? StatisticList { get; set; } = default!; + } +} diff --git a/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetCorpStatisticRequest.json b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetCorpStatisticRequest.json new file mode 100644 index 00000000..19ba724f --- /dev/null +++ b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetCorpStatisticRequest.json @@ -0,0 +1,5 @@ +{ + "open_kfid": "OPEN_KFID", + "start_time": 1645545600, + "end_time": 1645632000 +} \ No newline at end of file diff --git a/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetCorpStatisticResponse.json b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetCorpStatisticResponse.json new file mode 100644 index 00000000..d84de0d8 --- /dev/null +++ b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetCorpStatisticResponse.json @@ -0,0 +1,30 @@ +{ + "errcode": 0, + "errmsg": "ok", + "statistic_list": [ + { + "stat_time": 1645545600, + "statistic": { + "session_cnt": 2, + "customer_cnt": 1, + "customer_msg_cnt": 6, + "upgrade_service_customer_cnt": 0, + "ai_session_reply_cnt": 1, + "ai_transfer_rate": 1, + "ai_knowledge_hit_rate": 0 + } + }, + { + "stat_time": 1645632000, + "statistic": { + "session_cnt": 2, + "customer_cnt": 1, + "customer_msg_cnt": 6, + "upgrade_service_customer_cnt": 0, + "ai_session_reply_cnt": 1, + "ai_transfer_rate": 1, + "ai_knowledge_hit_rate": 0 + } + } + ] +} diff --git a/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetServicerStatisticRequest.json b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetServicerStatisticRequest.json new file mode 100644 index 00000000..17fc81d4 --- /dev/null +++ b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetServicerStatisticRequest.json @@ -0,0 +1,6 @@ +{ + "open_kfid": "OPEN_KFID", + "servicer_userid": "zhangsan", + "start_time": 1645545600, + "end_time": 1645632000 +} diff --git a/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetServicerStatisticResponse.json b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetServicerStatisticResponse.json new file mode 100644 index 00000000..a00cd45b --- /dev/null +++ b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinKf/CgibinKfGetServicerStatisticResponse.json @@ -0,0 +1,26 @@ +{ + "errcode": 0, + "errmsg": "ok", + "statistic_list": [ + { + "stat_date": 1645545600, + "statistic": { + "session_cnt": 1, + "customer_cnt": 1, + "customer_msg_cnt": 1, + "reply_rate": 1, + "first_reply_average_sec": 17, + "satisfaction_investgate_cnt": 1, + "satisfaction_participation_rate": 1, + "satisfied_rate": 1, + "middling_rate": 0, + "dissatisfied_rate": 0, + "upgrade_service_customer_cnt": 0, + "upgrade_service_member_invite_cnt": 0, + "upgrade_service_member_customer_cnt": 0, + "upgrade_service_groupchat_invite_cnt": 0, + "upgrade_service_groupchat_customer_cnt": 0 + } + } + ] +}