钉钉通知推送插件

将 emlog 站内关键事件实时推送到钉钉群机器人。

功能特色

• 多机器人支持：可配置多个钉钉机器人，每个事件可选择推送到任意组合
• 12 个站内事件：文章发布/审核、评论发布/审核、用户注册/登录/删除等
• 消息模板自定义：每个事件独立模板，支持变量占位符
• 三种消息类型：纯文本、Markdown、ActionCard
• @提醒：支持 @所有人 或 @指定手机号
• 合并节流：短时间大量评论只推送一次，避免刷屏
• 推送日志：完整记录每次推送状态，方便排查
• 测试推送：后台一键验证机器人配置是否有效

快速开始

1、配置钉钉机器人

• 打开钉钉群→ 群设置
• 找到机器人
• 添加机器人
• 选择「自定义」
• 安全设置建议选择「加签」，记录加签密钥（Secret）
• 创建完成后复制 Webhook 地址
• 进入插件后台「机器人管理」→ 新增机器人 → 填入名称、Webhook、Secret

2、开启事件推送

进入插件后台「事件开关」Tab，启用感兴趣的事件，并勾选要推送的机器人。

3、测试

进入「测试推送」Tab，选择机器人和消息类型，输入测试文本，点击「立即推送」。钉钉群应收到测试消息。

支持的事件

模板变量

每个事件模板支持的变量不同，在「消息模板」Tab 中编辑时会提示可用变量。通用变量包括：

• {date} - 当前时间
• {site_name} - 站点名称
• {site_url} - 站点地址

数据库表

常见问题

Q: 测试推送成功但事件触发时没收到？

A: 检查「事件开关」中对应事件是否已启用，并确认已勾选机器人。

Q: 收到的消息显示 "sign not match" 或类似签名错误？

A: 检查机器人配置中的 Secret 是否与钉钉机器人安全设置中的加签密钥一致。

Q: 删除了一个机器人，之前绑定它的事件会怎样？

A: 删除机器人时，所有事件配置中对该机器人的引用会被自动移除，其他机器人不受影响。