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

Overview

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

Build Status Latest Stable Version Total Downloads Latest Unstable Version License Scrutinizer Code Quality Code Intelligence Status Open Source Love

请先阅读 钉钉官方文档

介绍

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

要求

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

安装

composer require wangju/ding-notice

在非laravel项目中使用

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

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

在laravel项目中使用

安装成功后执行

php artisan vendor:publish --provider="DingNotice\DingNoticeServiceProvider"

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

相关配置

钉钉启用开关

(可选)默认为开启

DING_ENABLED=true

钉钉的推送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验证

  • (可选)默认为开启,关闭请手动设置
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类型的消息

$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类型的消息

发送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类型的消息

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

发送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();

多机器人消息发送

发送纯文字消息

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 :)

  • 效果 file
You might also like...
Comments
  • $title 标题,不包含在消息提中

    $title 标题,不包含在消息提中

    $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)
    

    title 不是标题吗,不能显示在消息中, 只能把title 加到markdown 内容

    opened by vic091 1
  • [优化] 当触发钉钉发送消息频率限制 发送消息失败  会报错

    [优化] 当触发钉钉发送消息频率限制 发送消息失败 会报错

    是类型约束的问题

    message":"Symfony\\Component\\Debug\\Exception\\FatalThrowableError:  Return  value  of  DingNotice\\HttpClient::send()  must  be  of  the  type  array,  null  returned  in  /data/webroot/qingke_basic_record/vendor/wangju/ding-notice/src/HttpClient.php:80\nStack  trace:\n#0  
    
    opened by wujunze 1
  • code reformat

    code reformat

    Reverts wowiwj/ding-notice#7

    https://github.com/okami-chen/ding-notice/blob/1c6e279472add2b4b806d6638ef324028561cbe5/src/HttpClient.php#L72

    可以把加密参数也放到getRobotUrl里面,同时配置文件也应该更新一下:) ,感觉放到send不太好

    opened by wowiwj 0
Releases(1.0.10)
Owner
王举
王举