通知配置
邮件通知配置
邮件通知通常用于：
- 普通用户收到评论回复
- 管理员收到新的评论
- 管理员收到新的友链申请
- 管理员收到新的反馈投诉
注意：使用邮件通知服务需要开启 SMTP 服务并获取授权码才能发送邮件，请在邮箱设置中完成相关操作。
主机名
邮箱的 SMTP 服务器地址 SMTP 服务器地址，如：smtp.qq.com、smtp.163.com
端口
邮箱的 SMTP 端口（通常 SSL 为 465）
安全性
加密方式，SSL/TLS、STARTTLS、无加密三种可选，默认为 SSL/TLS
用户名
发送邮件的邮箱账号
密码
邮箱 SMTP 授权码（非登录密码）
发信人
收件人看到的发件地址，为空则使用用户名
| 邮箱服务商 | SMTP 服务器 | 端口 |
|---|---|---|
| 163 邮箱 | smtp.163.com | 465 |
| QQ 邮箱 | smtp.qq.com | 465 |
| Gmail | smtp.gmail.com | 587 |
如果你还是不知道如何配置，可以查看更详细的教程： https://blog.talen.top/posts/caffd8d6
飞书通知配置
飞书通知是本项目比较有创意的一个功能，如果你用过 Artalk、Twikoo 等评论系统，或许你看到过飞书通知，这些通常是使用 Webhook 进行推送，只能实现消息的接收。
而本项目则是使用飞书的应用机器人，支持交互式卡片，在飞书收到通知无需打开网站就可以快速完成操作。
功能特点
飞书通知支持以下四种类型的通知，每种通知都带有交互式卡片，可以直接在飞书中完成操作：
| 通知类型 | 交互操作 | 说明 |
|---|---|---|
| 📬 新的评论通知 | 直接回复评论、查看文章、进入管理页面 | 管理员收到新评论时推送 |
| 🔗 新的友链申请 | 一键通过 | 收到友链申请时推送 |
| 📝 新的反馈投诉 | 查看详情处理 | 收到用户反馈投诉时推送 |
| 📰 RSS 订阅日报 | 全部标记已读、查看详情 | 每日推送RSS订阅的文章 |
配置步骤
1. 创建飞书应用
- 打开 飞书开放平台
- 点击「创建企业自建应用」
- 填写应用信息：
- 应用名称：填写你的机器人名称（如
FlecBot） - 应用描述：填写描述信息
- 应用图标：上传机器人头像
- 应用名称：填写你的机器人名称（如
2. 配置应用权限
进入应用详情页，在「权限管理」中开通以下权限：
| 权限名称 | 权限值 | 说明 |
|---|---|---|
| 以应用的身份发消息 | im:message:send_as_bot | 发送消息到群聊 |
| 接收群聊中@机器人消息事件 | im:message.group_at_msg:readonly | 读取群聊中的@消息 |
3. 获取应用凭证
在「凭证与基础信息」页面，获取以下信息：
- App ID：应用唯一标识符（格式：
cli_xxxxxxxxxxxxx） - App Secret：应用密钥（格式：
xxxxxxxxxxxxxxxxxxxx）
4. 获取群聊 ID
在飞书客户端的群聊设置最下方，可以查看到会话 ID，即群聊 ID（格式：oc_xxxxxxxxxxxxx）
5. 飞书通知配置
在博客管理端系统设置页面里，分别填写前两步获取到的三个配置值
| 配置项 | 说明 | 示例 |
|---|---|---|
| App ID | 步骤3中获取的 App ID | cli_xxxxxxxxxxxxx |
| App Secret | 步骤3中获取的 App Secret | xxxxxxxxxxxxxxxxxxxx |
| 群聊 ID | 步骤4中获取的会话 ID | oc_xxxxxxxxxxxxx |
6. 添加事件与回调
在「事件与回调」页面，选择事件配置，编辑订阅方式，选择使用 长连接 接收事件，点击保存
然后添加事件，搜索 im.message.receive_v1 并添加
在「事件与回调」页面，选择回调配置，编辑订阅方式，选择使用 长连接 接收事件，点击保存
然后添加回调，搜索 card.action.trigger 并添加
如果出现 未检测到应用连接信息，请确保长连接建立成功后再保存配置，请做以下排查：
- 检查项目后端服务是否启动
- 仔细检查 App ID 和 App Secret 是否填写正确
7. 启用机器人能力
在「添加应用能力」页面，选择添加机器人
8. 发布应用
在「版本管理与发布」页面，创建版本：
- 应用版本号：格式为
x.y.z，一般从1.0.0开始 - 更新说明：自定义填写
9. 添加机器人到群聊
- 进入前面获取群聊 ID 时选择的群聊
- 在群聊设置中能够找到 「群机器人」
- 点击「添加机器人」，搜索你创建的应用名称（如
FlecBot）
10. 用户关联
由于网站可以存在多个管理员，而加入群聊的管理员均可以进行卡片操作，这就导致操作身份不明确
比如一条新评论卡片，如果任意管理员进行回复，无法得知回复者身份
所以我们就需要通过绑定，让飞书用户和博客系统用户进行关联
在包含机器人的群聊中，通过 @机器人 /bind 邮箱 命令，进行用户关联
邮箱是博客系统登录的用户邮箱，如果绑定错了可以通过再次执行命令进行绑定
常用命令
须在命令前 @机器人
/bind 邮箱- 绑定飞书账号/stats- 查看站点仪表盘统计/system- 查看系统状态/help- 显示帮助信息
常见问题
Q: 普通用户可以使用飞书吗？
A: 不可以。飞书通知仅包含管理员消息，无评论回复通知这一类型。
Q: 飞书通知是实时的吗？
A: 是的。新评论、友链申请、反馈投诉会在事件发生后的几秒内推送到飞书群聊。RSS订阅日报则是每日定时推送。
Q: 绑定邮箱不需要验证身份吗？
A: 不需要。机器人不支持单聊，所有命令都必须在群内完成，聊天记录有完美的可追溯性，并且群成员均为管理员，可控性较强。
Q: 飞书通知和邮件通知可以同时使用吗？
A: 可以。飞书通知和邮件通知是独立配置的，你可以同时启用两者，或者只启用其中一种。
Q: 如何修改机器人的名称和头像？
A: 进入飞书开放平台，在应用的综合信息和国际化配置中可以进行修改，修改后需要重新发布应用。