访问飞书开放平台(https://open.feishu.cn/app),使用飞书账号登录。
点击“创建企业自建应用”,填写应用名称和描述,选择应用图标。
在应用的“凭证与基础信息”页面,复制:
App ID(格式如cli_xxx)、App Secret
❗重要:请妥善保管 App Secret,不要分享给他人。
在“权限管理”页面,点击“批量导入”按钮,粘贴以下JSON 配置一键导入所需权限:
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access","base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet:read",
"sheets:spreadsheet:create",
"sheets:spreadsheet:write_only",
"docs:document:export",
"docs:document.media:upload",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
}
在 添加应用能力 > 机器人 页面:
开启机器人能力,配置机器人名称。
在“版本管理与发布”页面创建版本,提交审核并发布,等待管理员审批(企业自建应用通常自动通过)。
在“事件订阅”页面:
【注意:应用版本是否发布成功,不成功无法选择“使用长连接接收事件”】
(1)选择“使用长连接接收事件”(WebSocket 模式)。
(2)添加事件:im.message.receive_v1(接收消息)
【注意:如果网关未启动或渠道未添加,长连接设置将保存失败】
在“版本管理与发布”页面创建版本,提交审核并发布,等待管理员审批(企业自建应用通常自动通过)。
通讯录页面飞书搜索,群聊天页面添加群成员,搜索Bot名称即可。