telegram-rich-messages

TotalClaw 作者 totalclaw

Telegram Rich UI 功能的综合指南（内联按钮、格式、媒体、反应和消息管理）。使用此技能为 Telegram 用户提供低摩擦的交互式体验，优先考虑按钮而不是打字。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~shingo0620-telegram-rich-messages

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~shingo0620-telegram-rich-messages/file -o shingo0620-telegram-rich-messages.md

# Telegram Rich Messages

This skill transforms the agent from a text-only chatbot into an interactive Telegram assistant.

## Core Principle: Low-Friction Interaction
**Typing is slow and error-prone.** Always prioritize Rich UI elements to minimize the user's need to reply with text. If a user has a choice to make, give them a button.

## Quick Navigation
Detailed guides for each feature:

1. **[decision-matrix.md](references/decision-matrix.md)**: When to use which UI element.
2. **[formatting.md](references/formatting.md)**: Markdown V2, HTML, and Auto-Copy (Monospace) tricks.
3. **[interactive-ui.md](references/interactive-ui.md)**: How to send stable Inline Buttons and Quick Replies.
4. **[media-and-actions.md](references/media-and-actions.md)**: Sending files, stickers, using reactions, and editing/deleting messages.

## Best Practices
- **Monospace for Data**: Use code blocks for IDs, addresses, or snippets. Users can tap to copy them instantly on mobile.
- **Stable Buttons**: Always use the `message` tool's `buttons` parameter instead of string directives (`[[buttons:...]]`) for 100% reliability.
- **Contextual Actions**: After completing a task, provide buttons for the most likely next steps (e.g., "Check Status", "Delete", "Settings").
- **Direct Uploads**: Telegram supports direct file uploads. No need for Google Drive or external hosting.

---

## 中文说明

# Telegram Rich Messages

此技能将代理从纯文本聊天机器人转变为交互式的 Telegram 助手。

## 核心原则：低摩擦交互
**打字缓慢且容易出错。** 始终优先使用 Rich UI 元素，以尽量减少用户回复文本的需要。如果用户需要做出选择，就给他们一个按钮。

## 快速导航
每项功能的详细指南：

1. **[decision-matrix.md](references/decision-matrix.md)**：何时使用哪种 UI 元素。
2. **[formatting.md](references/formatting.md)**：Markdown V2、HTML 以及自动复制（等宽字体）技巧。
3. **[interactive-ui.md](references/interactive-ui.md)**：如何发送稳定的内联按钮和快捷回复。
4. **[media-and-actions.md](references/media-and-actions.md)**：发送文件、贴纸、使用反应，以及编辑/删除消息。

## 最佳实践
- **数据使用等宽字体**：对 ID、地址或代码片段使用代码块。用户可以在移动端点击即可立即复制。
- **稳定的按钮**：始终使用 `message` 工具的 `buttons` 参数，而不是字符串指令（`[[buttons:...]]`），以确保 100% 的可靠性。
- **上下文相关的操作**：完成任务后，为最可能的后续步骤提供按钮（例如 "Check Status"、"Delete"、"Settings"）。
- **直接上传**：Telegram 支持直接上传文件。无需 Google Drive 或外部托管。