使用 Java 调用飞书自定义机器人 Webhook

3. 构建富文本消息

飞书支持发送 Markdown 或富文本卡片。下面以 Post 类型的富文本卡片为例，展示如何构建 JSON 结构。

private static JSONObject createOuterContent(String title, String message, String detail) {
    JSONObject result = new JSONObject();
    result.put("post", createPostJsonObject(title, message, detail));
    return result;
}

private static JSONObject createPostJsonObject(String title, String message, String detail) {
    JSONObject result = new JSONObject();
    result.put("zh_cn", createZhCNJsonObject(title, message, detail));
    return result;
}

private static JSONObject createZhCNJsonObject(String title, String message, String detail) {
    JSONObject result = new JSONObject();
    result.put("title", title);
    result.put("content", createContentList(message, detail));
    return result;
}

private static JSONArray createContentList(String message, String detail) {
    JSONArray result = new JSONArray();
    // 第一行：标题
    JSONArray item1 = new JSONArray();
    JSONObject text1 = new JSONObject();
    text1.put("tag", "text");
    text1.put("text", message);
    item1.add(text1);
    result.add(item1);
    
    // 第二行：详情
    JSONArray item2 = new JSONArray();
    JSONObject text2 = new JSONObject();
    text2.put("tag", "text");
    text2.put("text", detail);
    item2.add(text2);
    result.add(item2);
    
    return result;
}

4. 发送 HTTP POST 请求

最后组装请求头与 Body，发起 POST 请求。记得在 Header 中放入 Authorization: Sign ${sign} 以及 X-Feishu-Bot-Timestamp。

// 伪代码示例
String url = "YOUR_WEBHOOK_URL";
String timestamp = String.valueOf(seconds);
String sign = genSign(secret, seconds);

JSONObject body = createOuterContent("告警通知", "服务异常", "请检查日志");

// 使用 HttpClient 发送请求...
// headers.put("Authorization", "Sign " + sign);
// headers.put("X-Feishu-Bot-Timestamp", timestamp);

三、避坑指南

• 时区问题：务必确认服务器时间与飞书服务端时间同步，否则签名验证会失败。
• 密钥管理：Secret 属于敏感信息，建议通过环境变量或配置中心注入，不要硬编码在代码里。
• 重试机制：网络波动可能导致发送失败，建议增加简单的重试逻辑。

通过以上步骤，即可稳定地将 Java 应用的状态推送到飞书群聊。如果有更复杂的交互需求，可以参考官方文档扩展卡片组件。