跳至主要內容

MPChat Bot 是什麼?能力、資料流與邊界

在開始開發前理解 MPChat Bot 是什麼、訊息如何收發、Bot API 支援哪些分類,以及目前階段的能力邊界與限制。

一句話結論:MPChat Bot 是一個由你的後端透過 Bot API 控制的 MPChat 帳號。它可以向既有會話發訊息、接收用戶與群事件、開啟 MiniApp——但不能憑空主動發起會話,且部分 Telegram 風格的方法目前尚未提供。


總覽

本文幫你在寫程式前建立心智模型。Bot 使用一個保密的 bot token,在統一且可預測的路徑上呼叫 Bot API:

https://call.mp.net/bot/bot{MPCHAT_BOT_TOKEN}/{methodName}

真實 token 只出現在 bot{token} 這段路徑裡,絕不放進 Header、前端程式、日誌或截圖。

Bot 能做什麼

  • 向 Bot 已有上下文的會話傳送文字與媒體訊息。

  • 透過輪詢或 Webhook 接收用戶/群的事件(Update)。

  • 讀取會話與成員資訊,管理訊息(編輯/置頂/轉發/複製/撤回),管理指令選單。

  • 從訊息按鈕開啟 MiniApp,並讓後端驗證簽名後的用戶身分。

資料流

所有接入都是同一個雙向迴圈:

  • 入站:用戶訊息 → Update → 你的 getUpdates 輪詢或 Webhook 處理器。

  • 出站:解析 chat_idsendMessage(可選帶 reply_markup.web_app 按鈕開啟 MiniApp)。

支援哪些能力

Bot API 暴露 41 個端點、7 個分類:Core、Message、Management、Group、Bot Commands、Webhook、User。參數級權威清單見官方方法參考;本幫助中心涵蓋核心接入鏈路與一份可速查的方法矩陣。

目前暫不支援

  • Bot 不能主動發起會話。必須用戶/會話先建立上下文,Bot 才能回覆。

  • 部分方法回傳 HTTP 501(目前為 sendChatActionsendLocationsendPoll)。

  • 不支援 file_id 複用——媒體請用公網 URL 或 multipart 上傳。

  • MiniApp 用戶端回流能力受限(目前階段沒有 web_app_data / sendData / answerWebAppQuery)。

下一步去哪

  • 非開發者:在 Windows 或 iOS 上 10 分鐘試跑一個 Bot(見「10 分鐘跑通一個 Bot」)。

  • 開發者:直接看 curl + Node.js 快速接入。

  • 然後閱讀「接入基礎」(概念、鑑權、錯誤、輪詢 vs Webhook)。

相關文章

支援的方法集合與 MP 差異可能變化。參數級權威來源始終是 core.mp.net/bots

是否回答了您的問題?