Messages externes
Où consulter les messages échangés entre les workflows et des canaux externes comme Telegram, et comment les rattacher au détail des exécutions.
Une fois un workflow lancé, il faut souvent envoyer des éléments vers des canaux externes : poser une question dans Telegram et attendre votre réponse, envoyer un rapport quotidien dans un canal Slack, ou pousser une alerte vers un groupe DingTalk. La page « Messages externes » de la console rassemble ces messages disséminés dans les différentes exécutions au sein d'une liste consultable ; chaque message permet de revenir en un clic à l'exécution qui l'a produit. L'accès se fait via la barre latérale de la console → Messages externes.
D'où proviennent les messages
Chaque enregistrement de la liste provient d'une exécution ; il existe principalement trois sources :
- Appels d'outils IM de l'Agent — sendMessageToUser (envoyer un message), sendFileToUser (envoyer un fichier), askUserViaIM (poser une question et attendre une réponse)
- Événements de message externe structurés dans le flux d'événements des étapes — enregistrés avec les événements pendant l'exécution du workflow
- Sortie des étapes de type remise — enregistrements de remise laissés après qu'un rapport / fichier a été remis avec succès à Slack ou Telegram
Les messages externes n'ont pas de canal de saisie dédié : la liste est indexée à partir du flux d'événements de chaque exécution, les données d'exécution restant toujours la source de vérité. Le contenu du message fait foi selon le texte enregistré au moment de l'envoi.
Canaux pris en charge
Les messages sortants couvrent 7 canaux IM : Telegram, Slack, Discord, WhatsApp, WeCom, DingTalk, Feishu. Parmi eux, Telegram est bidirectionnel : un workflow peut poser une question en cours d'exécution et attendre votre réponse avant de continuer. Cette page liste les messages émis par les workflows ; le contenu de vos réponses se consulte dans la chronologie des événements des détails d'exécution correspondants.
Liste et filtrage
La liste est triée par date d'envoi décroissante ; les colonnes comprennent : date, canal, sens, workflow, ID d'exécution, état d'exécution, étape, contenu du message. Les filtres peuvent se cumuler :
| Filtre | Description |
|---|---|
| Recherche par mot-clé | Correspond au contenu du message, à l'ID d'exécution, au nom du workflow, au nom de l'étape et au canal |
| Statut d'exécution | En attente / En cours / Terminé / Échoué / Annulé / Interrompu |
| Workflows | N'afficher que les messages émis par un workflow donné |
| canaux externes | Filtrer par canal, comme Telegram, Slack, DingTalk |
| Sens du message | Envoi (message texte) ou envoi de fichier |
La pagination propose 20 / 50 / 100 / 200 éléments par page. Cliquer sur le contenu du message ou sur « Détails » ouvre un tiroir : texte intégral du message (dont les liens sont directement cliquables), date d'envoi, workflow et étape d'appartenance, ainsi que les deux boutons « Copier le message » et « Voir les détails d'exécution ».
Relation avec les détails d'exécution
Un même ensemble de messages dispose de trois points d'accès dans la console, du plus grossier au plus fin :
- Page des messages externes (cette page) — liste consolidée couvrant toutes les exécutions, adaptée pour retrouver un message par canal ou par mot-clé
- Liste des exécutions — une exécution ayant émis des messages externes porte un badge de message ; le survol affiche le nombre et un aperçu du dernier message
- Détails d'exécution — l'onglet « Messages externes » ne liste que les messages émis par cette exécution ; la chronologie des événements permet de voir le contexte complet autour d'un message, par exemple ce que l'utilisateur a répondu après une question et s'il y a eu un dépassement de délai
Chaque message consigne le nom de l'étape qui l'a produit. Face à un message au contenu incorrect, accéder d'ici aux détails d'exécution et localiser le journal de cette étape est bien plus rapide que de parcourir l'historique de conversation.
Récupérer la liste des messages via l'API
# 最近的外部消息（时间倒序）
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>"| Paramètres | Description |
|---|---|
page / size | Pagination ; size vaut 50 par défaut et 200 au maximum (l'interface Web affiche 20 par page par défaut) |
workflowId | N'afficher qu'un workflow donné |
status | Filtrer par état d'exécution, comme COMPLETED, FAILED |
service | Canal, en minuscules, comme telegram, slack, dingtalk, feishu |
direction | Sens du message : outgoing (texte) ou outgoing_file (fichier) |
search | Mot-clé, dont la portée de correspondance est identique à celle du champ de recherche de la page |
Chaque enregistrement renvoyé contient executionId, workflowId, workflowName, executionStatus, service, direction, content, stepName, timestamp, ce qui suffit à reconstituer dans un système externe « quelle étape de quel workflow a envoyé quoi, quand et vers quel canal ».
Pages connexes
- Surveillance et journalisation de l'exécution — chronologie et flux d'événements des détails d'exécution
- Partage public du produit — les liens publics fréquents dans les messages proviennent d'ici
- Configuration des agents — activer les outils IM dans le jeu d'outils de l'Agent