摘要:说明群机器人是钉钉群的高级扩展功能。目前,大部分机器人在添加后,还需要进行配置,才可正常使用配置说明详见操作流程中的帮助链接。安装配置在使用本扩展之前,你需要去群机器人获取相关信息。
说明
群机器人是钉钉群的高级扩展功能。群机器人可以将第三方服务的信息聚合到群聊中,实现自动化的信息同步。目前,大部分机器人在添加后,还需要进行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" ], ]);参考
钉钉自定义机器人
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/30861.html
摘要:目前钉钉机器人支持方式,仍属于内侧阶段。方式是指被动接受通知,钉钉群中添加的群机器人默认都是该模式。截止撰写文章时,钉钉的机器人文档不可访问,所以会在下面介绍下。本文同步发表于作者博客从零开始打造专属钉钉机器人 官方定义如下: 群机器人是钉钉群的高级扩展功能。群机器人可以将第三方服务的信息聚合到群聊中,实现自动化的信息同步。目前,大部分机器人在添加后,还需要进行Webhook配置,才可...
摘要:目标后端任一接口一分钟内响应超过一定的量,马上收到报警提示报警及慢接口有详细列表可以查看低成本。相关报警请求的详细信息列表慢响应分析 目标 后端任一接口一分钟内5xx响应超过一定的量,马上收到报警提示 报警及慢接口有详细列表可以查看 低成本。几年前公司的日志报警系统是自研的,开发成本比较高,也没有达到阿里云日志服务这种产品化程度 机器部署情况 阿里云EC服务器 功能概述 阿里云日...
摘要:摘要本文将用户安装时遇到的常见问题列举如下,希望在遇到类似问题时可供借鉴。若不存在,确认此问题。安装后报这通常是由于遇到了依赖问题。上安装时报尝试使用上安装仍然报这是由于系统完整性保护导致的。此后在终端中运行此后再行安装。 摘要: 本文将用户安装 PyODPS 时遇到的常见问题列举如下,希望在遇到类似问题时可供借鉴。在参考下列步骤之前,请首先尝试卸载并重装 PyODPS。卸载的步骤为执...
摘要:从年知道后就开始使用它来记录自己的编码时间,但作为免费版只能查看最近两周的数据,于是很久之前就写了一个程序同步自己的历史数据,不过一直没找到合适的图表插件像官网那样展示数据信息。版本的代码也实现了相关的同步展示逻辑,代码在分支中。 从16年知道 WakaTime 后就开始使用它来记录自己的编码时间,但作为免费版只能查看最近两周的数据,于是很久之前就写了一个程序同步自己的历史数据,不过一...
阅读 546·2021-11-18 10:02
阅读 1025·2021-11-02 14:41
阅读 637·2021-09-03 10:29
阅读 1873·2021-08-23 09:42
阅读 2691·2021-08-12 13:31
阅读 1173·2019-08-30 15:54
阅读 1927·2019-08-30 13:09
阅读 1412·2019-08-30 10:55