Tarjetas y botones de bots

Lo que publica un webhook, un comando con barra o una cuenta de bot no tiene por qué ser texto plano. Puede ser una tarjeta, un mensaje estructurado que captas de un vistazo, con botones debajo.

Tarjetas

Una tarjeta puede tener:

• un borde de color: azul (el predeterminado), verde, rojo, naranja, amarillo o morado
• un título (opcionalmente con enlace), un subtítulo y una descripción en markdown
• campos: filas de etiqueta y valor que los miembros copian con un toque
• imágenes: una sola imagen o una galería
• un indicador de carga: una ruleta con tu propio texto, como “Pensando…”, que cambias por el resultado cuando esté listo

La respuesta a un comando con barra puede mostrar más: una pastilla de estado como Open, Merged o Passing, una insignia en la cabecera, líneas añadidas y eliminadas, y el razonamiento plegado tras un interruptor. Una tarjeta publicada con un webhook no incluye nada de eso, y su cabecera siempre muestra el nombre del propio webhook.

Piensa en pull requests, despliegues y tickets de soporte: claros de un vistazo en lugar de un muro de texto.

Botones

Los botones van bajo la tarjeta. Su type decide qué hace una pulsación:

• url:{url} abre un enlace.
• webhook_action ejecuta los pasos que guardaste con el botón: actualizar la tarjeta, eliminarla, añadir una reacción o publicar una respuesta. Se ejecutan en el servidor de mssgs y todos en el canal ven el resultado, así que “Aprobar” o “Abrir la puerta” no necesitan un servidor propio.
• trigger:{guid} lanza uno de los triggers de tu comunidad con los datos del botón, como si alguien hubiera escrito el comando. La respuesta llega como una tarjeta nueva.

Enterarte de lo que pasa

Una publicación de webhook con botones recibe un stream_url de vuelta, y cada petición de un comando con barra lleva uno: un flujo en directo de las pulsaciones, reacciones y respuestas a ese mensaje. Se mantiene abierto 10 minutos (una hora si lo pides, en las publicaciones de webhook) y no guarda nada para después, así que conéctate enseguida. Para cambiar el mensaje más tarde, usa su callback_url, que funciona durante 30 minutos. Una cuenta de bot se entera de lo que pasa con sus tarjetas a través del servidor MCP.

Cada campo de la tarjeta, con un generador de tarjetas en directo, está en tarjetas de mensaje. Los pasos de los botones, los eventos y los errores están en botones, y el flujo y la URL de callback, en actualizaciones en directo.