一.背景

飛書（Lark）作為企業(yè)級協(xié)同辦公平臺，其消息卡片（富媒體消息）憑借 “結(jié)構(gòu)化展示、交互性強(qiáng)、可視化程度高” 的特性，成為企業(yè)內(nèi)部告警通知、業(yè)務(wù)審批、數(shù)據(jù)推送、流程提醒的核心載體。Java 作為企業(yè)級后端開發(fā)的主流語言，是支撐核心業(yè)務(wù)系統(tǒng)（如風(fēng)控系統(tǒng)、訂單系統(tǒng)、大數(shù)據(jù)平臺）的核心技術(shù)棧，實現(xiàn) “Java 發(fā)送飛書消息卡片” 的需求，源于傳統(tǒng)飛書消息推送方式的痛點，以及企業(yè)對 “業(yè)務(wù)系統(tǒng) - 協(xié)同辦公” 高效聯(lián)動、信息精準(zhǔn)觸達(dá)的核心訴求。

1.傳統(tǒng)飛書消息推送的核心痛點

1. 消息形式單一，信息傳遞效率低傳統(tǒng)方式多通過飛書機(jī)器人發(fā)送純文本 / 簡單 markdown 消息，無法結(jié)構(gòu)化展示復(fù)雜業(yè)務(wù)信息：例如風(fēng)控系統(tǒng)觸發(fā)異常告警時，僅能以 “XX 訂單風(fēng)控異常，金額 XX 元” 的文本形式推送，無法直觀展示訂單詳情、異常指標(biāo)、操作入口等關(guān)鍵信息；業(yè)務(wù)人員需跳轉(zhuǎn)至業(yè)務(wù)系統(tǒng)才能查看完整內(nèi)容，信息獲取鏈路長、響應(yīng)效率低。

2. 無交互能力，無法閉環(huán)業(yè)務(wù)流程純文本消息僅能實現(xiàn) “信息告知”，無法承載交互操作：例如審批類消息無法直接在飛書內(nèi)完成 “同意 / 駁回” 操作，需人工登錄業(yè)務(wù)系統(tǒng)處理；數(shù)據(jù)推送類消息無法提供 “查看詳情”“導(dǎo)出數(shù)據(jù)” 等快捷入口，導(dǎo)致 “消息推送 - 業(yè)務(wù)處理” 的流程割裂，增加人工操作成本。

3. 適配企業(yè)級系統(tǒng)集成難企業(yè)核心業(yè)務(wù)系統(tǒng)（如金融交易系統(tǒng)、電商訂單系統(tǒng)、大數(shù)據(jù)監(jiān)控平臺）多基于 Java 開發(fā)，傳統(tǒng)飛書消息推送依賴手動配置機(jī)器人、編寫簡單腳本，無法無縫集成至 Java 業(yè)務(wù)系統(tǒng)的業(yè)務(wù)流程中：例如訂單系統(tǒng)完成大額訂單生成后，無法自動觸發(fā)飛書消息卡片推送；大數(shù)據(jù)平臺監(jiān)控到任務(wù)失敗時，需人工編寫腳本推送告警，時效性差且易遺漏。

4. 格式不規(guī)范，信息展示混亂手動推送飛書消息時，易因格式不統(tǒng)一導(dǎo)致信息展示混亂：例如不同業(yè)務(wù)線的告警消息卡片字段不一致、樣式不統(tǒng)一，業(yè)務(wù)人員需花費額外時間理解信息；且無法根據(jù)接收人角色（如研發(fā)、運維、產(chǎn)品）定制消息卡片內(nèi)容，信息過載或關(guān)鍵信息缺失問題突出。

5. 缺乏權(quán)限與風(fēng)控管控，合規(guī)風(fēng)險高金融、政企等行業(yè)對消息推送的權(quán)限、審計要求嚴(yán)苛，傳統(tǒng)方式無法管控 “誰發(fā)送了消息、發(fā)送了什么內(nèi)容、接收人是誰”；且無法對敏感信息（如客戶手機(jī)號、交易金額）進(jìn)行脫敏處理，易引發(fā)數(shù)據(jù)泄露風(fēng)險，難以滿足等保、隱私保護(hù)等合規(guī)要求。

2.Java 發(fā)送飛書消息卡片的核心價值

Java 作為企業(yè)級開發(fā)語言，結(jié)合飛書開放平臺提供的消息卡片 API，能高效解決傳統(tǒng)方式的痛點，實現(xiàn) “業(yè)務(wù)系統(tǒng)事件 - 飛書消息卡片 - 業(yè)務(wù)交互” 的全流程閉環(huán)，核心價值體現(xiàn)在：

1. 結(jié)構(gòu)化展示復(fù)雜業(yè)務(wù)信息，提升信息觸達(dá)效率Java 可通過飛書消息卡片 API 構(gòu)建結(jié)構(gòu)化、可視化的卡片內(nèi)容，將業(yè)務(wù)系統(tǒng)的復(fù)雜信息（如訂單詳情、告警指標(biāo)、數(shù)據(jù)報表）以 “標(biāo)題 + 字段 + 表格 + 圖片” 的形式精準(zhǔn)推送：例如大數(shù)據(jù)平臺監(jiān)控到 Spark 作業(yè)失敗時，Java 程序可生成包含 “作業(yè)名稱、失敗時間、失敗原因、日志鏈接、重啟入口” 的消息卡片，業(yè)務(wù)人員無需跳轉(zhuǎn)系統(tǒng)即可掌握核心信息，響應(yīng)效率提升 80% 以上。

2. 集成交互能力，閉環(huán)業(yè)務(wù)流程飛書消息卡片支持按鈕、選擇器等交互組件，Java 可在卡片中配置 “同意 / 駁回”“重啟作業(yè)”“查看詳情” 等操作按鈕，并對接業(yè)務(wù)系統(tǒng)接口：例如審批類消息卡片的 “同意” 按鈕點擊后，Java 后端可接收飛書回調(diào)并自動完成業(yè)務(wù)系統(tǒng)的審批流程；告警卡片的 “重啟作業(yè)” 按鈕可直接觸發(fā)大數(shù)據(jù)平臺的作業(yè)重啟接口，實現(xiàn) “消息推送 - 操作執(zhí)行” 的一站式閉環(huán)。

3. 無縫集成企業(yè)級 Java 業(yè)務(wù)系統(tǒng)Java 可將飛書消息卡片推送邏輯封裝為通用工具類 / 組件，嵌入核心業(yè)務(wù)系統(tǒng)的業(yè)務(wù)流程中，實現(xiàn) “事件觸發(fā) - 自動推送”：例如訂單系統(tǒng)基于 Spring Boot 開發(fā)，可在訂單支付完成的業(yè)務(wù)邏輯后，直接調(diào)用消息卡片推送組件，自動向運營人員推送包含訂單信息的卡片；大數(shù)據(jù)監(jiān)控平臺基于 Java 開發(fā)，可在檢測到任務(wù)異常時，實時推送告警卡片至運維群，替代人工干預(yù)。

4. 標(biāo)準(zhǔn)化與定制化結(jié)合，適配多場景需求Java 可封裝通用的消息卡片模板（如告警模板、審批模板、數(shù)據(jù)推送模板），保證不同業(yè)務(wù)線的消息格式統(tǒng)一；同時支持根據(jù)接收人角色、業(yè)務(wù)場景動態(tài)調(diào)整卡片內(nèi)容：例如向研發(fā)人員推送的告警卡片包含技術(shù)日志、堆棧信息，向管理人員推送的卡片僅展示核心指標(biāo)和處理結(jié)果，避免信息過載。

5. 精細(xì)化管控，滿足合規(guī)訴求Java 程序可對接企業(yè)權(quán)限系統(tǒng)，在發(fā)送消息卡片前校驗推送人員 / 應(yīng)用的權(quán)限，僅允許授權(quán)角色推送敏感業(yè)務(wù)信息；同時對卡片中的敏感數(shù)據(jù)（如身份證號、銀行卡號）進(jìn)行自動脫敏處理；推送過程中記錄審計日志（推送人、時間、內(nèi)容、接收人），滿足金融、政企等行業(yè)的合規(guī)審計要求。

3.典型應(yīng)用場景

1. 企業(yè)級告警通知：大數(shù)據(jù)平臺、服務(wù)器監(jiān)控系統(tǒng)、風(fēng)控系統(tǒng)基于 Java 觸發(fā)異常告警時，推送包含異常詳情、操作入口的飛書消息卡片至運維 / 風(fēng)控群，實現(xiàn)告警信息精準(zhǔn)觸達(dá)、快速響應(yīng)。
2. 業(yè)務(wù)流程審批：OA 系統(tǒng)、采購系統(tǒng)、合同系統(tǒng)等 Java 后端系統(tǒng)發(fā)起審批流程時，推送包含審批事項、附件、操作按鈕的消息卡片至審批人飛書，支持飛書內(nèi)直接完成審批操作，閉環(huán)審批流程。
3. 核心業(yè)務(wù)數(shù)據(jù)推送：電商、金融行業(yè)的訂單系統(tǒng)、交易系統(tǒng)將大額訂單、核心交易數(shù)據(jù)以消息卡片形式推送至運營 / 管理人員飛書，直觀展示業(yè)務(wù)關(guān)鍵指標(biāo)，提升數(shù)據(jù)監(jiān)控效率。
4. 自動化運營提醒：物流系統(tǒng)、客戶管理系統(tǒng)基于 Java 觸發(fā)物流狀態(tài)變更、客戶跟進(jìn)提醒時，推送包含快捷操作入口的消息卡片至對應(yīng)員工飛書，降低運營人員操作成本。
5. 大數(shù)據(jù)作業(yè)監(jiān)控：Spark/Flink 作業(yè)平臺（Java 開發(fā)）監(jiān)控到作業(yè)失敗、數(shù)據(jù)延遲等問題時，推送包含作業(yè)日志、重啟按鈕的消息卡片至研發(fā)群，實現(xiàn)作業(yè)故障快速定位與處理。

綜上，Java 發(fā)送飛書消息卡片，是企業(yè)實現(xiàn) “核心業(yè)務(wù)系統(tǒng) - 飛書協(xié)同辦公” 深度聯(lián)動的關(guān)鍵路徑：既解決了傳統(tǒng)消息推送形式單一、流程割裂、集成難的痛點，又通過 Java 語言的企業(yè)級特性，保障了消息推送的穩(wěn)定性、安全性與合規(guī)性，為企業(yè)提升辦公效率、閉環(huán)業(yè)務(wù)流程、精準(zhǔn)觸達(dá)信息提供了高效的技術(shù)支撐。

二.具體實現(xiàn)

1.獲取token

        String url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal";

        JSONObject json = new JSONObject();
            json.put("app_id", "");
            json.put("app_secret", "");

        Map<String, String> headers = new HashMap<>();

            headers.put("Content-Type", "application/json; charset=utf-8");


        String rs = HttpUtil.sendPost(url,json.toString());

        System.out.println(rs);

        String tenant_access_token = JSONObject.parseObject(rs).getString("tenant_access_token");

2.獲取發(fā)送人的id

String url2 = "https://open.feishu.cn/open-apis/contact/v3/users/batch_get_id?user_id_type=open_id";

Map<String, String> headers2 = new HashMap<>();

     headers2.put("Content-Type", "application/json; charset=utf-8");
     headers2.put("Authorization","Bearer "+tenant_access_token);

JSONObject json2 = new JSONObject();
     json2.put("emails",new String[]{xxx"});
     json2.put("mobiles",new String[]{"xxx"});
     json2.put("include_resigned",true);


String rs2 = HttpUtil.sendPost(url2,json2.toString(),headers2);

 

String user_id = JSONObject.parseObject(rs2).getJSONObject("data").getJSONArray("user_list").getJSONObject(0).getString("user_id");

3.發(fā)送消息卡片

       String url3 = "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id";

        JSONArray arr = new JSONArray();

            JSONObject one = new JSONObject();
                one.put("oldConfig","舊配置測試01");
                one.put("newConfig","新配置測試02");
                one.put("operator","修改");

            arr.add(one);


        JSONObject variable = new JSONObject();
            variable.put("creator","xxx");
            variable.put("project","測試項目");
            variable.put("taskName","測試任務(wù)001");
            variable.put("reasonText","業(yè)務(wù)改造");
            variable.put("approvalTime","xxxxxx");

            variable.put("resources",arr);


        JSONObject templateData = new JSONObject();

            templateData.put("template_id","xxxxx");
            templateData.put("template_version_name","1.0.2");
            templateData.put("template_variable",variable);


        JSONObject template = new JSONObject();

            template.put("type","template");
            template.put("data",templateData);

        JSONObject json3 = new JSONObject();
            json3.put("receive_id",user_id);
            json3.put("msg_type","interactive");
            json3.put("content",template.toJSONString());


        String rs3 = HttpUtil.sendPost(url3,json3.toString(),headers2);

總結(jié) 

到此這篇關(guān)于java發(fā)送飛書消息卡片具體實現(xiàn)方法的文章就介紹到這了,更多相關(guān)java發(fā)送飛書消息卡片內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論