发送钉钉机器人消息使用钉钉智能机器人消息。创建智能机器人步骤，测试机器人消息是否正常发送，使用java代码示例进行钉钉机

前言

最近有个需求，在企业注册到系统的时候需要及时通知审核人员进行审核。之前用邮件进行通知，但是实时性不太好，有时候还发不出来，不太稳定。后来要求使用微信通知，但是永久性通知审核比较严格，达不到要求。于是使用钉钉智能机器人消息。

创建钉钉智能机器人

参考链接自定义机器人接入

调用频率限制

由于消息发送太频繁会严重影响群的使用体验，因此自定义机器人发送消息的频率限制如下： 每个机器人每分钟最多发送20条消息到群里，如果超过20条，会限流10分钟。

注意: 如果你有大量发消息的场景（譬如系统监控报警）可以将这些信息进行整合，通过markdown消息以摘要的形式发送到群里。

步骤一：获取自定义机器人Webhook

选择需要添加机器人的群聊，然后依次单击群设置 > 智能群助手。
在机器人管理页面选择自定义机器人，输入机器人名字并选择要发送消息的群，同时可以为机器人设置机器人头像。
完成必要的安全设置，勾选我已阅读并同意《自定义机器人服务及免责条款》，然后单击完成。
完成安全设置后，复制出机器人的Webhook地址，可用于向这个群发送消息，格式如下：
```
https://oapi.dingtalk.com/robot/send?access_token=XXXXXX
```

注意: 请保管好此Webhook 地址，不要公布在外部网站上，泄露后有安全风险。

使用自定义机器人

获取到Webhook地址后，用户可以向该地址发起HTTP POST 请求，即可实现给该钉钉群发送消息。

注意

已默认开通使用自定义机器人发消息的权限，无需申请。即向Webhook地址发请求时，无需申请权限。

发起POST请求时，必须将字符集编码设置成UTF-8。

每个机器人每分钟最多发送20条。消息发送太频繁会严重影响群成员的使用体验，大量发消息的场景 (譬如系统监控报警) 可以将这些信息进行整合，通过markdown消息以摘要的形式发送到群里。

当前自定义机器人支持以下消息类型，请根据自己的使用场景选择合适的类型，详情参见消息类型及数据格式。

文本 (text)
链接 (link)
markdown(markdown)
ActionCard
FeedCard

自定义机器人发送消息时，可以通过手机号码指定“被@人列表”。在“被@人列表”里面的人员收到该消息时，会有@消息提醒。免打扰会话仍然通知提醒，首屏出现“有人@你”。

步骤三：测试自定义机器人

通过以下方法，可以快速验证自定义机器人是否可以正常工作：使用命令行工具curl。

说明: 为避免出错，将以下命令逐行复制到命令行，需要将xxxxxxxx替换为真实access_token；若测试出错，请检查复制的命令是否和测试命令一致，多特殊字符会报错。

curl 'https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx' \
 -H 'Content-Type: application/json' \
 -d '{"msgtype": "text","text": {"content":"我就是我, 是不一样的烟火"}}'

Java示例代码

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/robot/send?access_token=566cc69da782ec******");
OapiRobotSendRequest request = new OapiRobotSendRequest();
request.setMsgtype("text");
OapiRobotSendRequest.Text text = new OapiRobotSendRequest.Text();
text.setContent("测试文本消息");
request.setText(text);
OapiRobotSendRequest.At at = new OapiRobotSendRequest.At();
at.setAtMobiles(Arrays.asList("132xxxxxxxx"));
// isAtAll类型如果不为Boolean，请升级至最新SDK
at.setIsAtAll(true);
at.setAtUserIds(Arrays.asList("109929","32099"));
request.setAt(at);

request.setMsgtype("link");
OapiRobotSendRequest.Link link = new OapiRobotSendRequest.Link();
link.setMessageUrl("https://www.dingtalk.com/");
link.setPicUrl("");
link.setTitle("时代的火车向前开");
link.setText("这个即将发布的新版本，创始人xx称它为红树林。而在此之前，每当面临重大升级，产品经理们都会取一个应景的代号，这一次，为什么是红树林");
request.setLink(link);

request.setMsgtype("markdown");
OapiRobotSendRequest.Markdown markdown = new OapiRobotSendRequest.Markdown();
markdown.setTitle("杭州天气");
markdown.setText("#### 杭州天气 @156xxxx8827\n" +
        "> 9度，西北风1级，空气良89，相对温度73%\n\n" +
        "> ![screenshot](https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png)\n"  +
        "> ###### 10点20分发布 [天气](http://www.thinkpage.cn/) \n");
request.setMarkdown(markdown);
OapiRobotSendResponse response = client.execute(request);

常见问题

当出现以下错误时，表示消息校验未通过，请查看机器人的安全设置。

    // 消息内容中不包含任何关键词
    {
      "errcode":310000,
      "errmsg":"keywords not in content"
    }

    // timestamp 无效
    {
      "errcode":310000,
      "errmsg":"invalid timestamp"
    }

    // 签名不匹配
    {
      "errcode":310000,
      "errmsg":"sign not match"
    }

    // IP地址不在白名单
    {
      "errcode":310000,
      "errmsg":"ip X.X.X.X not in whitelist"
    }

参考

dingtalk