MCP Telegram
← 返回 Quickstart

傳送檔案與語音到 Telegram

文件、相片、語音訊息、圓形視訊訊息、相簿，甚至 stories 與新的個人檔案相片 — 任何附有位元組的內容。AI 可代您傳送，可從您一次上傳的檔案，或直接從公開的 https:// URL。

1

選擇位元組進入的方式

有兩條路徑：(1) 在 mcp-telegram.com/my/upload 一次上傳檔案，複製回傳的 uploadId，並在您的 prompt 中引用；或 (2) 給 AI 一個指向該檔案的 https:// URL — cloud 將會下載它（含 SSRF 保護，因此本機/內部位址會被封鎖）。檔案大小上限約為 50 MB。

2

傳送單一檔案或語音訊息

對 AI 說：「將此 PDF 傳給 @friend」並附上 uploadId 或 URL。AI 會呼叫 telegram-send-file。語音訊息（建議 OGG/Opus，M4A/MP3 亦可）請使用 telegram-send-voice。圓形視訊訊息請使用 telegram-send-video-note。

3

傳送 1–10 張相片或視訊的相簿

對 AI 說：「將這 5 張相片以相簿形式傳送到我的家庭聊天，並附上 caption。」AI 會呼叫 telegram-send-album。每個項目都有自己的 uploadId 或 URL 以及可選的 caption。第一個項目的 caption 會在 Telegram 中作為相簿的 caption 顯示。

4

設定新的個人檔案相片

對 AI 說：「將此設為我的 Telegram 個人檔案相片」並附上 uploadId 或 URL。AI 會呼叫 telegram-set-profile-photo。圖片與短 MP4 皆可使用。若希望在帳號為私人時仍顯示相片，請使用 fallback:true。

試試這些 prompt

"將 https://example.com/contract.pdf 的檔案傳給 @lawyer"

"用我上傳的 4 張相片做成相簿，發佈到家庭聊天並附上 caption 'Weekend trip'"

"從 uploadId abc123 設定我的新個人檔案相片"

疑難排解

URL 下載失敗並出現「address not allowed」

SSRF 防護會封鎖解析至私有、link-local、loopback 或 metadata IP 位址的 URL。請使用公開的 https:// URL，或先透過 /my/upload 上傳檔案並引用 uploadId。

檔案過大

cloud 上傳限制約為 50 MB。對於更大的檔案，請將其託管於公開伺服器並傳遞 https:// URL — Telegram 本身支援至 2 GB，cloud 限制僅在上傳步驟。

uploadId 已過期或找不到

Pending 上傳僅在 /my/upload 後短時間內保留。若您過了太久才使用，請重新上傳並使用新的 uploadId。