Galosys.Foundation.Mud.Feishu 26.7.31.1

Galosys.Foundation.Mud.Feishu

飞书平台适配器，基于 Mud.Feishu 2.1.5 实现。寄生命名空间 Mud.Feishu。

1. 配置

appsettings.json：

{
  "Feishu": {
    "AppId": "your-feishu-app-id",
    "AppSecret": "your-feishu-app-secret"
  }
}

2. DI 注册

using Mud.Feishu;

services.AddMudFeishu();

3. 获取 Platform

var platform = serviceProvider.GetRequiredService<IImPlatform>();
// platform.Platform => "feishu"

4. 发送消息

var msgId = await platform.Notification.SendAsync(new ImMessage(
    ImTargetType.User,
    "ou_xxx",               // 飞书 open_id
    ImMessageType.Text,
    "审批通知",
    "您有一笔采购单待审批，请及时处理。",
    null));

5. 发送交互卡片

var cardId = await platform.Notification.SendCardAsync("ou_xxx",
    new ApprovalCardData(
        "采购审批单",
        15000m,
        "张三",
        "采购部门急用，请尽快审批",
        new[] { new ImAction("通过", "approve", ActionType.Callback) }
    ));

6. 撤销消息

var success = await platform.Notification.RevokeAsync(msgId);

7. 发起审批

var instanceId = await platform.Approval.StartAsync(new ApprovalRequest(
    BizKey: "PO-2024-001",
    Title: "服务器采购审批",
    Description: "申请采购 3 台 Dell 服务器，用于生产环境扩容",
    Amount: 150000m,
    InitiatorId: "ou_user001",
    ApproverIds: new[] { "ou_approver001", "ou_approver002" },
    FormFields: new[] { new ApprovalFormField("采购类型", "IT设备", true) }
));

8. 查询审批状态

var status = await platform.Approval.QueryStatusAsync(instanceId);
// status => ApprovalStatus.Pending / Approved / Rejected

9. 用户映射

// ERP userId → 飞书 userId
var feishuId = await platform.UserMapping.ToPlatformIdAsync("erp1001", "feishu");

// 飞书 userId → ERP userId
var erpId = await platform.UserMapping.ToErpIdAsync("ou_xxx", "feishu");

10. 回调处理

[HttpPost("callback/feishu")]
public async Task<IActionResult> FeishuCallback(
    [FromServices] IImPlatform platform)
{
    using var reader = new StreamReader(Request.Body);
    var rawBody = await reader.ReadToEndAsync();
    var headers = Request.Headers.ToDictionary(h => h.Key, h => h.Value.ToString());
    await platform.Webhook.HandleAsync<object>("feishu", rawBody, headers);
    return Ok("success");
}

11. 手机号支持

发送消息时 TargetId 传 11 位手机号，自动使用 receive_id_type="phone"，飞书服务端直接解析：

await platform.Notification.SendAsync(new ImMessage(
    ImTargetType.User,
    "13800138000",          // 自动识别为手机号
    ImMessageType.Text,
    "通知", "内容", null));

无需本地翻译或缓存。

12. 告警通道

// 通过 Alarmer 发送告警
// Alarmer 在 FeishuModule 中自动注册，通过 IAlarmerFactory 或 PluginRegistry 触发

配置类

[Options("Feishu")]
public class FeishuOptions
{
    public string AppId { get; set; }
    public string AppSecret { get; set; }
}

依赖