按钮

{
  "tag": "action",
  "actions": [
    {
      "tag": "button",
      "text": {"tag": "plain_text", "content": "确认"},
      "type": "primary",
      "value": {"action": "confirm", "data": "extra_info"}
    }
  ]
}

按钮类型 : default / primary / danger

选择器

{
  "tag": "select_static",
  "placeholder": {"tag": "plain_text", "content": "请选择"},
  "options": [
    {"text": {"tag": "plain_text", "content": "选项1"}, "value": "opt1"},
    {"text": {"tag": "plain_text", "content": "选项2"}, "value": "opt2"}
  ],
  "value": {"key": "select_result"}
}

回调处理

用户点击按钮后，飞书会发送 WebSocket 事件：

{
  "type": "card.action.trigger",
  "action": {
    "value": {"action": "confirm", "data": "extra_info"}
  }
}

处理回调后可更新卡片：

PATCH /open-apis/im/v1/messages/{message_id}

最佳实践

1. 按钮带 value （用于回调识别）
2. 卡片更新代替新消息 （减少刷屏）
3. 危险操作用 danger 类型

每周安装量

43

代码仓库

alextangson/fei…u_skills

GitHub 星标数

51

首次出现

2026年2月20日

安全审计

Gen Agent Trust HubPassSocketPassSnykPass

已安装于

gemini-cli42

amp42

github-copilot42

codex42

kimi-cli42

opencode42