PHPackages                             smartjson/dingtalk - 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. [Utility & Helpers](/categories/utility)
4. /
5. smartjson/dingtalk

ActiveLibrary[Utility & Helpers](/categories/utility)

smartjson/dingtalk
==================

dingtalk robot, 钉钉机器人

v1.0.5(3y ago)017MITPHPPHP >=7.0

Since Feb 26Pushed 3y ago1 watchersCompare

[ Source](https://github.com/smartjsoncom/dingtalk)[ Packagist](https://packagist.org/packages/smartjson/dingtalk)[ RSS](/packages/smartjson-dingtalk/feed)WikiDiscussions main Synced 1w ago

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

钉钉推送机器人消息发送laravel扩展包
=====================

[](#钉钉推送机器人消息发送laravel扩展包)

### 请先阅读 [钉钉官方文档](https://open-doc.dingtalk.com/microapp/serverapi2/qf2nxq)

[](#请先阅读-钉钉官方文档)

介绍
==

[](#介绍)

ding-talk 是一款钉钉机器人消息发送的Laravel扩展，您可以通过此扩展便捷的发送钉钉消息，进行监控和提醒操作

要求
==

[](#要求)

- php版本:>=7.0
- laravel版本: Laravel5.5+

安装
==

[](#安装)

```
composer require smartjson/dingtalk
```

在非laravel项目中使用
==============

[](#在非laravel项目中使用)

```
$ding = new \SmartJson\DingTalk([
    "default" => [
        'enabled' => true,
        'token' => "you-push-token",
        'timeout' => 2.0,
        'ssl_verify' => true,
        'secret' => '',
    ]
]);

$ding->text('我就是我, 是不一样的烟火');
```

在laravel项目中使用
=============

[](#在laravel项目中使用)

安装成功后执行

```
php artisan vendor:publish --provider="SmartJson\DingNoticeServiceProvider"
```

会自动将`ding.php`添加到您项目的配置文件当中

相关配置
====

[](#相关配置)

### 钉钉启用开关

[](#钉钉启用开关)

(可选)默认为开启

```
DING_ENABLED=true
```

### 钉钉的推送token

[](#钉钉的推送token)

- (必选)发送钉钉机器人的token，即在您创建机器人之后的access\_token
- 钉钉推送链接:[https://oapi.dingtalk.com/robot/send?access\_token=you-push-token](https://oapi.dingtalk.com/robot/send?access_token=you-push-token)

```
DING_TOKEN=you-push-token
```

### 多机器人配置

[](#多机器人配置)

如果想要添加多个机器人，则在`ding.php`当中添加机器人名字和相关的配置即可

```
return [

    'default' => [
        'enabled' => env('DING_ENABLED',true),
        'token' => env('DING_TOKEN',''),
        'timeout' => env('DING_TIME_OUT',2.0),
        'ssl_verify' => env('DING_SSL_VERIFY',true),
        'secret' => env('DING_SECRET',true),
    ],

    'other' => [
        'enabled' => env('OTHER_DING_ENABLED',true),
        'token' => env('OTHER_DING_TOKEN',''),
        'timeout' => env('OTHER_DING_TIME_OUT',2.0),
        'ssl_verify' => env('DING_SSL_VERIFY',true),
        'secret' => env('OTHER_DING_SECRET',true),
    ]
];
```

### 钉钉发送的超时时间

[](#钉钉发送的超时时间)

- (可选) 默认为2.0秒

```
DING_TIME_OUT=
```

### 是否开启SSL验证

[](#是否开启ssl验证)

- (可选)默认为开启，关闭请手动设置

```
DING_SSL_VERIFY=false
```

### 开启钉钉安全配置

[](#开启钉钉安全配置)

- (可选)默认为无

```
DING_SECRET=
```

使用
==

[](#使用)

发送纯文字消息
-------

[](#发送纯文字消息)

```
ding('我就是我, xxx 是不一样的烟火');
```

or

```
ding()->text('我就是我, xxx 是不一样的烟火');
```

发送过程@其他人或者所有人

```
ding()->at(["13888888888"],true)
      ->text("我就是我,@13888888888 是不一样的烟火");
```

发送链接类型的消息
---------

[](#发送链接类型的消息)

```

$title = "自定义机器人协议";
$text = "群机器人是钉钉群的高级扩展功能。群机器人可以将第三方服务的信息聚合到群聊中，实现自动化的信息同步。例如：通过聚合GitHub，GitLab等源码管理服务，实现源码更新同步；通过聚合Trello，JIRA等项目协调服务，实现项目信息同步。不仅如此，群机器人支持Webhook协议的自定义接入，支持更多可能性，例如：你可将运维报警提醒通过自定义机器人聚合到钉钉群。";
$picUrl = "";
$messageUrl = "https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.Rqyvqo&treeId=257&articleId=105735&docType=1";

ding()->link($title,$text,$messageUrl,$picUrl)
```

发送markdown类型的消息
---------------

[](#发送markdown类型的消息)

```
$title = '杭州天气';
$markdown = "#### 杭州天气  \n ".
            "> 9度，@1825718XXXX 西北风1级，空气良89，相对温度73%\n\n ".
            "> ![screenshot](http://i01.lw.aliimg.com/media/lALPBbCc1ZhJGIvNAkzNBLA_1200_588.png)\n".
            "> ###### 10点20分发布 [天气](http://www.thinkpage.cn/) ";

ding()->markdown($title,$markdown);
```

or

```
ding()->at([],true)
    ->markdown($title,$markdown)
```

发送Action类型的消息
-------------

[](#发送action类型的消息)

### 发送single类型的消息

[](#发送single类型的消息)

```
$title = "乔布斯 20 年前想打造一间苹果咖啡厅，而它正是 Apple Store 的前身";
$text = "![screenshot](@lADOpwk3K80C0M0FoA) \n".
    " #### 乔布斯 20 年前想打造的苹果咖啡厅 \n\n".
    " Apple Store 的设计正从原来满满的科技感走向生活化，而其生活化的走向其实可以追溯到 20 年前苹果一个建立咖啡馆的计划";

ding()->actionCard($title,$text,1)
    ->single("阅读全文","https://www.dingtalk.com/")
    ->send()
```

### 发送btns类型的消息

[](#发送btns类型的消息)

```
ding()->actionCard($title,$text,1)
    ->addButtons("内容不错","https://www.dingtalk.com/")
    ->addButtons("不感兴趣","https://www.dingtalk.com/")
    ->send();
```

发送Feed类型的消息
-----------

[](#发送feed类型的消息)

```
$messageUrl = "https://mp.weixin.qq.com/s?__biz=MzA4NjMwMTA2Ng==&mid=2650316842&idx=1&sn=60da3ea2b29f1dcc43a7c8e4a7c97a16&scene=2&srcid=09189AnRJEdIiWVaKltFzNTw&from=timeline&isappinstalled=0&key=&ascene=2&uin=&devicetype=android-23&version=26031933&nettype=WIFI";
$picUrl = "https://www.dingtalk.com";
ding()->feed()
    ->addLinks('时代的火车向前开',$messageUrl,$picUrl)
    ->addLinks('时代的火车向前开2',$messageUrl,$picUrl)
    ->send();
```

多机器人消息发送
--------

[](#多机器人消息发送)

### 发送纯文字消息

[](#发送纯文字消息-1)

```
ding('我就是我, xxx 是不一样的烟火','other')
```

or

```
ding()->with('other')->text('我就是我, xxx 是不一样的烟火');
```

### 通过其他机器人发送其他类型消息

[](#通过其他机器人发送其他类型消息)

```
ding()->with('other')->markdown($title,$markdown);

ding()->with('other')
       ->feed()
       ->addLinks('时代的火车向前开',$messageUrl,$picUrl)
       ->addLinks('时代的火车向前开2',$messageUrl,$picUrl)
       ->send();
```

enjoy :)

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

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

Every ~138 days

Total

5

Last Release

1356d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d021fc8a569fff9f2c92a71c37aadba8b8bbd52ed35f7ce17e048d506d487ea2?d=identicon)[chensongah](/maintainers/chensongah)

---

Tags

laravelding talkding notice

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/smartjson-dingtalk/health.svg)

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

###  Alternatives

[gehrisandro/tailwind-merge-laravel

TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them

341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[backpack/basset

Dead-simple way to load CSS or JS assets only once per page, when using Laravel 10+.

202832.4k6](/packages/backpack-basset)[wangju/ding-notice

a dingtalk robot message handle for send message

191182.0k9](/packages/wangju-ding-notice)[firefly-iii/data-importer

Firefly III Data Import Tool.

7545.8k](/packages/firefly-iii-data-importer)[bensampo/laravel-embed

Painless responsive embeds for videos, slideshows and more.

142146.8k](/packages/bensampo-laravel-embed)[glhd/conveyor-belt

14797.0k](/packages/glhd-conveyor-belt)

PHPackages © 2026

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