MPChatHelps

建構 MPChat Bot 與 MiniApp：快速接入、鑑權、錯誤處理、輪詢 vs Webhook、完整方法矩陣、MiniApp initData 驗簽、MP 差異與生產上線清單。

開發者指南：Bot 與 MiniApp

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

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

無需寫專案，10 分鐘跑通第一個 mpbot：用 getMe 驗證 token、用 getUpdates 拿 chat_id、用 sendMessage 回覆，支援 Windows 與 iOS。

10 分鐘跑通一個 Bot（Windows PowerShell 或 iOS 捷徑）

用 curl 與 Node.js 搭起最小 MPChat Bot 接入：驗證 token、讀取 chat_id、傳送第一則訊息，內建 token 安全與錯誤處理。

開發者快速接入：getMe、getUpdates、sendMessage（curl + Node.js）

MPChat Bot 是什麼、如何在 Windows 或 iOS 上 10 分鐘試跑，以及用 curl 與 Node.js 的開發者快速接入。

1. 快速開始

每個 MPChat Bot 接入都要用到的術語：bot token、chat_id、Update、Message、輪詢、Webhook、MiniApp，以及資料如何收發。

MPChat Bot 的核心概念與術語

MPChat Bot 請求如何鑑權與構造：基礎 URL、token 安全五條規則、HTTP 方法、Content-Type、ID 型別規則，以及每秒 30 次限流。

鑑權與請求模型：基礎 URL、token 安全、ID 規則、限流

MPChat Bot API 所有方法共享同一回應信封。學會讀 ok/result/description、各錯誤碼含義，以及哪些錯誤該重試。

回應信封與錯誤碼：ok、result、description 與重試策略

接收 MPChat 更新的兩種互斥方式：開發用 getUpdates 長輪詢、生產用 setWebhook，含 secret_token 校驗與選型建議。

接收更新：輪詢 vs Webhook（getUpdates、setWebhook、secret_token）

核心概念、鑑權與請求模型、回應信封與錯誤碼，以及用輪詢 vs Webhook 接收更新。

2. 接入基礎

按分類速查的 MPChat Bot API 方法索引，含支援狀態、風險分級（L0-L3）、MP 差異，以及哪些高危方法屬 DocOnly。

API 方法矩陣：41 端點、7 分類、風險分級與 DocOnly 方法

每個 Bot 最先要用的三個方法的參數級詳解：getMe、getUpdates、sendMessage，含可開啟 MiniApp 的 reply_markup.web_app 按鈕。

核心訊息方法詳解：getMe、getUpdates、sendMessage（含 web_app 按鈕）

完整 41 端點方法矩陣與風險分級，以及核心 getMe / getUpdates / sendMessage 的參數級詳解。

3. API 方法參考

MPChat MiniApp 是什麼，以及各標識如何配合：miniapp_id、shortName、entryUrl、botUsername，還有固定的直達連結格式。

MiniApp 概覽與核心標識：miniapp_id、shortName、entryUrl 與直達連結

用 sendMessage 傳送 MiniApp 入口按鈕、載入 MPChat WebApp SDK，並正確讀取 initData 與 initDataUnsafe，附目前欄位支援範圍。

開啟 MiniApp 與前端 SDK（web_app 按鈕、initData vs initDataUnsafe）

MPChat MiniApp initData 的後端 HMAC-SHA256 驗簽流程，含 Node.js 範例、推薦錯誤碼、TTL，以及目前不支援的回流能力。

在後端驗簽 MiniApp initData（HMAC、TTL、錯誤碼）

MiniApp 標識與直達連結、用前端 SDK 開啟 MiniApp，以及在後端驗簽 initData。

4. MiniApp 接入

MPChat Bot API 與常見 Telegram 預期的關鍵行為差異：不支援 file_id 複用、banChatMember 為禁言、Bot 不能主動發起會話、web_app 回流受限、501 方法。

MP 與 Telegram Bot API 差異（file_id、banChatMember、會話、501）

MPChat Bot 上線前要逐項核對的清單：token 與 Webhook 安全、限流重試、日誌脫敏、高危 API 審批，以及 5 步冒煙測試。

MPChat Bot 生產上線檢查清單（安全、重試、日誌、冒煙測試）

MPChat Bot 與 MiniApp 最常見問題的快速解答：如何拿 chat_id、處理 409、file_id 複用、429 應對、initData 能否登入、哪些方法不能隨便測。

MPChat Bot 與 MiniApp 常見問題（chat_id、409、file_id、429、initData 等）

MP 與 Telegram Bot API 差異、生產上線檢查清單，以及常見問題。

5. 上線與排錯

透過 Intercom 支援和社群專家找出解答

您透過 Messenger 開始的對話會在這裡顯示。

沒有您建立的對話

請嘗試使用不同的關鍵字或檢查是否有拼字錯誤。

請嘗試使用不同的關鍵字或篩選條件。

找不到任何對話

標題

本網站使用 Cookie 及其他技術，我們與第三方合作廠商將透過這些技術監測並記錄您的個人資訊及與網站的互動行為（包含瀏覽內容、游標移動軌跡、螢幕錄影及聊天內容），相關用途詳見我們的《Cookie 政策》。繼續使用本網站即表示您同意我們的{websiteTermsLink}、{privacyPolicyLink}及{cookiePolicyLink}。

本網站使用網站運行絕對必需的 Cookie 和類似技術（以下簡稱「Cookie」）。我們與合作夥伴也希望設定額外 Cookie，以利啟用網站效能分析、功能性、廣告投放與社群媒體功能。請參閱我們的{cookiePolicyLink}瞭解詳細資訊。您可以在 Cookie 設定中變更您的偏好設定。

我們使用 Cookie 來確保網站正常運作，並用於分析與廣告用途。您可以視需要啟用或停用非必要 Cookie。請參閱我們的{cookiePolicyLink}瞭解詳情。

廣告 Cookie 由我們的廣告合作夥伴設定，用於蒐集您在不同時間、不同瀏覽器和裝置上對本網站、我們的通訊內容及其他線上服務的使用情形資訊。合作夥伴使用這些資訊，在網路上向您推送他們認為您會感興趣的廣告，並評估廣告成效。社群媒體 Cookie 則由社群媒體平台設定，用以讓您能在這些平台上分享內容，並可追蹤您在其他線上服務中的活動，相關資料的使用方式將依各平台的隱私權政策而定。

這些 Cookie 可讓網站提供更完善的功能與個人化體驗。它們可能由我們或我們在頁面中整合其服務的第三方供應商所設定。若您不允許使用這些 Cookie，則部分或全部服務可能無法正常運作。

這些 Cookie 為網站正常運作所必需，無法在我們的系統中關閉。

這些 Cookie 可讓我們統計訪問次數與流量來源，以利評估並提升網站效能。它們協助我們瞭解哪些頁面最受歡迎，哪些頁面較少人造訪，並觀察訪客在網站上的瀏覽行為。

您有權選擇不將您的個人資訊用於銷售用途。請參閱我們的{cookiePolicyLink}，以瞭解更多有關我們如何使用您資料的詳細資訊。

您的隱私權選擇

我們使用 Cookie 來提升您的使用體驗。您可以在下方自訂您的 Cookie 偏好設定。請參閱我們的{cookiePolicyLink}瞭解詳情。

Cookie 設定

空白說明中心

糟糕，該頁面不存在。

主頁

搜尋結果

失望

中性

微笑

正在思考...

正在搜尋來源資料...

分析中...

透過信使或您對話中的支援人員提交的支援申請單會出現在這裡。

沒有您建立的支援申請單

未找到支援申請單

追蹤與貴公司相關的所有支援申請單和對話的進度。

客戶入口網站。

追蹤與貴公司相關的所有支援申請單的進度。

支援申請單入口網站。

{assigneeName}正在處理此支援申請單！

{assigneeName}已處理好您的支援申請單

{assigneeName}會盡快處理您的支援申請單

{assigneeName}需要您提供更多資訊

我們會盡快處理您的支援申請單

支援申請單

無申請單入口網站存取權

搜尋與提問

尋找指南、答案和參考資料。

跳過搜尋。描述您的需求，直接獲得有根據的答案。

建立您的工作區，並邀請與您共事的人員。

設定您的帳戶

建立你的第一個工作流程，並觀察其完整執行。

開始建立內容

連接團隊正在使用的工具以匯入資訊。

連接您的工具

快速帶您瞭解產品各項功能的位置。

{appName}，60 秒快速上手

此原型示範已偵測你正在閱讀「{title}」。它可以將您導回目前文章，但正式版的文章感知功能仍在開發中。

文章感知回答（原型）

由於您詢問過邀請相關內容，此原型示範可提供後續建議：在傳送邀請前，使用角色選擇器限制團隊成員的存取權限。

角色限制後續建議（原型）

此原型示範建議先設定您的工作區個人資料，邀請需要存取權限的團隊成員，然後連接您使用的整合工具。

開始使用回答（原型）

在此原型示範中，整合功能可從工作區設定中進行設定。選擇整合項目、連接帳戶，並檢視已啟用的權限。

整合設定回答（原型）

在此原型示範中，請從工作區設定邀請團隊成員，並在傳送邀請前選擇每位成員的存取權限。

邀請團隊回答（原型）

此原型示範目前尚未提供該問題的預設答案。請嘗試詢問如何邀請團隊成員或開啟來源文章。未呼叫正式版 Fin API。

原型答案無法使用

我已開啟此頁面。可以詢問任何相關問題，我會根據文件回答。