飞书(Lark)
通过飞书开放平台接入,让企业 Bot 在群聊和私聊里与用户交互。
前提条件
- 一个能登录 飞书开放平台、可创建企业自建应用的账号。
- 一个 Memoh Bot;渠道在它的 平台 标签页里配置。
步骤
1. 在飞书开放平台创建自建应用
- 打开 飞书开放平台 并登录。
- 点 创建企业自建应用,填名称与简介后创建。
- 左侧进入 凭证与基础信息。
- 复制 App ID 和 App Secret。
2. 在飞书开放平台启用 Bot 能力
进入 应用能力 → Bot,点启用。
3. 在飞书开放平台开权限
- 进入 应用能力 → 权限管理。
- 至少开启:
im:message(收发消息)im:chat(群信息等)
- 组织有要求时,点 申请权限 提交。
4. 在 Memoh 添加飞书渠道(默认:长连接)
- 打开 Bot 的 平台 标签页,添加 飞书 渠道。
- 入站方式 保持默认的
websocket。 - 填 App ID、App Secret;使用国际版 Lark 时把 区域 切到
lark。 - 点 Save。消息经飞书 WebSocket 长连接 送达,无需公网回调地址,也不用配置事件订阅。
5. 可选:改用 Webhook 入站
服务端可被公网访问、且更希望走事件回调时,再选这种方式。
TIP
这一步会在 Memoh 和飞书后台之间往返:Memoh 生成回调 URL 后要贴回 事件订阅 页,先别关飞书后台。
- 在 Memoh 把 入站方式 改为
webhook;除 App ID、App Secret 外,再填入与飞书后台事件订阅一致的 Encrypt Key 和 Verification Token。 - 点 Save,页面会生成 Webhook 回调 URL,复制它。
- 回到飞书后台,进入 应用配置 → 事件订阅,把 URL 填到 请求地址 并保存。
- 添加 接收消息(
im.message.receive_v1)等事件。
官方说明:飞书自定义机器人
6. 在飞书开放平台发布应用
- 进入 应用发布 → 版本管理与发布。
- 点 创建版本,填写信息并提交审批。
- 审批通过并发布后,Bot 才能在租户里正常使用。
凭据
| 字段 | 说明 |
|---|---|
| App ID | 在飞书开放平台 凭证与基础信息 页获取。 |
| App Secret | 与 App ID 同页获取。 |
| 区域 | 使用国际版 Lark 时切到 lark。 |
| 入站方式 | websocket(默认,长连接)或 webhook。 |
| Encrypt Key | 仅 webhook 模式需要,须与飞书后台事件订阅设置一致。 |
| Verification Token | 仅 webhook 模式需要,须与飞书后台事件订阅设置一致。 |
验证
在飞书里私聊 Bot,发送 /help。Bot 回复命令列表即说明渠道已生效。
群聊
飞书支持群聊。把 Bot 加进群后,@它即可在群里对话。
停用与更换凭据
在 Bot 的 平台 标签页可以随时停用或移除该渠道。更换凭据时,更新对应字段(如 App Secret)并保存即可。
常见问题
渠道配好了,Bot 却没反应
自建应用要先发布:在飞书开放平台 应用发布 → 版本管理与发布 里创建版本并提交审批,审批通过并发布后 Bot 才能在租户里正常使用。
权限要走审批
部分组织对应用权限有审批流程:在 应用能力 → 权限管理 里点 申请权限 提交即可。