Bitzsoft.Integrations.EnterpriseMail.Tencent 1.0.0-alpha.9

This is a prerelease version of Bitzsoft.Integrations.EnterpriseMail.Tencent.

dotnet add package Bitzsoft.Integrations.EnterpriseMail.Tencent --version 1.0.0-alpha.9

NuGet\Install-Package Bitzsoft.Integrations.EnterpriseMail.Tencent -Version 1.0.0-alpha.9

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Bitzsoft.Integrations.EnterpriseMail.Tencent" Version="1.0.0-alpha.9" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Bitzsoft.Integrations.EnterpriseMail.Tencent" Version="1.0.0-alpha.9" />
                    

                            Directory.Packages.props

<PackageReference Include="Bitzsoft.Integrations.EnterpriseMail.Tencent" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Bitzsoft.Integrations.EnterpriseMail.Tencent --version 1.0.0-alpha.9

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Bitzsoft.Integrations.EnterpriseMail.Tencent, 1.0.0-alpha.9"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Bitzsoft.Integrations.EnterpriseMail.Tencent@1.0.0-alpha.9

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Bitzsoft.Integrations.EnterpriseMail.Tencent&version=1.0.0-alpha.9&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=Bitzsoft.Integrations.EnterpriseMail.Tencent&version=1.0.0-alpha.9&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Bitzsoft.Integrations.EnterpriseMail.Tencent

腾讯企业邮箱集成，基于企业微信（WeCom）邮件 API 实现 IEnterpriseMailProvider。

功能特性

企业微信邮件 API，通过 Corp ID / Secret 访问邮箱
邮件发送，支持完整发送功能
邮件列表，按时间范围获取邮件列表
邮件详情，读取 EML 格式邮件内容

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.EnterpriseMail.Tencent

PackageReference

<PackageReference Include="Bitzsoft.Integrations.EnterpriseMail.Tencent" Version="1.0.0" />

配置

{
  "Tencent": {
    "CorpId": "wwxxxxxxxxxxxxxxxx",
    "CorpSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

配置项	说明	默认值
`CorpId`	企业微信企业 ID	—
`CorpSecret`	企业微信应用密钥	—
`BaseUrl`	API 基地址	`https://qyapi.weixin.qq.com/cgi-bin`
`HttpClientName`	命名 HttpClient	`TencentMail`

注册服务

// 方式一：委托配置
services.AddBitzsoftTencentMail(options =>
{
    options.CorpId = "wwxxxxxxxxxxxxxxxx";
    options.CorpSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
});

// 方式二：IConfiguration 绑定
services.AddBitzsoftTencentMail(configuration, "Tencent");

第三方请求日志

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认 NullRequestLogStore 不持久化。

// ① 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftTencentMail(options => { /* ... */ });

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxBodyLength = 8192;
    opts.SensitiveFields.Add("mySecret");
});
services.AddBitzsoftTencentMail(options => { /* ... */ });

使用示例

using Bitzsoft.Integrations.EnterpriseMail;
using Bitzsoft.Integrations.EnterpriseMail.Tencent;
using Bitzsoft.Integrations.EnterpriseMail.Models;

// 通过 DI 注入 IEnterpriseMailProvider
public class MailService
{
    private readonly IEnterpriseMailProvider _mail;

    public MailService(IEnterpriseMailProvider mail) => _mail = mail;

    public async Task SendAsync()
    {
        await _mail.SendAsync(new SendMailRequest
        {
            Subject = "通知",
            HtmlBody = "<p>测试邮件</p>",
            To = [new MailAddress { Address = "user@example.com" }],
        });
    }
}

核心类型一览

类型	说明
`TencentMailProvider`	腾讯邮箱服务实现（`IEnterpriseMailProvider`，部分方法 NotSupportedException）
`TencentMailOptions`	腾讯邮箱配置选项

依赖

Bitzsoft.Integrations.EnterpriseMail，企业邮箱抽象层
Bitzsoft.Integrations.Compatibility，基础工具库
Microsoft.Extensions.Http，命名 HttpClient 工厂

API 限制

企业微信邮件 API 能力有限，以下操作不支持（抛出 NotSupportedException）：

方法	说明
`DeleteMessageAsync`	删除邮件
`MoveMessageAsync`	移动邮件
`ListFoldersAsync`	文件夹列表
`CreateFolderAsync`	创建文件夹
`DeleteFolderAsync`	删除文件夹
`ListAttachmentsAsync`	附件列表
`DownloadAttachmentAsync`	下载附件

ListMessagesAsync 默认按最近 30 天时间范围获取
Provider 名称：Tencent

Product	Compatible and additional computed target framework versions.
.NET	net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Bitzsoft.Integrations.EnterpriseMail.Tencent:

Package	Downloads
Bitzsoft.Integrations.EnterpriseMail.All 企业邮箱服务聚合包 — 包含所有供应商实现	358

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.0-alpha.9	58	7/12/2026
1.0.0-alpha.8	56	7/1/2026
1.0.0-alpha.7	72	6/16/2026
1.0.0-alpha.6	65	6/16/2026
1.0.0-alpha.5	59	6/14/2026
1.0.0-alpha.3	66	6/7/2026