Saltar al contenido principal
DocumentoCorrerMensajes externos

Mensajes externos

Dónde ver los mensajes intercambiados entre el workflow y canales externos como Telegram, y cómo relacionarlos con los detalles de la ejecución.

Una vez que un workflow está en marcha, a menudo hay que enviar cosas a canales externos: preguntar en Telegram y esperar su respuesta, enviar el informe diario a un canal de Slack, mandar una alerta a un grupo de DingTalk. La página «Mensajes externos» de la consola recoge en una lista buscable estos mensajes que quedan dispersos por las distintas ejecuciones, y cada mensaje permite saltar con un clic a la ejecución que lo generó. El acceso está en la barra lateral de la consola → Mensajes externos.

De Dónde vienen los mensajes

Cada registro de la lista proviene de una ejecución concreta; principalmente hay tres tipos de origen:

  • Llamadas a las herramientas de IM del Agent — sendMessageToUser (enviar mensaje), sendFileToUser (enviar archivo), askUserViaIM (preguntar y esperar respuesta)
  • Eventos estructurados de mensaje externo en el flujo de eventos del paso — se registran junto con los eventos durante la ejecución del workflow
  • Salida de los pasos de tipo entrega — el registro de entrega que queda tras enviar con éxito un informe / archivo a Slack o Telegram

Los mensajes externos no tienen un canal de entrada propio: la lista se construye extrayendo e indexando el flujo de eventos de cada ejecución, y los datos de ejecución son siempre la fuente de verdad. El contenido del mensaje se toma del texto registrado en el momento del envío.

Canales admitidos

Los mensajes salientes cubren 7 canales de IM: Telegram, Slack, Discord, WhatsApp, WeCom, DingTalk, Feishu. De ellos, Telegram admite comunicación bidireccional: el workflow puede preguntar durante la ejecución y esperar su respuesta antes de continuar. Esta página lista los mensajes que envía el workflow; el contenido de sus respuestas se consulta en la línea de tiempo de eventos del detalle de la ejecución correspondiente.

Lista y filtros

La lista se ordena por hora de envío en orden descendente; las columnas incluyen: hora, canal, dirección, workflow, ID de ejecución, estado de la ejecución, paso, contenido del mensaje. Los filtros se pueden combinar:

FiltrosDescripción
Búsqueda por palabra claveCoincide con el contenido del mensaje, el ID de ejecución, el nombre del workflow, el nombre del paso y el canal
Estado de ejecuciónEn espera / En ejecución / Completada / Fallida / Cancelada / Interrumpida
FlujosVer solo los mensajes enviados por un workflow concreto
canales externosFiltrar por canal: Telegram, Slack, DingTalk, etc.
Dirección del mensajeEnvío (mensaje de texto) o envío de archivo

La paginación permite elegir 20 / 50 / 100 / 200 por página. Al pulsar el contenido del mensaje o «Detalles» se abre un panel lateral: el texto original completo del mensaje (sus enlaces se pueden abrir directamente), la hora de envío, el workflow y el paso a los que pertenece, y dos botones, «Copiar mensaje» y «Ver detalle de la ejecución».

Relación con el detalle de la ejecución

Un mismo conjunto de mensajes tiene tres accesos en la consola, de grano grueso a fino:

  • Página de mensajes externos (esta página) — lista agregada de todas las ejecuciones, adecuada para seguir un mensaje por canal o palabra clave
  • Lista de ejecuciones — las ejecuciones que han enviado mensajes externos llevan una insignia de mensaje; al pasar el cursor muestra el número y una vista previa del más reciente
  • Detalle de la ejecución — la pestaña «Mensajes externos» solo lista los mensajes enviados en esa ejecución; en la línea de tiempo de eventos se ve el contexto completo antes y después del mensaje, por ejemplo qué respondió el usuario tras una pregunta o si hubo timeout

Cada mensaje registra el nombre del paso que lo generó. Cuando reciba un mensaje con un contenido incorrecto, entrar desde aquí al detalle de la ejecución y localizar el registro de ese paso es mucho más rápido que revisar el historial de chat.

Obtener la lista de mensajes vía 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ámetrosDescripción
page / sizepaginación; size por defecto 50, máximo 200 (la Web UI usa 20 por página por defecto)
workflowIdVer solo un workflow concreto
statusFiltrar por estado de la ejecución, como COMPLETED, FAILED
serviceCanal, en minúsculas, como telegram, slack, dingtalk, feishu
directionDirección del mensaje: outgoing (texto) o outgoing_file (archivo)
searchPalabra clave; el ámbito de coincidencia es el mismo que el del cuadro de búsqueda de la página

Cada registro devuelto incluye executionId, workflowId, workflowName, executionStatus, service, direction, content, stepName, timestamp, suficiente para reconstruir en un sistema externo «qué paso de qué workflow, cuándo y a qué canal envió qué».

Páginas relacionadas