目录
- 一、关于钉钉机器人
- 二、接入机器人
- 2.1 选择一个钉钉群
- 2.2 群设置中找到`智能群助手`
- 2.3 添加机器人
- 2.4 选择机器人类型
- 2.5 配置机器人选项
- 2.6 保留webhook
- 三、使用注意事项
- 四、代码中接入
- 4.1 在命令行中 使用 curl 快速进行测试
- 4.2 PHP代码中接入
- 五、参考
一、关于钉钉机器人
对于开发者而言，钉钉机器人是全局唯一的应用，每个机器人都有一个唯一id，拿到这个id后，我们无需安装或引用第三方sdk及应用，即可使用。
常见需求场景：
- 可以捕获程序中的错误并将此推送到钉钉群中，方便开发人员快速解决。
- 也可捕获平台的运营信息，推送到钉钉群中，方便运营人员快速掌握最新信息。
二、接入机器人
2.1 选择一个钉钉群
2.2 群设置中找到智能群助手
2.3 添加机器人
2.4 选择机器人类型
这儿我们选择自定义机器人：
2.5 配置机器人选项
勾选自定义关键词后，发送的时候内容中必须含有关键词才能正常发送。
2.6 保留webhook
将 webhook 地址复制出来，获取到Webhook地址后，用户可以向这个地址发起HTTP POST 请求，即可实现给该钉钉群发送消息。
三、使用注意事项
- 发起POST请求时，必须将字符集编码设置成UTF-8。
- 每个机器人每分钟最多发送20条。
- 当前自定义机器人支持文本 (text)、链接 (link)、markdown(markdown)、ActionCard、FeedCard消息类型。
- Markdown消息无法实现艾特人功能。
四、代码中接入
4.1 在命令行中 使用 curl 快速进行测试
curl 'https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx' \-H 'Content-Type: application/json' \-d '{"msgtype": "text","text": {"content":"你好，我是异常消息！"}}'
4.2 PHP代码中接入
index.php：
<?php
function request_by_curl($remote_server, $post_string) {$ch = curl_init();curl_setopt($ch, CURLOPT_URL, $remote_server);curl_setopt($ch, CURLOPT_POST, 1);curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);curl_setopt($ch, CURLOPT_HTTPHEADER, array ('Content-Type: application/json;charset=utf-8'));curl_setopt($ch, CURLOPT_POSTFIELDS, $post_string);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);// 线下环境不用开启curl证书验证, 未调通情况可尝试添加该代码curl_setopt ($ch, CURLOPT_SSL_VERIFYHOST, 0);curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER, 0);$data = curl_exec($ch);curl_close($ch);return $data;
}$webhook = "https://oapi.dingtalk.com/robot/send?access_token=XXXXXXXXXXXXXXXX";
$message="警告，您的代码出现异常bug！";
$data = array ('msgtype' => 'text','text' => array ('content' => $message));
$data_string = json_encode($data);$result = request_by_curl($webhook, $data_string);print_r($result);结果：
D:\software\phpstudy_pro\WWW>php index.php
{"errcode":0,"errmsg":"ok"}
五、参考
链接: 钉钉开放文档
