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 端点：

https://api.telegram.org/bot<TOKEN>/METHOD_NAME

获取 Bot Token：

1. 与 @BotFather 对话
2. 发送 /newbot
3. 按提示设置名称
4. 获取 token

第一个 Bot (Python)：

import requests

BOT_TOKEN = "your_bot_token_here"
API_URL = f"https://api.telegram.org/bot{BOT_TOKEN}"

# 发送消息
def send_message(chat_id, text):
    url = f"{API_URL}/sendMessage"
    data = {"chat_id": chat_id, "text": text}
    return requests.post(url, json=data)

# 获取更新（长轮询）
def get_updates(offset=None):
    url = f"{API_URL}/getUpdates"
    params = {"offset": offset, "timeout": 30}
    return requests.get(url, params=params).json()

# 主循环
offset = None
while True:
    updates = get_updates(offset)
    for update in updates.get("result", []):
        chat_id = update["message"]["chat"]["id"]
        text = update["message"]["text"]
        
        # 回复消息
        send_message(chat_id, f"你说了：{text}")
        
        offset = update["update_id"] + 1

核心 API 方法

更新管理：

• getUpdates - 长轮询获取更新
• setWebhook - 设置 Webhook
• deleteWebhook - 删除 Webhook
• getWebhookInfo - 查询 Webhook 状态

消息操作：

• sendMessage - 发送文本消息
• sendPhoto / sendVideo / sendDocument - 发送媒体
• sendAudio / sendVoice - 发送音频
• sendLocation / sendVenue - 发送位置
• editMessageText - 编辑消息
• deleteMessage - 删除消息
• forwardMessage / copyMessage - 转发/复制消息