Zum Hauptinhalt springen
DokumentLaufenExterne Nachrichten

Externe Nachrichten

Wo Sie die Nachrichten zwischen Workflow und externen Kanälen wie Telegram einsehen und wie sie sich den Ausführungsdetails zuordnen lassen.

Sobald ein Workflow läuft, muss oft etwas an externe Kanäle gesendet werden: in Telegram eine Frage stellen und auf Ihre Antwort warten, den Tagesbericht in einen Slack-Kanal senden, eine Warnung in eine DingTalk-Gruppe pushen. Die Seite „Externe Nachrichten“ der Konsole fasst diese über die verschiedenen Ausführungen verstreuten Nachrichten in einer durchsuchbaren Liste zusammen; jede Nachricht führt mit einem Klick zurück zu der Ausführung, die sie erzeugt hat. Der Einstieg liegt in der Seitenleiste der Konsole → Externe Nachrichten.

Woher die Nachrichten stammen

Jeder Eintrag in der Liste stammt aus einer bestimmten Ausführung; es gibt im Wesentlichen drei Quellen:

  • IM-Tool-Aufrufe des Agents — sendMessageToUser (Nachricht senden), sendFileToUser (Datei senden), askUserViaIM (fragen und auf Antwort warten)
  • Strukturierte Ereignisse externer Nachrichten im Schritt-Ereignisstrom — werden zur Workflow-Laufzeit zusammen mit den Ereignissen erfasst
  • Ausgaben von Zustellschritten — der Zustellnachweis, der nach erfolgreicher Zustellung eines Reports / einer Datei an Slack oder Telegram hinterlassen wird

Externe Nachrichten haben keinen eigenen Eingabekanal: Die Liste wird durch Indizierung aus dem Ereignisstrom jeder Ausführung gewonnen, und die Ausführungsdaten sind stets die Quelle der Wahrheit. Für den Nachrichteninhalt ist der zum Sendezeitpunkt erfasste Text maßgeblich.

Unterstützte Kanäle

Ausgehende Nachrichten decken 7 IM-Kanäle ab: Telegram, Slack, Discord, WhatsApp, WeCom, DingTalk, Feishu. Davon unterstützt Telegram bidirektionale Kommunikation: Ein Workflow kann während des Laufs eine Frage stellen und auf Ihre Antwort warten, bevor er fortfährt. Diese Seite listet die vom Workflow gesendeten Nachrichten auf; Ihre Antworten sehen Sie in der Ereigniszeitachse der jeweiligen Ausführungsdetails.

Liste und Filter

Die Liste ist nach Sendezeit absteigend sortiert; die Spalten umfassen: Zeit, Kanal, Richtung, Workflow, Ausführungs-ID, Ausführungsstatus, Schritt und Nachrichteninhalt. Die Filterkriterien lassen sich kombinieren:

FilterBeschreibung
StichwortsucheGleicht Nachrichteninhalt, Ausführungs-ID, Workflow-Name, Schrittname und Kanal ab
AusführungsstatusWartend / Laufend / Abgeschlossen / Fehlgeschlagen / Abgebrochen / Unterbrochen
WorkflowsNur die von einem bestimmten Workflow gesendeten Nachrichten anzeigen
externe KanäleNach Kanälen wie Telegram, Slack, DingTalk usw. filtern
NachrichtenrichtungSenden (Textnachricht) oder Datei senden

Die Paginierung bietet 20 / 50 / 100 / 200 Einträge pro Seite zur Auswahl. Ein Klick auf den Nachrichteninhalt oder „Details“ öffnet ein Panel: den vollständigen Originaltext der Nachricht (enthaltene Links sind direkt anklickbar), die Sendezeit, den zugehörigen Workflow und Schritt sowie die beiden Schaltflächen „Nachricht kopieren“ und „Ausführungsdetails ansehen“.

Verhältnis zu den Ausführungsdetails

Dieselbe Gruppe von Nachrichten hat in der Konsole drei Einstiege, von grober zu feiner Granularität:

  • Seite „Externe Nachrichten“ (diese Seite) — eine ausführungsübergreifende Sammelliste, geeignet, um eine Nachricht nach Kanal oder Stichwort zu verfolgen
  • Ausführungsliste — Ausführungen, die externe Nachrichten gesendet haben, tragen ein Nachrichten-Badge; beim Überfahren mit der Maus werden die Anzahl und eine Vorschau der jüngsten Nachricht angezeigt
  • Ausführungsdetails — der Tab „Externe Nachrichten“ listet nur die von dieser einen Ausführung gesendeten Nachrichten auf; in der Ereigniszeitachse sehen Sie den vollständigen Kontext vor und nach einer Nachricht, etwa was der Nutzer nach einer Frage geantwortet hat und ob es eine Zeitüberschreitung gab

Jede Nachricht hält den Namen des Schritts fest, der sie erzeugt hat. Erhalten Sie eine inhaltlich falsche Nachricht, gelangen Sie von hier in die Ausführungsdetails und lokalisieren das Log dieses Schritts — viel schneller, als den Chatverlauf zu durchsuchen.

Die Nachrichtenliste über die API abrufen

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>"
ParameterBeschreibung
page / sizePaginierung; size standardmäßig 50, maximal 200 (die Web-UI zeigt standardmäßig 20 pro Seite)
workflowIdNur einen bestimmten Workflow anzeigen
statusNach Ausführungsstatus filtern, z. B. COMPLETED, FAILED
serviceKanal, in Kleinbuchstaben, z. B. telegram, slack, dingtalk, feishu
directionNachrichtenrichtung: outgoing (Text) oder outgoing_file (Datei)
searchStichwort, mit demselben Abgleichumfang wie das Suchfeld der Seite

Jeder zurückgegebene Datensatz enthält executionId, workflowId, workflowName, executionStatus, service, direction, content, stepName und timestamp — genug, um in einem externen System zu rekonstruieren, „welcher Schritt welches Workflows wann was an welchen Kanal gesendet hat“.

Verwandte Seiten