Spring Boot应用替换Slack为Microsoft Teams通知的依赖咨询

一、可选的Maven依赖方案 #

Teams Incoming Webhook本质是HTTP POST请求，不需要强制引入专属SDK，以下是几种常用方案：

方案1：直接用Spring自带组件（无额外依赖） #

Spring Boot默认集成spring-web模块，可直接使用RestTemplate或WebClient发送请求，无需新增依赖。

方案2：引入OkHttp（增强HTTP客户端能力） #

如果需要更灵活的HTTP配置（如超时、拦截器），可添加OkHttp依赖：

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.12.0</version> <!-- 推荐使用最新稳定版 -->
</dependency>

方案3：使用封装好的Teams通知库 #

若想类似SlackApi那样用封装好的API简化开发，可引入轻量库：

<dependency>
    <groupId>io.github.jamsesso</groupId>
    <artifactId>microsoft-teams-notifications</artifactId>
    <version>1.0.0</version>
</dependency>

二、核心实施步骤 #

1. 移除Slack相关依赖
   删除pom.xml中SimpleSlackApi的依赖项：

<!-- 移除该Slack依赖 -->
<dependency>
    <groupId>com.github.seratch</groupId>
    <artifactId>slack-api-client</artifactId>
    <version>1.2.0</version>
</dependency>

2. 确认Webhook配置
   确保application.yml中的Teams Webhook URL配置正确：

teams:
  webhook-url: "你的Teams渠道Webhook地址"

3. 实现通知发送逻辑

示例1：用RestTemplate发送基础通知 #

import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestTemplate;

@Component
public class TeamsNotificationService {

    @Value("${teams.webhook-url}")
    private String webhookUrl;

    private final RestTemplate restTemplate;

    public TeamsNotificationService(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    public void sendFileProcessAlert(boolean success, String fileName) {
        String content = success ? 
            String.format("文件处理成功：*%s*", fileName) : 
            String.format("文件处理失败：*%s*", fileName);
        
        // Teams支持简单Markdown格式的消息体
        String payload = String.format("{" +
                "\"text\": \"%s\"" +
                "}", content);

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        HttpEntity<String> request = new HttpEntity<>(payload, headers);

        restTemplate.postForObject(webhookUrl, request, String.class);
    }
}

示例2：用封装库发送通知 #

import io.github.jamsesso.microsoft.teams.MicrosoftTeamsClient;
import io.github.jamsesso.microsoft.teams.MicrosoftTeamsMessage;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class TeamsNotificationService {

    private final MicrosoftTeamsClient teamsClient;

    public TeamsNotificationService(@Value("${teams.webhook-url}") String webhookUrl) {
        this.teamsClient = new MicrosoftTeamsClient(webhookUrl);
    }

    public void sendFileProcessAlert(boolean success, String fileName) {
        String content = success ? 
            String.format("文件处理成功：*%s*", fileName) : 
            String.format("文件处理失败：*%s*", fileName);
        
        MicrosoftTeamsMessage message = new MicrosoftTeamsMessage(content);
        teamsClient.sendMessage(message);
    }
}

三、注意事项 #

• Teams支持部分Markdown语法，比如*加粗*、_斜体_、>引用等，可按需调整消息样式。
• 若需要复杂卡片（如按钮、图片、分栏布局），可按照Teams官方消息卡片格式构造JSON payload。
• 确保应用服务器能访问Teams的Webhook地址，避免防火墙或代理拦截请求。

内容的提问来源于stack exchange，提问作者Nakul Arora