yii2-dingtalk 钉钉群机器人

caikeal 发布于2019-07-01 12:30 / 3071人阅读

摘要：说明群机器人是钉钉群的高级扩展功能。目前，大部分机器人在添加后，还需要进行配置，才可正常使用配置说明详见操作流程中的帮助链接。安装配置在使用本扩展之前，你需要去群机器人获取相关信息。

说明

群机器人是钉钉群的高级扩展功能。群机器人可以将第三方服务的信息聚合到群聊中，实现自动化的信息同步。目前，大部分机器人在添加后，还需要进行Webhook配置，才可正常使用(配置说明详见操作流程中的帮助链接)。

例如：通过聚合GitHub，GitLab等源码管理服务，实现源码更新同步。通过聚合Trello，JIRA等项目协调服务，实现项目信息同步。

另外，群机器人支持Webhook协议的自定义接入，支持更多可能性，例如：你可将运维报警通过自定义机器人聚合到钉钉群实现提醒功能。

安装

$ composer require saviorlv/yii2-dingtalk -vvv

配置

在使用本扩展之前，你需要去群机器人获取相关信息。

使用

在config/main.php配置文件中定义component配置信息

"components" => [
  .....
  "robot" => [
      "class" => "SaviorlvDingtalkRobot",
      "accessToken" => "xxxxxxxxx"
    ],
  ....
]

发送 Text 信息

方法：

public function sendTextMsg($content, array $atMobiles = [], $isAtAll = false){}

参数：

参数	参数类型	必须	说明
content	String	是	消息内容
atMobiles	Array	否	被@人的手机号
isAtAll	bool	否	@所有人时：true，否则为：false

实例：

$response = Yii::$app->robot->sendTextMsg(
    "必要忘记上下班打卡",
    [
        136*****134,
        136*****132
    ],
    false
);

发送 Link 链接

方法：

public function sendLinkMsg($title, $text, $picUrl = "", $messageUrl){}

参数：

参数	参数类型	必须	说明
title	String	是	消息标题
text	String	是	消息内容。如果太长只会部分展示
messageUrl	String	是	点击消息跳转的URL
picUrl	String	否	图片URL

实例：

$response = Yii::$app->robot->sendLinkMsg(
    "上下班打卡",
    "有些同志上下班就是不打卡，QAQ",
    "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1536321778370&di=46a7abc85f6fe1de8df8fbdc5b95d68d&imgtype=0&src=http%3A%2F%2Fimg4.duitang.com%2Fuploads%2Fitem%2F201407%2F21%2F20140721224026_KU3GA.thumb.700_0.jpeg",
    "https://github.com/saviorlv?tab=repositories"
);

发送 MarkDown 消息

方法：

public function sendMarkdownMsg($title, $content, array $atMobiles = [], $isAtAll = false){}

参数：

参数	必选	类型	说明
title	true	string	首屏会话透出的展示内容
content	true	string	markdown格式的消息
atMobiles	Array	否	被@人的手机号(在text内容里要有@手机号)
isAtAll	bool	否	@所有人时：true，否则为：false

实例：

$response = Yii::$app->robot->sendMarkdownMsg(
        "上下班打卡",
        " ###有些同志上下班就是不打卡，`QAQ`",
        [
            136*****134,
            136*****132
        ],
        false
    );

整体跳转 ActionCard类型

方法：

public function sendActionCardMsg($title, $content, $singleURL, $hideAvatar = 0, $btnOrientation = 0, $singleTitle = "阅读原文"){}

参数：

参数	必选	类型	说明
title	true	string	首屏会话透出的展示内容
content	true	string	markdown格式的消息
singleTitle	true	string	单个按钮的方案。(设置此项和singleURL后btns无效)
singleURL	true	string	点击singleTitle按钮触发的URL
btnOrientation	false	string	0-按钮竖直排列，1-按钮横向排列
hideAvatar	false	string	0-正常发消息者头像，1-隐藏发消息者头像

实例：

$response = Yii::$app->robot->sendActionCardMsg(
        "上下班打卡",
        " 有些同志上下班就是不打卡，QAQ",
        "https://github.com/saviorlv?tab=repositories",
        0,
        0,
        "你看不看"
    );

独立跳转 ActionCard 类型

方法：

public function sendSingleActionCardMsg($title, $content, $hideAvatar = 0, $btnOrientation = 0, array $btns=[]){}

参数：

参数	必选	类型	说明
title	true	string	首屏会话透出的展示内容
content	true	string	markdown格式的消息
btns	true	array	按钮的信息：title-按钮方案，actionURL-点击按钮触发的URL
btnOrientation	false	string	0-按钮竖直排列，1-按钮横向排列
hideAvatar	false	string	0-正常发消息者头像，1-隐藏发消息者头像

实例：

$response = Yii::$app->robot->sendSingleActionCardMsg(
            "上下班打卡",
            " 有些同志上下班就是不打卡，QAQ",
            0,
            1,
            [
                [
                    "title"=> "内容不错", 
                    "actionURL"=> "https://www.dingtalk.com/"
                ], 
                [
                    "title"=> "不感兴趣", 
                    "actionURL"=> "https://www.dingtalk.com/"
                ]
            ]
        );

FeedCard 类型

方法：

public function sendFeedCardMsg(array $links=[]){}

参数：

参数	必选	类型	说明
title	true	string	单条信息文本
messageURL	true	string	点击单条信息到跳转链接
picURL	true	string	单条信息后面图片的URL

实例：

  $response = Yii::$app->robot->sendFeedCardMsg([
                [
                    "title"=> "时代的火车向前开",
                    "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"=> "http://b.hiphotos.baidu.com/image/pic/item/f603918fa0ec08fa98d87c8054ee3d6d55fbda39.jpg"
                ],[
                    "title"=> "时代的火车向前开",
                    "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"=> "http://b.hiphotos.baidu.com/image/pic/item/f603918fa0ec08fa98d87c8054ee3d6d55fbda39.jpg"
                ],
        ]);

参考

钉钉自定义机器人

混合云 idc机房托管钉钉群钉钉智能前台钉钉指数钉钉号钉钉

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/30861.html

golang80行代码钉钉群机器人舆情监控

1. 资料 1.1.第三方包 github.com/PuerkitoBio/goquery github.com/go-redis/redis beego框架定时任务包 1.2.接口百度新闻:美剧关键字钉钉群BOT文档 2. 初始化项目变量 package main import ( fmt log github.com/PuerkitoBio/goquery...

weakish 2019-07-24 15:17 评论0 收藏0
从零开始打造专属钉钉机器人

摘要：目前钉钉机器人支持方式，仍属于内侧阶段。方式是指被动接受通知，钉钉群中添加的群机器人默认都是该模式。截止撰写文章时，钉钉的机器人文档不可访问，所以会在下面介绍下。本文同步发表于作者博客从零开始打造专属钉钉机器人官方定义如下：群机器人是钉钉群的高级扩展功能。群机器人可以将第三方服务的信息聚合到群聊中，实现自动化的信息同步。目前，大部分机器人在添加后，还需要进行Webhook配置，才可...

fyber 2019-08-26 10:57 评论0 收藏0
2小时快速搭建后端接口报警系统（基于阿里云日志服务分析nginx访问日志）

摘要：目标后端任一接口一分钟内响应超过一定的量，马上收到报警提示报警及慢接口有详细列表可以查看低成本。相关报警请求的详细信息列表慢响应分析目标后端任一接口一分钟内5xx响应超过一定的量，马上收到报警提示报警及慢接口有详细列表可以查看低成本。几年前公司的日志报警系统是自研的，开发成本比较高，也没有达到阿里云日志服务这种产品化程度机器部署情况阿里云EC服务器功能概述阿里云日...

lemanli 2019-07-25 14:41 评论0 收藏0
PyODPS 安装常见问题解决

摘要：摘要本文将用户安装时遇到的常见问题列举如下，希望在遇到类似问题时可供借鉴。若不存在，确认此问题。安装后报这通常是由于遇到了依赖问题。上安装时报尝试使用上安装仍然报这是由于系统完整性保护导致的。此后在终端中运行此后再行安装。摘要：本文将用户安装 PyODPS 时遇到的常见问题列举如下，希望在遇到类似问题时可供借鉴。在参考下列步骤之前，请首先尝试卸载并重装 PyODPS。卸载的步骤为执...

I_Am 2019-07-30 15:32 评论0 收藏0
WakaTime数据同步展示工具

摘要：从年知道后就开始使用它来记录自己的编码时间，但作为免费版只能查看最近两周的数据，于是很久之前就写了一个程序同步自己的历史数据，不过一直没找到合适的图表插件像官网那样展示数据信息。版本的代码也实现了相关的同步展示逻辑，代码在分支中。从16年知道 WakaTime 后就开始使用它来记录自己的编码时间，但作为免费版只能查看最近两周的数据，于是很久之前就写了一个程序同步自己的历史数据，不过一...

focusj 2019-08-16 14:35 评论0 收藏0