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