Mud Tools

Appearance

IFeishuUserV1MailThread - 用户邮件会话API ​

功能描述 ​

飞书邮件会话API接口实现了修改、查询、删除等邮件会话管理功能。支持用户通过用户访问令牌管理自己的邮件会话，调用时 user_mailbox_id 可使用占位符 me 表示当前授权用户的主邮箱。

参考文档 ​

函数列表 ​

函数名称功能描述认证方式HTTP 方法接口文档
BatchTrashUserMailboxThreadAsync批量删除邮件会话UserAccessTokenPOSTBatchTrashUserMailboxThreadAsync
BatchModifyUserMailboxThreadAsync批量修改邮件会话UserAccessTokenPOSTBatchModifyUserMailboxThreadAsync
TrashUserMailboxThreadAsync删除邮件会话UserAccessTokenPOSTTrashUserMailboxThreadAsync
ModifyUserMailboxThreadAsync修改邮件会话UserAccessTokenPOSTModifyUserMailboxThreadAsync
GetUserMailboxThreadAsync获取邮件会话详情UserAccessTokenGETGetUserMailboxThreadAsync
GetUserMailboxThreadPageListAsync分页列出邮件会话UserAccessTokenGETGetUserMailboxThreadPageListAsync

函数详细内容 ​

BatchTrashUserMailboxThreadAsync ​

批量删除邮件会话

函数签名

csharp
Task<FeishuNullDataApiResult?> BatchTrashUserMailboxThreadAsync(
  [Path] string user_mailbox_id,
  [Body] BatchTrashUserMailboxThreadRequest batchTrashUserMailboxThreadRequest,
  CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名类型必填描述示例
user_mailbox_idstring✅用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。me
batchTrashUserMailboxThreadRequestBatchTrashUserMailboxThreadRequest✅批量删除邮件会话请求对象，包含待删除的邮件会话 ID 列表。-
cancellationTokenCancellationToken⚪取消操作令牌对象default

响应

json
{
  "code": 0,
  "msg": "success",
  "data": null
}

说明

  • 批量将指定的邮件会话移入已删除文件夹
  • 请求体 BatchTrashUserMailboxThreadRequest 字段：
字段类型必填描述示例
thread_idsstring[]?⚪邮箱会话 ID 列表，可通过列出邮件会话接口获取。最大长度 20-

代码示例

csharp
var threadApi = feishuApp.GetApi<IFeishuUserV1MailThread>();
var request = new BatchTrashUserMailboxThreadRequest
{
    ThreadIds = new[] { "th_001", "th_002" }
};
var result = await threadApi.BatchTrashUserMailboxThreadAsync("me", request);
Console.WriteLine($"批量删除结果: {result?.Code == 0}");

BatchModifyUserMailboxThreadAsync ​

批量修改邮件会话

函数签名

csharp
Task<FeishuNullDataApiResult?> BatchModifyUserMailboxThreadAsync(
 [Path] string user_mailbox_id,
 [Body] BatchModifyUserMailboxThreadRequest batchModifyUserMailboxThreadRequest,
 CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名类型必填描述示例
user_mailbox_idstring✅用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。me
batchModifyUserMailboxThreadRequestBatchModifyUserMailboxThreadRequest✅批量修改邮件会话请求对象，包含待修改的邮件会话 ID 列表。-
cancellationTokenCancellationToken⚪取消操作令牌对象default

响应

json
{
  "code": 0,
  "msg": "success",
  "data": null
}

说明

  • 批量修改邮件会话的标签、所属文件夹和已读未读状态，支持为邮件会话添加旗标、归档、移入垃圾邮件文件夹
  • 注意：接口不支持将邮件会话移入已删除文件夹，如需请使用批量删除邮件会话接口
  • 请求体 BatchModifyUserMailboxThreadRequest 字段：
字段类型必填描述示例
add_label_idsstring[]?⚪待添加的标签，可选值：UNREAD、IMPORTANT、OTHER、FLAGGED，以及自定义标签 ID。最大长度 20-
remove_label_idsstring[]?⚪待移除的标签，可选值同上。最大长度 20-
add_folderstring?⚪需要移入的文件夹，支持 INBOX、SENT、SPAM、ARCHIVED 以及自定义文件夹 IDINBOX
thread_idsstring[]?⚪需要操作的邮件会话 ID，可通过列出邮件会话获取。最大长度 20-

代码示例

csharp
var threadApi = feishuApp.GetApi<IFeishuUserV1MailThread>();
var request = new BatchModifyUserMailboxThreadRequest
{
    ThreadIds = new[] { "th_001", "th_002" },
    AddLabelIds = new[] { "IMPORTANT" },
    RemoveLabelIds = new[] { "UNREAD" }
};
var result = await threadApi.BatchModifyUserMailboxThreadAsync("me", request);
Console.WriteLine($"批量修改结果: {result?.Code == 0}");

TrashUserMailboxThreadAsync ​

删除邮件会话

函数签名

csharp
Task<FeishuNullDataApiResult?> TrashUserMailboxThreadAsync(
    [Path] string user_mailbox_id,
    [Path] string thread_id,
    CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名类型必填描述示例
user_mailbox_idstring✅用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。me
thread_idstring✅邮件会话 ID。可通过发送邮件、回复邮件的接口返回值或获取邮件详情接口查询获得。th_xxxxxxxxxxxx
cancellationTokenCancellationToken⚪取消操作令牌对象default

响应

json
{
  "code": 0,
  "msg": "success",
  "data": null
}

说明

  • 将指定的邮件会话移入已删除文件夹

代码示例

csharp
var threadApi = feishuApp.GetApi<IFeishuUserV1MailThread>();
var result = await threadApi.TrashUserMailboxThreadAsync("me", "th_xxxxxxxxxxxx");
Console.WriteLine($"删除结果: {result?.Code == 0}");

ModifyUserMailboxThreadAsync ​

修改邮件会话

函数签名

csharp
Task<FeishuNullDataApiResult?> ModifyUserMailboxThreadAsync(
         [Path] string user_mailbox_id,
         [Path] string thread_id,
         [Body] ModifyUserMailboxThreadRequest modifyUserMailboxThreadRequest,
         CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名类型必填描述示例
user_mailbox_idstring✅用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。me
thread_idstring✅邮件会话 ID。可通过发送邮件、回复邮件的接口返回值或获取邮件详情接口查询获得。th_xxxxxxxxxxxx
modifyUserMailboxThreadRequestModifyUserMailboxThreadRequest✅修改邮件会话请求对象，包含待修改的邮件会话信息。-
cancellationTokenCancellationToken⚪取消操作令牌对象default

响应

json
{
  "code": 0,
  "msg": "success",
  "data": null
}

说明

  • 修改邮件会话的标签、所属文件夹和已读未读状态，支持为邮件会话添加旗标、归档、移入垃圾邮件文件夹
  • 注意：接口不支持将邮件会话移入已删除文件夹，如需请使用删除邮件会话接口
  • 请求体 ModifyUserMailboxThreadRequest 字段：
字段类型必填描述示例
add_label_idsstring[]?⚪待添加的标签，可选值：UNREAD、IMPORTANT、OTHER、FLAGGED，以及自定义标签 ID。最大长度 20-
remove_label_idsstring[]?⚪待移除的标签，可选值同上。最大长度 20-
add_folderstring?⚪需要移入的文件夹，支持 INBOX、SENT、SPAM、ARCHIVED 以及自定义文件夹 IDINBOX

代码示例

csharp
var threadApi = feishuApp.GetApi<IFeishuUserV1MailThread>();
var request = new ModifyUserMailboxThreadRequest
{
    AddLabelIds = new[] { "FLAGGED" }
};
var result = await threadApi.ModifyUserMailboxThreadAsync("me", "th_xxxxxxxxxxxx", request);
Console.WriteLine($"修改结果: {result?.Code == 0}");

GetUserMailboxThreadAsync ​

获取邮件会话详情

函数签名

csharp
Task<FeishuApiResult<GetUserMailboxThreadResult>?> GetUserMailboxThreadAsync(
        [Path] string user_mailbox_id,
        [Path] string thread_id,
        [Query] string? format = null,
        [Query] bool? include_spam_trash = null,
        CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名类型必填描述示例
user_mailbox_idstring✅用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。me
thread_idstring✅邮件会话 ID。可通过发送邮件、回复邮件的接口返回值或获取邮件详情接口查询获得。th_xxxxxxxxxxxx
formatstring?⚪需要获取的邮件内容，支持选择 full / plain_text_full / metadata。默认值：nullfull
include_spam_trashbool?⚪是否获取包含来自 SPAM 和 TRASH 的邮件。默认值：nulltrue
cancellationTokenCancellationToken⚪取消操作令牌对象default

响应

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "thread": {
      "id": "th_xxxxxxxxxxxx",
      "body_preview": "hello world",
      "messages": [
        {
          "message_id": "msg_001",
          "subject": "会议纪要"
        }
      ]
    }
  }
}

说明

  • 获取指定邮件会话下的邮件列表，包含邮件元数据及主题、正文等内容
  • 支持获取会话中位于垃圾邮件文件夹和已删除文件夹的邮件
  • format 可选值：
    • full：全文，包括标签、文件夹、主题、收发件人、纯文本、HTML 等信息
    • plain_text_full：全文，只返回纯文本正文内容，不返回 HTML。返回内容包括标签、文件夹、主题、收发件人、纯文本等信息
    • metadata：邮件元数据信息，包括标签、文件夹、主题、收发件人、摘要等信息，不返回正文内容

代码示例

csharp
var threadApi = feishuApp.GetApi<IFeishuUserV1MailThread>();
var result = await threadApi.GetUserMailboxThreadAsync(
    "me",
    "th_xxxxxxxxxxxx",
    format: "metadata",
    include_spam_trash: true);
Console.WriteLine($"会话摘要: {result?.Data?.Thread?.BodyPreview}");

GetUserMailboxThreadPageListAsync ​

分页列出邮件会话

函数签名

csharp
Task<FeishuApiPageListResult<MailThreadInfo>?> GetUserMailboxThreadPageListAsync(
        [Path] string user_mailbox_id,
        [Query] string? folder_id = null,
        [Query] bool? only_unread = null,
        [Query] string? label_id = null,
        [Query] int page_size = Consts.PageSize_20,
        [Query] string? page_token = null,
        CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名类型必填描述示例
user_mailbox_idstring✅用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。me
folder_idstring?⚪文件夹 id，支持 INBOX、SENT、SPAM、ARCHIVED、SCHEDULED、TRASH、DRAFT 以及自定义文件夹 ID。默认值：nullINBOX
only_unreadbool?⚪是否只查询未读会话。默认值：nulltrue
label_idstring?⚪标签 id，支持 IMPORTANT、OTHER、FLAGGED 以及自定义标签 ID。默认值：nullFLAGGED
page_sizeint⚪分页大小，即本次请求所返回的信息列表内的最大条目数。默认值：2020
page_tokenstring?⚪分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果-
cancellationTokenCancellationToken⚪取消操作令牌对象default

响应

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {
        "id": "th_xxxxxxxxxxxx",
        "body_preview": "hello world"
      }
    ],
    "page_token": "uY2gj1RUFhM2vpu1xJf9asLkl2sMkmbudq1",
    "has_more": true
  }
}

说明

  • 分页列出用户指定文件夹或标签下的邮件会话，按时间倒序分页获取

代码示例

csharp
var threadApi = feishuApp.GetApi<IFeishuUserV1MailThread>();
string? pageToken = null;
do
{
    var result = await threadApi.GetUserMailboxThreadPageListAsync(
        "me",
        folder_id: "INBOX",
        page_size: 20,
        page_token: pageToken);
    if (result?.Data?.Items != null)
    {
        foreach (var thread in result.Data.Items)
        {
            Console.WriteLine($"会话 {thread.Id}: {thread.BodyPreview}");
        }
    }
    pageToken = result?.Data?.PageToken;
} while (pageToken is not null);