Skip to content

飞书(Lark) ​

通过飞书开放平台接入,让企业 Bot 在群聊和私聊里与用户交互。

前提条件 ​

  • 一个能登录 飞书开放平台、可创建企业自建应用的账号。
  • 一个 Memoh Bot;渠道在它的 平台 标签页里配置。

步骤 ​

1. 在飞书开放平台创建自建应用 ​

  1. 打开 飞书开放平台 并登录。
  2. 点 创建企业自建应用,填名称与简介后创建。
  3. 左侧进入 凭证与基础信息。
  4. 复制 App ID 和 App Secret。

2. 在飞书开放平台启用 Bot 能力 ​

进入 应用能力 → Bot,点启用。

3. 在飞书开放平台开权限 ​

  1. 进入 应用能力 → 权限管理。
  2. 至少开启:
    • im:message(收发消息)
    • im:chat(群信息等)
  3. 组织有要求时,点 申请权限 提交。

4. 在 Memoh 添加飞书渠道(默认:长连接) ​

  1. 打开 Bot 的 平台 标签页,添加 飞书 渠道。
  2. 入站方式 保持默认的 websocket。
  3. 填 App ID、App Secret;使用国际版 Lark 时把 区域 切到 lark。
  4. 点 Save。消息经飞书 WebSocket 长连接 送达,无需公网回调地址,也不用配置事件订阅。

5. 可选:改用 Webhook 入站 ​

服务端可被公网访问、且更希望走事件回调时,再选这种方式。

TIP

这一步会在 Memoh 和飞书后台之间往返:Memoh 生成回调 URL 后要贴回 事件订阅 页,先别关飞书后台。

  1. 在 Memoh 把 入站方式 改为 webhook;除 App ID、App Secret 外,再填入与飞书后台事件订阅一致的 Encrypt Key 和 Verification Token。
  2. 点 Save,页面会生成 Webhook 回调 URL,复制它。
  3. 回到飞书后台,进入 应用配置 → 事件订阅,把 URL 填到 请求地址 并保存。
  4. 添加 接收消息(im.message.receive_v1)等事件。

官方说明:飞书自定义机器人

6. 在飞书开放平台发布应用 ​

  1. 进入 应用发布 → 版本管理与发布。
  2. 点 创建版本,填写信息并提交审批。
  3. 审批通过并发布后,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 才能在租户里正常使用。

权限要走审批 ​

部分组织对应用权限有审批流程:在 应用能力 → 权限管理 里点 申请权限 提交即可。

Published under AGPLv3