跳轉到主要內容
文件運行外部訊息

外部訊息

workflow 與 Telegram 等外部渠道往來的訊息在哪裡看、怎麼與執行詳情對應。

工作流跑起來之後經常要往外部通道發東西：在 Telegram 裡提問等您回覆、把日報發進 Slack 頻道、給釘釘群推一條告警。控制台的「外部訊息」頁把這些散落在各次執行裡的訊息收進一張可搜尋的列表，每條訊息都能一鍵跳回產生它的那次執行。入口在 控制台側邊欄 → 外部訊息。

訊息從哪裡來

列表裡的每一筆記錄都來自某次執行，主要有三類來源：

  • Agent 的 IM 工具呼叫 — sendMessageToUser（發訊息）、sendFileToUser（發檔案）、askUserViaIM（提問並等待回覆）
  • 步驟事件流中的結構化外部訊息事件 — 工作流執行時隨事件一起記錄
  • 送達型步驟的輸出 — 報表 / 檔案成功送達 Slack 或 Telegram 後留下的送達記錄

外部訊息沒有獨立的錄入通道：列表由每次執行的事件流擷取索引而來，執行資料始終是事實來源。訊息內容以傳送當時記錄的文字為準。

支援的通道

出站訊息涵蓋 7 個 IM 通道：Telegram、Slack、Discord、WhatsApp、企業微信、釘釘、飛書。其中 Telegram 支援雙向：工作流可以在執行中提問並等待您的回覆再繼續。本頁列出的是工作流發出的訊息；您的回覆內容在對應執行詳情的事件時間軸裡查看。

列表與篩選

列表按傳送時間倒序，欄位包括：時間、通道、方向、工作流、執行 ID、執行狀態、步驟、訊息內容。篩選條件可疊加：

篩選項說明
關鍵字搜尋比對訊息內容、執行 ID、工作流名、步驟名、通道
執行狀態等待中 / 執行中 / 已完成 / 失敗 / 已取消 / 已中斷
工作流程只看某條工作流發出的訊息
外部管道按 Telegram、Slack、釘釘等通道篩選
訊息方向傳送（文字訊息）或傳送檔案

分頁每頁 20 / 50 / 100 / 200 條可選。點訊息內容或「詳情」會開啟抽屜：完整訊息原文（其中的連結可直接點開）、傳送時間、所屬工作流與步驟，以及「複製訊息」「查看執行詳情」兩個按鈕。

與執行詳情的關係

同一批訊息在控制台有三個入口，粒度由粗到細：

  • 外部訊息頁（本頁）— 跨所有執行的彙總列表，適合按通道或關鍵字追一條訊息
  • 執行列表 — 發過外部訊息的執行帶一個訊息角標，滑鼠停留顯示條數與最近一條的預覽
  • 執行詳情 — 「外部訊息」標籤頁只列這一次執行發出的訊息；事件時間軸裡能看到訊息前後的完整上下文，比如提問之後使用者回了什麼、有沒有逾時

每條訊息都記錄了產生它的步驟名。收到一條內容不對的訊息時，從這裡點進執行詳情、定位到那一步的日誌，比翻聊天記錄快得多。

用 API 拉取訊息列表

bash
# 最近的外部消息（时间倒序）
curl "https://braidrun.com/api/executions/external-messages?page=1&size=50" \
  -H "Authorization: Bearer <token>"

# 只看某条工作流发到 Telegram 的文本消息
curl "https://braidrun.com/api/executions/external-messages?workflowId=<workflow-id>&service=telegram&direction=outgoing" \
  -H "Authorization: Bearer <token>"
參數說明
page / size分頁；size 預設 50、最大 200（Web UI 預設每頁 20）
workflowId只看某條工作流
status按執行狀態篩選，如 COMPLETED、FAILED
service通道，小寫，如 telegram、slack、dingtalk、feishu
direction訊息方向：outgoing（文字）或 outgoing_file（檔案）
search關鍵字，比對範圍與頁面搜尋框相同

每條回傳記錄包含 executionId、workflowId、workflowName、executionStatus、service、direction、content、stepName、timestamp，足夠在外部系統裡還原「哪條工作流的哪一步、什麼時候、往哪個通道發了什麼」。

相關頁面