飞书消息与群管理 Skill。发送消息、建群、置顶、加急、撤回、群菜单/Tab/公告等 25+ 项 IM 能力。当需要通过飞书发送消息、管理群聊、操作群成员或配置群功能时使用此 Skill。
你是飞书 IM 自动化专家,负责通过 API 实现消息发送、群聊管理和群功能配置。
| 项目 | 值 |
|---|---|
| Base URL | https://open.feishu.cn/open-apis/im/v1 |
| 认证方式 |
POST /open-apis/im/v1/messages?receiveidtype=open_id
json
{
receiveid: ouxxx,
msg_type: text,
content: {\text\:\Hello\}
}
实测心法:content 必须是字符串化的 JSON,不能直接传对象。
receiveidtype 可选值:openid / userid / unionid / email / chatid
POST /open-apis/im/v1/messages?receiveidtype=open_id
json
{
receiveid:
msg_type: interactive,
content:
}
实测心法:
卡片结构:
json
{
config: { widescreenmode: true },
header: {
title: { tag: plain_text, content: 卡片标题 },
template: blue
},
elements: [
{ tag: div, text: { tag: lark_md, content: 加粗 和 代码 支持 } },
{ tag: hr },
{ tag: action, actions: [
{ tag: button, text: { tag: plain_text, content: 确认 }, type: primary, value: { action: confirm } }
]}
]
}
Header 颜色模板:
| template | 颜色 | 适用场景 |
|---|---|---|
| blue | 蓝色 | 日常通知、信息 |
| green |
larkmd 语法:加粗、斜体、~~删除线~~、链接、
POST /open-apis/im/v1/pins
json
{ messageid: omxxx }
实测心法:必须使用 /pins 集合端点,不能使用 messages/:id/pin 路径。
POST /open-apis/im/v1/messages/:message_id/reactions
json
{ reactiontype: { emojitype: OK } }
实测心法:emoji_type 必须使用大写标准 ID(如 OK、THUMBSUP、HEART)。
DELETE /open-apis/im/v1/messages/:message_id
实测心法:仅能撤回机器人自己在有效期内发送的消息。
PATCH /open-apis/im/v1/messages/:messageid/urgentapp
json
{ useridlist: [ou_xxx] }
实测心法:消耗加急额度,请谨慎调用,仅用于 P0 级事件。
POST /open-apis/im/v1/chats/:chatid/topnotice
json
{ actiontype: message, messageid: om_xxx }
实测心法:置顶条目有限,建议仅置顶核心卡片。
POST /open-apis/im/v1/messages/batch_send
实测心法:注意限频策略,单次建议控制在 200 个群。
POST /open-apis/im/v1/messages/send_sys
实测心法:视觉干扰度低,适合非业务强提醒(如入群须知)。
POST /open-apis/im/v1/chats
json
{ name: 群名称, userids: [ouxxx] }
实测心法 (重要):
GET /open-apis/im/v1/chats/:chat_id/members
实测心法:分页拉取大群成员时注意 Token 翻页。
POST /open-apis/im/v1/chats/:chatid/members?memberidtype=openid
json
{ idlist: [ouxxx] }
实测心法:被拉取人必须在机器人可见范围内。这是确保群聊对用户可见的最稳健方式。
PATCH /open-apis/im/v1/chats/:chat_id/announcement
json
{ content: 最新进度... }
实测心法:内容支持富文本格式。
GET /open-apis/im/v1/chats/:chat_id/announcement
实测心法:解析内容后可结合 LLM 生成执行周报。
POST /open-apis/im/v1/chats/:chatid/menutree
实测心法:在群聊右上角添加自定义菜单(如项目概览、一键周报),极大增强群聊的功能入口属性。
POST /open-apis/im/v1/chats/:chat_id/tabs
实测心法:群内集成多维表格看板、Wiki SOP 为独立 Tab,让群聊变身为项目工作台。
POST /open-apis/im/v1/chats/:chat_id/widgets
实测心法:在群聊右侧挂载动态汇率表、实时监控大屏,将群聊 UI 能力扩展到极限。
POST /open-apis/im/v1/chats/:chatid/collabplugins
实测心法:在对话框上方常驻项目文档入口,减少翻找时间。
POST /open-apis/im/v1/url_preview
实测心法:机器人发送的项目链接,自动附带最新的进度摘要,增强信息传达的视觉丰富度。
POST /open-apis/im/v1/feed_cards
实测心法:在飞书左侧导航栏推送即时状态,比消息更轻量,适合展示当前正在运行的任务。
POST /open-apis/im/v1/tags
实测心法:为群聊或成员打上业务标签(如核心项目、高优先级),便于后续分类筛选。
权限:im:datasync.feedcard.timesensitive:write
实测心法:将外部 CRM 或代码仓库动态实时推送到飞书 Feed,对时间敏感型信息(如紧急 Bug)效果极佳。
权限:im:chat.accessevent.botp2p_chat:read
实测心法:确保机器人能主动给特定
该技能支持在以下平台通过对话安装:
帮我安装 SkillHub 和 feishu-im-1776420033 技能
设置 SkillHub 为我的优先技能安装源,然后帮我安装 feishu-im-1776420033 技能
skillhub install feishu-im-1776420033
文件大小: 4.18 KB | 发布时间: 2026-4-17 18:24