<!-- 方案A: snowheart的starter -->
<dependency>
    <groupId>cn.snowheart</groupId>
    <artifactId>spring-boot-dingtalk-robot-starter</artifactId>
    <version>1.0.3.RELEASE</version>
</dependency>

<!-- 方案B: javafamily的starter -->
<dependency>
    <groupId>club.javafamily</groupId>
    <artifactId>dingtalk-notification-spring-boot-starter</artifactId>
    <version>2.3.2-beta.13</version>
</dependency>

# 如果使用snowheart的starter
dingtalk:
  robot:
    prefix: https://oapi.dingtalk.com/robot/send
    access-token: your_access_token_here
    secret:
      secret-enabled: true
      secret-token: your_secret_here

# 如果使用javafamily的starter  
javafamily:
  notify:
    dingtalk:
      hook-url: https://oapi.dingtalk.com/robot/send?access_token=your_token
      enabled: true

@RestController
public class DingTalkController {
    
    @Autowired
    private DingTalkRobotClient dingTalkRobotClient; // snowheart starter
    
    /**
     * 發(fā)送帶圖片的Link消息
     */
    @GetMapping("/sendLinkMessage")
    public void sendLinkMessageWithImage() {
        // 圖片必須先上傳到公網(wǎng)可訪問的URL
        String imageUrl = "https://example.com/your-image.jpg";
        String title = "系統(tǒng)監(jiān)控告警";
        String text = "服務(wù)器CPU使用率超過90%，請及時(shí)處理！";
        String messageUrl = "http://your-system.com/detail"; // 點(diǎn)擊跳轉(zhuǎn)鏈接
        
        LinkMessage linkMessage = new LinkMessage(title, text, imageUrl, messageUrl);
        DingTalkResponse response = dingTalkRobotClient.sendLinkMessage(linkMessage);
        
        if (response.getErrcode().longValue() == 0L) {
            System.out.println("Link消息發(fā)送成功");
        }
    }
}

/**
 * 發(fā)送Markdown格式的圖片消息
 */
@GetMapping("/sendMarkdownWithImage")
public void sendMarkdownWithImage() {
    String imageUrl = "https://example.com/chart.png";
    
    String markdownText = "### 業(yè)務(wù)數(shù)據(jù)報(bào)表\n\n" +
                         "最新業(yè)務(wù)數(shù)據(jù)統(tǒng)計(jì)圖如下：\n\n" +
                         "![業(yè)務(wù)圖表](" + imageUrl + ")\n\n" +
                         "**統(tǒng)計(jì)時(shí)間：** " + new Date();
    
    MarkdownMessage markdownMessage = new MarkdownMessage(
        "業(yè)務(wù)數(shù)據(jù)通知", 
        markdownText
    );
    
    DingTalkResponse response = dingTalkRobotClient.sendMarkdownMessage(markdownMessage);
    
    if (response.getErrcode().longValue() == 0L) {
        System.out.println("Markdown消息發(fā)送成功");
    }
}

@SpringBootTest
public class DingTalkNotifyTests {
    
    @Autowired
    private DingTalkNotifyHandler dingTalkNotifyHandler; // javafamily starter
    
    @Test
    void testNotifyLinkMessage() {
        String imageUrl = "https://example.com/image.jpg";
        
        DingTalkLinkRequest request = DingTalkLinkRequest.of(
            "系統(tǒng)通知",
            "發(fā)現(xiàn)異常請求，請及時(shí)查看處理",
            "https://your-system.com/detail",
            imageUrl
        );
        
        String response = dingTalkNotifyHandler.notify(request);
        System.out.println("發(fā)送結(jié)果：" + response);
    }
}

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

@Component
public class DingTalkService {
    
    @Value("${dingding.app-key}")
    private String appKey;
    
    @Value("${dingding.app-secret}")
    private String appSecret;
    @Value("${dingding.agent-id}")
    private Long agentId;
    
    /**
     * 獲取AccessToken
     */
    public String getAccessToken() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
        OapiGettokenRequest request = new OapiGettokenRequest();
        request.setAppkey(appKey);
        request.setAppsecret(appSecret);
        request.setHttpMethod("GET");
        
        OapiGettokenResponse response = client.execute(request);
        return response.getAccessToken();
    }
    
    /**
     * 上傳圖片并發(fā)送
     */
    public void sendImageMessage(String userId, String imageUrl) throws ApiException {
        String accessToken = getAccessToken();
        
        // 1. 先上傳圖片獲取media_id
        String mediaId = uploadImage(accessToken, imageUrl);
        
        // 2. 發(fā)送圖片消息
        DingTalkClient client = new DefaultDingTalkClient(
            "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2");
        
        OapiMessageCorpconversationAsyncsendV2Request req = new OapiMessageCorpconversationAsyncsendV2Request();
        req.setAgentId(agentId);
        req.setUseridList(userId);
        
        OapiMessageCorpconversationAsyncsendV2Request.Msg msg = 
            new OapiMessageCorpconversationAsyncsendV2Request.Msg();
        msg.setMsgtype("image");
        
        msg.setImage(new OapiMessageCorpconversationAsyncsendV2Request.Image());
        msg.getImage().setMediaId(mediaId);
        
        req.setMsg(msg);
        
        OapiMessageCorpconversationAsyncsendV2Response rsp = client.execute(req, accessToken);
        if (rsp.getErrcode() != 0) {
            throw new RuntimeException("發(fā)送失?。? + rsp.getErrmsg());
        }
    }
    
    /**
     * 上傳圖片到釘釘服務(wù)器
     */
    private String uploadImage(String accessToken, String imageUrl) throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/media/upload");
        OapiMediaUploadRequest request = new OapiMediaUploadRequest();
        request.setType("image");
        
        // 需要下載圖片并上傳
        FileItem item = new FileItem(new URL(imageUrl).openStream());
        request.setMedia(item);
        
        OapiMediaUploadResponse response = client.execute(request, accessToken);
        return response.getMediaId();
    }
}

@Service
public class MonitorAlertService {
    
    @Autowired
    private DingTalkRobotClient dingTalkRobotClient;
    
    public void sendAlertWithChart(String alertMsg, String chartImageUrl) {
        String markdownContent = "### ?? 系統(tǒng)監(jiān)控告警\n\n" +
                               "**告警信息：** " + alertMsg + "\n\n" +
                               "**趨勢圖表：** \n\n" +
                               "![監(jiān)控圖表](" + chartImageUrl + ")\n\n" +
                               "**時(shí)間：** " + new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date());
        
        MarkdownMessage message = new MarkdownMessage("系統(tǒng)監(jiān)控告警", markdownContent);
        
        // @所有人
        message.setIsAtAll(true);
        
        DingTalkResponse response = dingTalkRobotClient.sendMarkdownMessage(message);
        
        if (response.getErrcode() == 0) {
            System.out.println("告警消息發(fā)送成功");
        }
    }
}