Agent skill · software engineering · aiskillstore

telegram-dev

Telegram 生态开发全栈指南 - 涵盖 Bot API、Mini Apps (Web Apps)、MTProto 客户端开发。包括消息处理、支付、内联模式、Webhook、认证、存储、传感器 API 等完整开发资源。

Why this skill is useful

Provides domain-specific knowledge on Telegram API usage, including Bot API and Mini Apps development patterns that the AI wouldn't reliably generate on its own.

What it needs

Requires telegram account access. About 6k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.

What this skill does

Telegram 生态开发技能 全面的 Telegram 开发指南,涵盖 Bot 开发、Mini Apps (Web Apps)、客户端开发的完整技术栈。 何时使用此技能 当需要以下帮助时使用此技能: 开发 Telegram Bot(消息机器人) 创建 Telegram Mini Apps(小程序) 构建自定义 Telegram 客户端 集成 Telegram 支付和业务功能 实现 Webhook 和长轮询 使用 Telegram 认证和存储 处理消息、媒体和文件 实现内联模式和键盘 Telegram 开发生态概览 三大核心 API 1. Bot API - 创建机器人程序 HTTP 接口,简单易用 自动处理加密和通信 适合:聊天机器人、自动化工具 2. Mini Apps API (Web Apps) - 创建 Web 应用 JavaScript 接口 在 Telegram 内运行 适合:小程序、游戏、电商 3. Telegram API & TDLib - 创建客户端 完整的 Telegram 协议实现 支持所有平台 适合:自定义客户端、企业应用 Bot API 开发 快速开始 API 端点: 获取 Bot Token: 1. 与 @BotFather 对话 2. 发送 /newbot 3. 按提示设置名称 4. 获取 token 第一个 Bot (Python): 核心 API 方法 更新管理: getUpdates - 长轮询获取更新 setWebhook - 设置 Webhook deleteWebhook - 删除 Webhook getWebhookInfo - 查询 Webhook 状态 消息操作: sendMessage - 发送文本消息 sendPhoto / sendVideo / sendDocument - 发送媒体 sendAudio / sendVoice - 发送音频 sendLocation / sendVenue - 发送位置 editMessageText - 编辑消息 deleteMessage - 删除消息 forwardMessage / copyMessage - 转发/复制消息 交互元素: sendPoll - 发送投票(最多 12 个选项) 内联键盘 (InlineKeyboardMarkup) 回复键盘 (ReplyKeyboardMarkup) answerCallbackQuery - 响应回调查询 文件操作: getFile - 获取文件信息 downloadFile - 下载文件 支持最大 2GB 文件(本地 Bot API 模式) 支付功能: sendInvoice - 发送发票 answerPreCheckoutQuery - 处理支付 Telegram Stars 支付(最高 10,000 Stars) Webhook 配置 设置 Webhook: Flask Webhook 示例: Webhook 要求: 必须使用 HTTPS 支持 TLS 1.2+ 端口:443, 80, 88, 8443 公共可访问的 URL 内联键盘 创建内联键盘: 处理回调: 内联模式 配置内联模式: 与 @BotFather 对话,发送 /setinline 处理内联查询: Mini Apps (Web Apps) 开发 初始化 Mini App HTML 模板: Mini App 核心 API WebApp 对象主要属性: 主要方法: UI 控件 主按钮 (MainButton): 次要按钮 (SecondaryButton): 返回按钮 (BackButton): 触觉反馈: 存储 API 云存储: 本地存储: 生物识别认证 位置和传感器 获取位置: 加速度计: 陀螺仪: 设备方向: 支付集成 发起支付 (Telegram Stars): 数据验证 服务器端验证 initData (Python): 启动 Mini App 从键盘按钮: 从内联按钮: 从菜单按钮: 与 @BotFather 对话: 客户端开发 (TDLib) 使用 TDLib Python 示例 (python-telegram): MTProto 协议 特点: 端到端加密 高性能 支持所有 Telegram 功能 需要 API ID/Hash(从 https://my.telegram.org 获取) 最佳实践 Bot 开发 1. 错误处理 2. 速率限制 群组消息:最多 20 条/分钟 私聊消息:最多 30 条/秒 全局限制:避免过于频繁 3. 使用 Webhook 而非长轮询 更高效 更低延迟 更好的可扩展性 4. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills aiskillstore/telegram-dev

View the source on GitHub

Browse the @skills marketplace