Telegram Design
Mensajes legibles de Telegram: formato seguro, bloques de código, paginación y acciones claras.
- Actualizado:
- Palabras:
- 426
- Descargas semanales:
- 0
- Descargas totales:
- 1
Enlaces relacionados
Telegram Design
Diseña para el chat móvil: resultado o estado primero, detalles útiles después y una acción clara. Resume las salidas extensas y ofrece el archivo cuando sea necesario conservarlas completas.
Formato y límites
- Para salida arbitraria de modelos o herramientas, usa texto plano. Si necesitas
formato, genera entidades o HTML admitido por Telegram a partir de datos escapados.
Escapa
&,<y>en texto, y también comillas en atributos; evita escapes dobles. - En MarkdownV2, escapa según el contexto: texto, enlace o código. La conversión de Markdown debe respetar esa estructura, no depender de sustituciones globales.
sendMessageadmite 4096 caracteres tras interpretar entidades. Consulta los límites del método utilizado; los pies de foto tienen límites diferentes.- Divide por unidades de contenido y aplica formato a cada fragmento. Cierra y reabre bloques de código; conserva entidades, enlaces, escapes y pares sustitutos. Los offsets de entidades se calculan en unidades UTF-16.
- Usa saltos reales y comprueba el texto copiado. Sustituye tablas anchas por pares clave/valor; emplea enlaces etiquetados, nombres de archivo breves y código monoespaciado.
Acciones y progreso
Distingue solicitud recibida, pendiente, en curso, completada y fallida según el resultado real. Actualiza un mensaje de progreso con frecuencia limitada y conserva un resumen final.
Diferencia el contenido del agente de los controles del bot. Los botones de autorización pertenecen al bot; un comando incluido en una respuesta del modelo se muestra como texto y no se procesa como una orden humana.
Mantén callback_data entre 1 y 64 bytes con un identificador opaco. Guarda la
acción y su ámbito en el servidor, sin incluir comandos, secretos o rutas privadas
en el botón. Responde con answerCallbackQuery también al cancelar o rechazar
una acción caducada.
Ante HTTP 429, respeta retry_after y utiliza una cola acotada. Un error de formato
puede resolverse con un único envío en texto plano seguro; limita los reintentos y
evita duplicar mensajes confirmados. Excluye de los logs las URLs que contienen
el token del bot.
Comprobación
Prueba caracteres reservados, emoji, URLs largas, código que supere el límite y paginación. Cada fragmento debe ser válido y conservar el contenido; cada botón debe actuar sobre el recurso mostrado. Simula formato rechazado, edición sin cambios y limitación de frecuencia. Reserva los envíos reales a un chat de pruebas autorizado.
Referencia: https://core.telegram.org/bots/api#formatting-options
Versiones (1)
| Versión | Descargas (semana) | Descargas (total) | Publicación |
|---|---|---|---|
0.1.0latest Primera versión publicada. | 0 | 1 | 14 de octubre de 2026 |