PHPackages                             jiushutech/flarum-dingtalk-webhook - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. jiushutech/flarum-dingtalk-webhook

ActiveFlarum-extension[Mail & Notifications](/categories/mail)

jiushutech/flarum-dingtalk-webhook
==================================

Flarum 钉钉机器人 Webhook 集成插件

1.0.0(3mo ago)01MITPHP

Since Feb 1Pushed 3mo agoCompare

[ Source](https://github.com/jiushutech/flarum-dingtalk-webhook)[ Packagist](https://packagist.org/packages/jiushutech/flarum-dingtalk-webhook)[ RSS](/packages/jiushutech-flarum-dingtalk-webhook/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (2)Used By (0)

Flarum DingTalk Webhook Plugin
==============================

[](#flarum-dingtalk-webhook-plugin)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![Version](https://camo.githubusercontent.com/97f85f046265623c4b26076add9bcc55f9608152c20e78f07076369977c77d05/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e302d677265656e2e737667)](https://github.com/jiushutech/flarum-dingtalk-webhook)[![Flarum](https://camo.githubusercontent.com/e3c0ccef8b07e80054a74e5565a4551f05bd362b39a1a8c5c263f6f27dd01592/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666c6172756d2d253545312e372e302d6f72616e67652e737667)](https://flarum.org)

[English](#english) | [中文](#%E4%B8%AD%E6%96%87)

---

English
-------

[](#english)

Push Flarum forum events to DingTalk group robots for real-time community notifications.

### Features

[](#features)

- 🔔 **Multiple Events**: Support for discussions, posts, users, and groups events
- 📝 **Markdown Format**: Messages are formatted in DingTalk Markdown for clear presentation
- 🔐 **Signature Security**: Support for DingTalk robot signature verification
- 🏷️ **Tag Filtering**: Limit webhooks to trigger only for specific tags
- 👥 **Group Permissions**: Configure to push only content visible to specific user groups
- 🎨 **Card-style Management**: Intuitive card-based admin interface
- ✏️ **Custom Templates**: Support custom message templates for flexible formatting
- 🌐 **Bilingual Support**: Full English and Chinese interface

### Installation

[](#installation)

Install via Composer:

```
composer require jiushutech/flarum-dingtalk-webhook
```

### DingTalk Robot Configuration

[](#dingtalk-robot-configuration)

#### Step 1: Create DingTalk Group Robot

[](#step-1-create-dingtalk-group-robot)

1. Open DingTalk and enter the group chat where you want to receive notifications
2. Click Group Settings (top right `...`) → **Smart Group Assistant** → **Add Robot**
3. Select **Custom** robot
4. Set robot name (e.g., Forum Notifications) and avatar

#### Step 2: Configure Security Settings

[](#step-2-configure-security-settings)

DingTalk robots support three security settings. **Signature mode is recommended**:

##### Option 1: Signature (Recommended) ✅

[](#option-1-signature-recommended-)

1. Check **Signature** in security settings
2. System will generate a key starting with `SEC`, e.g., `SECxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
3. **Copy and save this key** for later configuration in Flarum admin

##### Option 2: Custom Keywords

[](#option-2-custom-keywords)

1. Check **Custom Keywords**
2. Set keywords (e.g., `forum`, `notification`)
3. Messages must contain at least one keyword to be sent successfully

##### Option 3: IP Address (Range)

[](#option-3-ip-address-range)

1. Check **IP Address (Range)**
2. Enter your server's public IP address
3. Only requests from specified IPs will be accepted

#### Step 3: Get Webhook URL

[](#step-3-get-webhook-url)

1. After completing security settings, click **Finish**
2. System will display the Webhook URL in this format: ```
    https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    ```
3. **Copy and save this URL**

#### Step 4: Configure in Flarum Admin

[](#step-4-configure-in-flarum-admin)

1. Log in to Flarum admin panel
2. Find **DingTalk Webhook** extension in the left menu
3. Click **Add Webhook** button
4. Fill in configuration:

SettingDescription**Name**Display name for the webhook**Webhook URL**Paste the Webhook URL from DingTalk**Signature Key**If using signature security, enter the `SEC` key**Events**Select event types to trigger notifications**Tag Filter**Optional, limit to specific tags**Group Filter**Optional, limit to content visible to specific groups5. Click **Save** to complete configuration
6. Click **Test Send** to verify configuration

### Supported Events

[](#supported-events)

CategoryEventDescription**Discussion**discussion.startedNew discussion createddiscussion.renamedDiscussion renameddiscussion.hiddenDiscussion hiddendiscussion.restoredDiscussion restoreddiscussion.deletedDiscussion deleted**Post**post.postedNew reply postedpost.revisedReply editedpost.hiddenReply hiddenpost.restoredReply restoredpost.deletedReply deletedpost.approvedReply approved (requires flarum/approval)**User**user.registeredUser registereduser.renamedUser renameduser.deletedUser deleted**Group**group.createdGroup createdgroup.renamedGroup renamedgroup.deletedGroup deleted### Custom Message Templates

[](#custom-message-templates)

#### Available Variables

[](#available-variables)

VariableDescriptionExample`{title}`Message title`【New Post】Tech Discussion``{url}`Resource URL`https://forum.example.com/d/123``{description}`Content description`This is the post content...``{author}`Author name`John``{author_url}`Author profile URL`https://forum.example.com/u/john``{timestamp}`Event time`2026-02-01 20:00:00``{extra_text}`Additional text`Notification from Tech Forum``{tags}`Related tags`Tech, Discussion, Announcement``{event_type}`Event type`discussion.started`#### Template Examples

[](#template-examples)

**Simple Notification Template**

```
### {title}

**Author**: [{author}]({author_url})
**Time**: {timestamp}

{description}

[👉 View Details]({url})
```

**Minimal Template**

```
**{title}**

{description}

[View Details]({url}) | {author} | {timestamp}
```

### Development

[](#development)

#### Frontend Build

[](#frontend-build)

```
cd js
npm install
npm run dev    # Development mode
npm run build  # Production build
```

### License

[](#license)

MIT License

### Author

[](#author)

[JiushuTech](https://github.com/jiushutech)

### Links

[](#links)

- [GitHub Repository](https://github.com/jiushutech/flarum-dingtalk-webhook)
- [Issue Tracker](https://github.com/jiushutech/flarum-dingtalk-webhook/issues)

---

中文
--

[](#中文)

将 Flarum 论坛事件推送到钉钉群机器人，实现社区动态的实时通知。

### 功能特性

[](#功能特性)

- 🔔 **多事件支持**：支持主题、回复、用户、用户组等多种事件类型
- 📝 **Markdown 格式**：推送消息采用钉钉 Markdown 格式，排版清晰
- 🔐 **加签安全**：支持钉钉机器人加签安全验证
- 🏷️ **标签过滤**：可限制 Webhook 只在特定标签下触发
- 👥 **组群权限**：可配置只推送特定组群可见的内容
- 🎨 **卡片式管理**：后台采用卡片式界面，配置直观便捷
- ✏️ **自定义模板**：支持自定义消息模板，灵活控制推送格式
- 🌐 **双语支持**：完整的中英文界面

### 安装

[](#安装)

使用 Composer 安装：

```
composer require jiushutech/flarum-dingtalk-webhook
```

### 钉钉机器人配置

[](#钉钉机器人配置)

#### 第一步：创建钉钉群机器人

[](#第一步创建钉钉群机器人)

1. 打开钉钉，进入需要接收通知的群聊
2. 点击群设置（右上角 `...`）→ **智能群助手** → **添加机器人**
3. 选择 **自定义** 机器人
4. 设置机器人名称（如：论坛通知）和头像

#### 第二步：配置安全设置

[](#第二步配置安全设置)

钉钉机器人支持三种安全设置方式，**推荐使用"加签"方式**：

##### 方式一：加签（推荐）✅

[](#方式一加签推荐)

1. 在安全设置中勾选 **加签**
2. 系统会生成一个以 `SEC` 开头的密钥，如：`SECxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
3. **复制并保存此密钥**，稍后需要在 Flarum 后台配置

##### 方式二：自定义关键词

[](#方式二自定义关键词)

1. 勾选 **自定义关键词**
2. 设置关键词（如：`论坛`、`通知`）
3. 发送的消息必须包含至少一个关键词才能发送成功

##### 方式三：IP 地址（段）

[](#方式三ip-地址段)

1. 勾选 **IP 地址（段）**
2. 填写服务器的公网 IP 地址
3. 只有来自指定 IP 的请求才会被接受

#### 第三步：获取 Webhook 地址

[](#第三步获取-webhook-地址)

1. 完成安全设置后，点击 **完成**
2. 系统会显示 Webhook 地址，格式如下： ```
    https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    ```
3. **复制并保存此地址**

#### 第四步：在 Flarum 后台配置

[](#第四步在-flarum-后台配置)

1. 登录 Flarum 管理后台
2. 在左侧菜单找到 **钉钉 Webhook** 扩展
3. 点击 **添加 Webhook** 按钮
4. 填写配置信息：

配置项说明**名称**Webhook 的显示名称，便于识别**Webhook 地址**粘贴从钉钉获取的 Webhook URL**加签密钥**如果使用加签安全设置，填写 `SEC` 开头的密钥**事件**选择要触发推送的事件类型**标签过滤**可选，限制只在特定标签下触发**用户组过滤**可选，限制只推送特定用户组可见的内容5. 点击 **保存** 完成配置
6. 可点击 **测试发送** 验证配置是否正确

### 支持的事件

[](#支持的事件)

分类事件说明**主题**discussion.started新帖发布discussion.renamed主题重命名discussion.hidden主题隐藏discussion.restored主题恢复discussion.deleted主题删除**回复**post.posted新回复post.revised回复编辑post.hidden回复隐藏post.restored回复恢复post.deleted回复删除post.approved回复审核通过（需安装 flarum/approval）**用户**user.registered用户注册user.renamed用户改名user.deleted用户删除**用户组**group.created用户组创建group.renamed用户组重命名group.deleted用户组删除### 自定义消息模板

[](#自定义消息模板)

#### 可用变量

[](#可用变量)

变量说明示例值`{title}`消息标题`【新帖发布】技术讨论区``{url}`资源链接`https://forum.example.com/d/123``{description}`内容描述`这是帖子的正文内容...``{author}`操作人名称`张三``{author_url}`操作人主页`https://forum.example.com/u/zhangsan``{timestamp}`事件时间`2026-02-01 20:00:00``{extra_text}`附加文本`来自技术论坛的通知``{tags}`相关标签`技术, 讨论, 公告``{event_type}`事件类型`discussion.started`#### 模板示例

[](#模板示例)

**简洁通知模板**

```
### {title}

**操作人**: [{author}]({author_url})
**时间**: {timestamp}

{description}

[👉 点击查看详情]({url})
```

**极简模板**

```
**{title}**

{description}

[查看详情]({url}) | {author} | {timestamp}
```

### 开发

[](#开发)

#### 前端构建

[](#前端构建)

```
cd js
npm install
npm run dev    # 开发模式
npm run build  # 生产构建
```

### 常见问题

[](#常见问题)

#### Q: 消息发送失败怎么办？

[](#q-消息发送失败怎么办)

1. 检查 Webhook 地址是否正确
2. 如果使用加签，确认密钥是否正确
3. 如果使用关键词，确认消息内容包含关键词
4. 检查服务器是否能访问钉钉 API（`oapi.dingtalk.com`）

#### Q: 如何测试配置是否正确？

[](#q-如何测试配置是否正确)

在 Webhook 卡片上点击"测试发送"按钮，会发送一条测试消息到钉钉群。

#### Q: 为什么某些事件没有触发？

[](#q-为什么某些事件没有触发)

1. 检查是否勾选了对应的事件类型
2. 检查标签过滤设置是否正确
3. 检查用户组权限设置

### 许可证

[](#许可证)

MIT License

### 作者

[](#作者)

[JiushuTech](https://github.com/jiushutech)

### 链接

[](#链接)

- [GitHub 仓库](https://github.com/jiushutech/flarum-dingtalk-webhook)
- [问题反馈](https://github.com/jiushutech/flarum-dingtalk-webhook/issues)

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance81

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

98d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/86b840b420ffd841e68a30ae7047f5ab4b7684ab94df56c752cae92496534840?d=identicon)[jiushutech](/maintainers/jiushutech)

---

Top Contributors

[![jiushutech](https://avatars.githubusercontent.com/u/245651560?v=4)](https://github.com/jiushutech "jiushutech (2 commits)")

---

Tags

notificationwebhookdingtalkflarum

### Embed Badge

![Health badge](/badges/jiushutech-flarum-dingtalk-webhook/health.svg)

```
[![Health](https://phpackages.com/badges/jiushutech-flarum-dingtalk-webhook/health.svg)](https://phpackages.com/packages/jiushutech-flarum-dingtalk-webhook)
```

###  Alternatives

[laravel-notification-channels/telegram

Telegram Notifications Channel for Laravel

1.1k3.4M35](/packages/laravel-notification-channels-telegram)[guanguans/notify

Push notification SDK(AnPush、Bark、Chanify、DingTalk、Discord、Gitter、GoogleChat、IGot、Lark、Mattermost、MicrosoftTeams、NowPush、Ntfy、Push、Pushback、PushBullet、PushDeer、PushMe、Pushover、PushPlus、QQ、RocketChat、ServerChan、ShowdocPush、SimplePush、Slack、Telegram、WeWork、WPush、XiZhi、YiFengChuanHua、ZohoCliq、ZohoCliqWebHook、Zulip).

682104.9k7](/packages/guanguans-notify)[laravel-notification-channels/discord

Laravel notification driver for Discord.

2371.3M11](/packages/laravel-notification-channels-discord)[bentools/webpush-bundle

Send push notifications through Web Push Protocol to your Symfony users.

71274.3k](/packages/bentools-webpush-bundle)[gr8shivam/laravel-sms-api

A modern, flexible Laravel package for integrating any SMS gateway with REST API support

10138.4k](/packages/gr8shivam-laravel-sms-api)[calchen/laravel-dingtalk-robot-notification

钉钉智能群助手 Laravel/Lumen 消息通知扩展包（Dingtalk robot message notifications for Laravel/Lumen）

2326.4k](/packages/calchen-laravel-dingtalk-robot-notification)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)