Saltar para o conteúdo principal
DocsExecutarMensagens externas

Mensagens externas

Onde visualizar mensagens trocadas entre workflows e canais externos, como Telegram, e como eles mapeam para detalhes de execução.

Uma vez que um workflow está rodando, muitas vezes ele precisa enviar coisas para canais externos: faça uma pergunta no Telegram e aguarde sua resposta, publique um relatório diário em um canal Slack ou empurre um alerta para um grupo DingTalk. A página "Mensagens externas" do console coleta essas mensagens, espalhadas por execuções, em uma lista pesquisável, e cada mensagem retorna à execução que a produziu em um clique. Encontre-o em Console sidebar → Mensagens externas.

De Onde vêm as mensagens

Cada registro na lista vem de uma execução, principalmente de três fontes:

  • Chamadas de uma ferramenta IM do Agente — sendMessageToUser (enviar uma mensagem), sendFileToUser (enviar um arquivo), askUserViaIM (perguntar e esperar por uma resposta)
  • Eventos de mensagem externa estruturados em um fluxo de eventos de uma etapa — gravados ao lado de eventos à medida que o workflow é executado
  • Saída das etapas de entrega — o registro de entrega deixado após um relatório ou arquivo ser entregue com sucesso ao Slack ou Telegram

As mensagens externas não têm um canal de ingestão separado: a lista é indexada do fluxo de eventos de cada execução, e os dados de execução são sempre a fonte da verdade. O conteúdo da mensagem reflete o texto gravado no momento do envio.

Canais suportados

As mensagens de saída cobrem 7 canais IM: Telegram, Slack, Discord, WhatsApp, WeCom, DingTalk e Feishu. O telegrama é bidirecional: um workflow pode fazer uma pergunta no meio da execução e esperar sua resposta antes de continuar. Esta página lista as mensagens enviadas por um workflow; as suas respostas podem ser visualizadas na timeline de eventos dos detalhes de execução correspondentes.

Lista e filtros

A lista é ordenada por tempo de envio, mais recente primeiro, com colunas de tempo, canal, direção, workflow, ID de execução, estado de execução, passo e conteúdo de mensagem. Os filtros podem ser empilhados:

FiltroDesignação das mercadorias
Pesquisa de palavras- chaveCorresponde ao conteúdo da mensagem, ID de execução, nome do workflow, nome do passo e canal
Estado da execuçãoEspera / Execução / Completa / Falha / Cancelado / Interrompido
workflowsVeja apenas as mensagens enviadas por um workflow específico
canais externosFiltrar por canal, como Telegram, Slack ou DingTalk
Direcção da mensagemEnviar (mensagem de texto) ou enviar ficheiro

Tamanhos de página de 20 / 50 / 100 / 200 estão disponíveis. Clicando no conteúdo da mensagem ou "Detalhes" abre uma gaveta com a mensagem original completa (links nela são clicáveis), o tempo de envio, o workflow e passo próprio, e dois botões: "Mensagem cópia" e "Ver detalhes de execução"

Relação com os detalhes da execução

As mesmas mensagens têm três pontos de entrada no console, de grosso para fino:

  • A página Mensagens Externas (esta página) — uma lista agregada em todas as execuções, boa para rastrear uma mensagem por canal ou palavra-chave
  • A lista de execução — execuções que enviaram mensagens externas carregam um crachá de mensagem; passe para ver a contagem e uma antevisão da última
  • Detalhes de execução — a aba "Mensagens externas" lista apenas as mensagens enviadas; a linha do tempo do evento mostra o contexto completo em torno de uma mensagem, como o que o usuário respondeu após uma pergunta e se ele cronometrou

Cada mensagem registra o nome do passo que o produziu. Quando o conteúdo de uma mensagem está errado, clicar nos detalhes da execução e localizar os logs dessa etapa é muito mais rápido do que percorrer um histórico de chat.

Puxar a lista de mensagens através da 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>"
ParâmetrosDesignação das mercadorias
page / sizePaginação; tamanho padrão para 50, máx. 200 (a interface Web é padrão para 20 por página)
workflowIdVeja apenas um workflow específico
statusFiltrar pelo estado de execução, como COMPLETED ou FALHOU
serviceCanal, minúsculas, tais como telegrama, folga, dingtalk, ou feishu
directionDireção da mensagem: saída (texto) ou saída arquivo (arquivo)
searchPalavra- chave, que corresponde ao mesmo intervalo da caixa de pesquisa da página

Cada registro retornado inclui executionId, workflowId, workflowName, executionStatus, service, direction, content, stepName e timestamp — o suficiente para reconstruir em um sistema externo "qual passo do workflow enviou o que, quando e para qual canal."

Páginas relacionadas