주요 콘텐츠로 건너뛰기
문서달리다외부 메시지

외부 메시지

워크플로와 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가 포함되어, 외부 시스템에서 "어느 워크플로의 어느 단계가, 언제, 어느 채널로 무엇을 보냈는지"를 복원하기에 충분합니다.

관련 페이지