如何通过Slack Webhook URL上传文本文件？Postman与Spring Boot实现

Slack的Incoming Webhook不支持直接上传文件，它仅用于发送文本或结构化消息。要实现文件上传到频道，需使用Slack的files.upload API，以下是Postman测试和Spring Boot实现的具体步骤：

Postman 测试步骤 #

• 准备Slack Bot Token：需拥有files:write权限，可在Slack开发者平台的应用OAuth & Permissions页面生成
• 配置POST请求：
  • 请求URL：https://slack.com/api/files.upload
  • 请求头添加：Authorization: Bearer <你的Bot Token>
  • 选择form-data格式，添加以下参数：
    • channels：目标频道的ID或名称（如#general）
    • file：选择本地要上传的文本文件
    • filename：（可选）指定文件名，若不填则自动使用原文件名
    • title：（可选）文件在频道内显示的标题
• 发送请求，检查返回JSON中的ok字段为true即表示上传成功

Spring Boot 实现步骤 #

1. 添加依赖（pom.xml）

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId> <!-- 若用WebClient -->
</dependency>

2. 编写文件上传逻辑

方式1：使用RestTemplate #

import org.springframework.core.io.FileSystemResource;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;
import org.springframework.web.client.RestTemplate;

import java.io.File;

public class SlackFileUploader {
    private static final String SLACK_FILE_UPLOAD_URL = "https://slack.com/api/files.upload";
    private static final String BOT_TOKEN = "你的Bot Token";
    private static final String TARGET_CHANNEL = "#general";

    public void uploadFile(File textFile) {
        RestTemplate restTemplate = new RestTemplate();
        HttpHeaders headers = new HttpHeaders();
        headers.setBearerAuth(BOT_TOKEN);
        headers.setContentType(MediaType.MULTIPART_FORM_DATA);

        MultiValueMap<String, Object> body = new LinkedMultiValueMap<>();
        body.add("channels", TARGET_CHANNEL);
        body.add("file", new FileSystemResource(textFile));
        body.add("title", "上传的文本文件");

        HttpEntity<MultiValueMap<String, Object>> requestEntity = new HttpEntity<>(body, headers);
        ResponseEntity<String> response = restTemplate.postForEntity(SLACK_FILE_UPLOAD_URL, requestEntity, String.class);
        
        // 处理响应，判断是否上传成功
        System.out.println(response.getBody());
    }
}

方式2：使用WebClient（非阻塞） #

import org.springframework.core.io.FileSystemResource;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.web.reactive.function.BodyInserters;
import org.springframework.web.reactive.function.client.WebClient;

import java.io.File;

public class SlackFileUploaderWebClient {
    private static final String SLACK_FILE_UPLOAD_URL = "https://slack.com/api/files.upload";
    private static final String BOT_TOKEN = "你的Bot Token";
    private static final String TARGET_CHANNEL = "#general";

    public void uploadFile(File textFile) {
        WebClient webClient = WebClient.create();
        webClient.post()
                .uri(SLACK_FILE_UPLOAD_URL)
                .header(HttpHeaders.AUTHORIZATION, "Bearer " + BOT_TOKEN)
                .contentType(MediaType.MULTIPART_FORM_DATA)
                .body(BodyInserters.fromMultipartData("channels", TARGET_CHANNEL)
                        .with("file", new FileSystemResource(textFile))
                        .with("title", "上传的文本文件"))
                .retrieve()
                .bodyToMono(String.class)
                .subscribe(response -> System.out.println(response));
    }
}

3. （可选）上传后通过Incoming Webhook发送通知
   上传成功后，从响应中提取文件的permalink字段，构造JSON消息发送到你的Incoming Webhook URL，示例消息体：

{
    "text": "已上传文本文件：<https://slack-files.com/xxx|查看文件>"
}

内容的提问来源于stack exchange，提问作者Aditya K