一句話結論: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_id→sendMessage(可選帶reply_markup.web_app按鈕開啟 MiniApp)。
支援哪些能力
Bot API 暴露 41 個端點、7 個分類:Core、Message、Management、Group、Bot Commands、Webhook、User。參數級權威清單見官方方法參考;本幫助中心涵蓋核心接入鏈路與一份可速查的方法矩陣。
目前暫不支援
Bot 不能主動發起會話。必須用戶/會話先建立上下文,Bot 才能回覆。
部分方法回傳 HTTP 501(目前為
sendChatAction、sendLocation、sendPoll)。不支援 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。
