telegram-dev

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 - 轉發/複製訊息

互動元素：

• sendPoll - 傳送投票（最多 12 個選項）
• 內聯鍵盤 (InlineKeyboardMarkup)
• 回覆鍵盤 (ReplyKeyboardMarkup)
• answerCallbackQuery - 響應回撥查詢