MCP Telegram
返回 Quickstart

在 AI 中使用 Telegram Stories

您追蹤的聯絡人與頻道所發佈的 stories、您所發佈 stories 的觀看者清單,以及發佈、釘選、編輯、刪除自己 stories 的工具 — 全部以 AI 工具形式提供。

1

從 feed 讀取 stories

對 AI 說:「顯示我關注的人所發佈的作用中 stories。」AI 會呼叫 telegram-get-all-stories,並回傳目前 feed 中每則 story 的精簡 metadata(id、日期、過期日、caption、媒體類型、計數器)。支援分頁 — 可要求載入更多舊項目。

2

查看誰看過您的 story

對 AI 說:「列出我最新 story 的觀看者。」AI 會呼叫 telegram-get-story-views,並回傳觀看者與其反應 emoji(如有)以及觀看日期,再加上觀看、轉發與反應的總數。注意:非 Premium 帳號可能不會取得完整觀看清單,而非常舊的 stories 可能已失去其觀看者資料。

3

發佈新的 story

先上傳一張圖片或短片(開啟 mcp-telegram.com/my/upload,拖入檔案,複製 uploadId),或傳遞一個 cloud 可下載的 https:// URL。然後對 AI 說:「以此 uploadId 在我的個人檔案發佈新 story。」AI 會呼叫 telegram-send-story。隱私規則(everyone / contacts / close friends)會被明確傳遞。

4

釘選精選或編輯 caption

對 AI 說:「將 story 12345 釘選到我的個人檔案。」AI 會呼叫 telegram-toggle-story-pinned(最多可釘選 3 則 stories)。若要編輯 caption:「將 story 12345 的 caption 改為 'New caption'」 — AI 會呼叫 telegram-edit-story。cloud 不支援替換媒體檔案;請改為發佈新的 story。

試試這些 prompt

"顯示聯絡人的作用中 stories,並朗讀給我聽"

"誰看過我上一則 story?依反應 emoji 分組觀看者。"

"列出我已釘選的 stories,並詢問是否要取消釘選任何一則"

疑難排解

我的 story 觀看者清單為空

兩個常見原因:(1) Telegram 僅在有限時間內保留完整觀看者清單,非常舊的 stories 可能已失去;(2) 部分帳號(非 Premium)根本不會取得完整清單。總數(viewsCount、reactionsCount)仍會回傳。

無法變更既有 story 中的媒體檔案

telegram-edit-story 可更新 caption 與隱私規則,但 cloud 明確拒絕替換媒體檔案(這會需要透過檔案系統重新上傳位元組)。請刪除舊的 story 並改為發佈新的。