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：

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"}

五、参考

链接: 钉钉开放文档