钉钉开放平台文档地址

https://open.dingtalk.com/document/

服务端SDK下载地址

https://open.dingtalk.com/document/resourcedownload/download-server-sdk

就拿java的服务端SDK来说分为两个大的版本：老版本SDK和新版本SDK.

钉钉相关依赖的官方maven仓库地址

https://s01.oss.sonatype.org/?spm=ding_open_doc.document.0.0.4564722fJDmwRj#nexus-search;quick~dingtalk

1.自定义机器人接入

这种方式只需要在钉钉中拉一个群，人员超过三个人即可拉一个聊天的群，然后设置智能群助手，添加机器人：

机器人设置：

webHook地址就是下面的url地址（不包含sign和timestamp）: https://oapi.dingtalk.com/robot/send?access_token=xxxxxx

加签的key就是下面代码中的的secret的值

1.1接口文档

https://open.dingtalk.com/document/group/custom-robot-access

1.2引入pom依赖

        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>alibaba-dingtalk-service-sdk</artifactId>
            <version>2.0.0</version>
        </dependency>

1.3代码编写

      // 签名 
      private String getSign(String secret, Long timestamp) {
            try {
                String stringToSign = timestamp + "\n" + secret;
                Mac mac = Mac.getInstance("HmacSHA256");
                mac.init(new SecretKeySpec(secret.getBytes("UTF-8"), "HmacSHA256"));
                byte[] signData = mac.doFinal(stringToSign.getBytes("UTF-8"));
                String sign = URLEncoder.encode(new String(Base64.encodeBase64(signData)), "UTF-8");
                log.info("【发送钉钉群消息】获取到签名sign = {}", sign);
                return sign;
            } catch (Exception e) {
                log.error("【发送钉钉群消息】计算签名异常，errMsg = {}", e);
                return null;
            }
        }

        //接口调用code
        Long timestamp = System.currentTimeMillis();
        String secret = "xxxxxx";
        String sign = this.getSign(secret, timestamp);
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/robot/send?access_token=xxxxxx"+"&sign="+sign+"&timestamp="+timestamp);
        OapiRobotSendRequest request = new OapiRobotSendRequest();
        request.setMsgtype("text");
        OapiRobotSendRequest.Text text = new OapiRobotSendRequest.Text();
        text.setContent("测试文本消息");
        request.setText(text);
        OapiRobotSendResponse rsp = client.execute(request);

• 文本 (text)

• 链接 (link)

• markdown(markdown)

• ActionCard

• FeedCard

  
  

2.企业机器人向内部群发消息

2.1如何调用机器人API

https://open.dingtalk.com/document/group/call-robot-api-operations

2.2接口文档

https://open.dingtalk.com/document/group/the-robot-sends-a-group-message

企业机器人向内部群发送消息是属于新版本skd的酷应用的接口

2.3酷应用是什么？

https://open.dingtalk.com/document/org/cool-application-introduction

简单来说：酷应用 = 场景 + 组件 + 场景的逻辑做成事儿为主

2.4酷应用官方训练营

https://h5.dingtalk.com/live/video_lesson.htm?feedId=e8a07af9-339a-47ca-84cd-15e8939789b9&mcnId=6580122020211712477&feedProperty=1#/

2.5酷应用分类

2.6API在线调试工具

API Explorer是一款可视化的API在线调试工具，集成了API总览、快速检索、开发文档、可视化调试、同步动态生成可执行SDK Demo代码，功能丰富、简单易用。

https://open-dev.dingtalk.com/apiExplorer?spm=ding_open_doc.document.0.0.3361722f69ljpO#/?devType=org&api=robot_1.0%23OrgGroupSend

2.7引入POM依赖

        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>dingtalk</artifactId>
            <version>1.4.44</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>tea-openapi</artifactId>
            <version>0.2.6</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>tea-util</artifactId>
            <version>0.2.14</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>openapiutil</artifactId>
            <version>0.1.14</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>endpoint-util</artifactId>
            <version>0.0.7</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>tea</artifactId>
            <version>1.1.14</version>
        </dependency>

2.8接口代码示例

        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkrobot_1_0.Client client = new com.aliyun.dingtalkrobot_1_0.Client(config);
        OrgGroupSendHeaders orgGroupSendHeaders = new OrgGroupSendHeaders();
        orgGroupSendHeaders.xAcsDingtalkAccessToken = "xxxxxxxxxxxxxxx";
        OrgGroupSendRequest orgGroupSendRequest = new OrgGroupSendRequest()
                .setMsgParam("{\"content\":\"今天吃肘子\"}")
                .setMsgKey("sampleText")
                .setOpenConversationId("cid6KeBBLoveMJOGXoYKF5x7EeiodoA==")
                .setRobotCode("dingue4kfzdxbynxxxxxx")
                .setCoolAppCode("COOLAPP-1-101A83B831A5212Cxxxxxxxxxxx");
        try {
            client.orgGroupSendWithOptions(orgGroupSendRequest, orgGroupSendHeaders, new RuntimeOptions());
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message))              {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }

        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message))              {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }

        }