SuperAPI AI 工具集

feishu-lark

办公与效率

查看项目

更新于 10-16 03:05

技能介绍

用途:面向飞书(中国版)与 Lark(国际版)的群聊消息发送技能,可通过自定义机器人 Webhook 或应用机器人 App Bot API 推送文本、富文本(post)和交互卡片(interactive),用于产品公告、营销更新与团队通知等场景。

两种集成模式:自定义机器人 Webhook 只需 FEISHU_WEBHOOK_URL(可选 FEISHU_WEBHOOK_SECRET),可向单个群发送文本、富文本与交互卡片;App Bot API 需 FEISHU_APP_ID 与 FEISHU_APP_SECRET,可向任意会话发送、上传图片、@成员、管理卡片与接收事件。可用命令检查凭据:echo "FEISHU_WEBHOOK_URL is ${FEISHU_WEBHOOK_URL:+set}"。

必要用法:Webhook 地址格式为 https://open.feishu.cn/open-apis/bot/v2/hook/{webhook_id}(飞书)或 https://open.larksuite.com/open-apis/bot/v2/hook/{webhook_id}(Lark);API 基址分别为 https://open.feishu.cn/open-apis 与 https://open.larksuite.com/open-apis。Webhook 消息用 curl POST,msg_type 取 text/post/interactive,文本中可用 <at user_id="all">Everyone</at> @所有人。富文本支持 text、a、at、img、media 标签。交互卡片含 header(title、template 配色如 blue/green/red/turquoise)与 elements(markdown、hr、note、img、action 按钮、column_set 多列布局)。签名校验请求需按 timestamp + "\n" + secret 计算 HMAC-SHA256 并 Base64 编码,JSON 体带 timestamp 与 sign。App Bot API 先用 app_id/app_secret 换取 tenant_access_token(2 小时过期),再调用 /im/v1/messages、/im/v1/chats、/im/v1/images 等接口。

限制:官方文档标题写作 im:message:send_as_bot、im:chat:readonly 权限,其余权限与发布审核要求以官方为准;图片与视频发送依赖 App Bot API 且需先上传获取 image_key/file_key;本资料未提供收费、价格与具体平台版本等信息。