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）

对照今天已上线的 Bot API，看能做出什么产品：命令、消息按钮、菜单按钮、底部键盘、MiniApp、六个可落地场景，以及仍关闭的能力边界。

用 MPChat Bot 能做出什么：典型场景、实现模式与边界

说明如何通过 BotFather 以及 setMyDescription / getMyDescription、setMyShortDescription / getMyShortDescription 等 API 配置简介、欢迎语、短简介与欢迎图，并覆盖用户名规则与 /start 保留指令。

BotFather 指南：简介、欢迎语、欢迎图与用户名规则

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）

介绍如何关闭链接预览、用 sendPhoto/sendVideo/sendAnimation 配 caption 做图文混排，以及 entities 的 text_mention、parse_mode Markdown/HTML 超链接，还有自动识别 @、URL 与指令的规则。

富消息：链接预览、文本实体与图文混排

汇总 Bot 可通过 getChat / getChatAdministrators / getChatMember / getChatMemberCount 读取的群与成员信息，以及在管理权限下删除或撤回普通成员消息的边界，并区分 deleteMessage 与 recallMessage，说明常见 403/400 错误预期。

Bot 可获取的群信息与管理动作

核心概念、鉴权与请求模型、响应信封与错误码，以及用轮询 vs Webhook 接收更新。

2. 接入基础

按分类速查的 MPChat Bot API 方法索引，含支持状态、风险分级（L0-L3）、MP 差异，以及哪些高危方法属 DocOnly。

API 方法矩阵：分类、风险分级与 DocOnly 方法

getMe、getUpdates、sendMessage 的参数级详解，含 reply_markup 内联按钮、底部键盘与 MiniApp 入口。

核心消息方法详解：getMe、getUpdates、sendMessage（reply_markup）

用 setChatMenuButton 配置左侧菜单：commands / web_app / default；全局与私聊作用域；HTTPS≤2048 且不要求本 Bot 已登记 MiniApp。

聊天菜单按钮：setChatMenuButton（commands、web_app、default）

经 reply_markup 下发 ReplyKeyboardMarkup；普通按钮产生 message.text；is_persistent / 一次隐藏 / 移除；selective、Privacy Mode 与仅私聊 web_app。

底部自定义键盘：下发、切换、一次隐藏与移除

讲解 sendMessage 的 reply_markup 四类内联按钮：url、web_app、callback_data 与 copy_text，并说明排版上限（每行 8 / 共 100 / 文案 64）、每按钮 style 颜色，以及客户端按类型自动展示的右侧图标。

内联键盘按钮：url、web_app、callback_data 与 copy_text

说明如何用 answerCallbackQuery 回应 callback_query（固定 300 秒；text≤200、show_alert；不支持 url/cache_time），再可选 editMessageReplyMarkup 或 editMessageText 原地更新气泡。

回调按钮与消息原地更新（answerCallbackQuery）

完整 41 端点方法矩阵与风险分级，以及核心 getMe / getUpdates / sendMessage 的参数级详解。

3. API 方法参考

MPChat MiniApp 是什么，以及标识如何配合：miniapp_id 与 shortName 区别、entryUrl、botUsername、直达链接与 ?startapp= → start_param。

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、错误码）

介绍用 BotFather 的 /newapp 与 /myapps 创建和管理 MiniApp：HTTPS URL、shortName、直链 https://mp.net/{botUsername}/{shortName}，以及可选 ?startapp= 深链与下架注意点。

用 /newapp 与 /myapps 创建和管理 MiniApp

MiniApp 标识与直达链接、用前端 SDK 打开 MiniApp，以及在后端验签 initData。

4. MiniApp 接入

MPChat Bot API 与常见 Telegram 预期的关键行为差异：不支持 file_id 复用、banChatMember 为禁言、Bot 不能主动发起会话、消息 callback 已支持、MiniApp 客户端回流仍关闭、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. 上线与排错

未找到工单或对话

尝试选择不同的创建日期范围。

您通过 Messenger 发起的工单和对话将在此处显示。

您没有创建任何工单或对话

尝试使用不同的关键字或检查拼写错误。

尝试选择不同的更新日期范围。

尝试使用不同的关键字或筛选条件。

查找答案并从 Intercom 支持和社区专家那里获得帮助

您通过 Messenger 发起的对话将在此处显示。

没有您创建的对话

未找到对话

AI 标题

标题

本网站使用 Cookie 和其他技术。我们与第三方供应商利用这些技术来监控并记录您的个人信息及您与本网站的互动（包括浏览的内容、光标移动、屏幕录制和聊天内容），其目的已在我们的 Cookie 政策中加以说明。继续访问我们的网站，即表示您同意我们的{websiteTermsLink}、{privacyPolicyLink}和{cookiePolicyLink}。

本网站使用运行所绝对必要的 Cookie 和类似技术（下称“Cookie”）。我们和我们的合作伙伴还希望设置更多的 Cookie，以实现网站性能分析、功能性、广告和社交媒体功能。请参阅我们的{cookiePolicyLink}以了解详细信息。您可以在 Cookie 设置中更改 Cookie 偏好设置。

我们使用 Cookie 让网站正常运行，同时也用于分析及广告目的。您可以视需要启用或禁用可选 Cookie。请参阅我们的{cookiePolicyLink}以了解更多详细信息。

广告 Cookie 由我们的广告合作伙伴设置，用于收集您在不同时间、不同浏览器和设备上使用本网站、我们的通信和其他在线服务的信息。他们使用这些信息向您展示他们认为您会感兴趣的在线广告，并衡量广告效果。社交媒体 Cookie 由社交媒体平台设置，使您能够在这些平台上分享内容，并能够跟踪您在其他在线服务中的活动信息，使用方式如其隐私政策所述。

这些 Cookie 使网站能够提供更完善的功能和个性化体验。它们可能由我们设置，也可能由我们在页面中添加其服务的第三方提供商设置。如果您不允许使用这些 Cookie，则部分或全部服务可能无法正常运行。

这些 Cookie 是网站运行所必需，并且无法在我们的系统中关闭。

我们通过这些 Cookie 统计访问次数和流量来源，以便我们可以衡量并改进我们网站的性能。它们使我们了解哪些页面最受欢迎，哪些页面最不受欢迎，并能观察访客在网站上的移动路径。

您有权选择不出售您的个人信息。请参阅我们的{cookiePolicyLink}，以了解更多关于我们如何使用您数据的详细信息。

您的隐私选择

我们使用 Cookie 来提升用户体验。您可以在下方自定义 Cookie 偏好设置。请参阅我们的{cookiePolicyLink}以了解更多详细信息。

Cookie 设置

空的帮助中心

哎哟。该页面不存在。

主页

搜索结果

失望

表情平淡

面带微笑

正在思考……

正在搜索来源...

分析中...

通过 Messenger 或由对话中的支持代理提交的工单将显示在此处。

您没有创建任何工单

未找到工单

{topic} 中的对话和工单

{topic} // {subtopic} 中的对话和工单

贵公司的支持量、创作者和主题。

洞察

主要创作者

AI 主题

跟踪与贵公司相关的所有工单和对话的进度。

客户门户。

跟踪与贵公司相关的所有工单的进度。

工单门户。

{assigneeName} 很快就会处理此问题

{assigneeName} 需要您提供更多信息

工单

无法访问工单门户

搜索

跳过搜索。请描述您想做什么，以获得可靠的答案。

创建您的工作区并邀请与您共事的人员。

设置您的帐户

构建第一个工作流，并观察其从头到尾的运行情况。

发布功能

连接团队已在使用的工具，将数据导入。

连接您的堆栈

快速浏览一下产品，以便了解各项内容所在的位置。

在 60 秒内完成 {appName}

此原型演示知道您正在阅读“{title}”。它可以跳转回当前文章，但生产文章感知 Fin 合同仍是跟进工作。

原型文章感知答案

由于您已经询问过邀请相关内容，此原型演示可以补充跟进：在发送每个邀请之前，使用角色选择器将访问权限限制为相应的队友职责。

原型角色限制跟进

此原型演示建议从您的工作区个人资料开始，邀请需要访问权限的团队成员，然后连接您使用的集成。

原型开始使用答案

在此原型演示中，集成通过工作区设置进行配置。选择集成，连接帐户，并查看已启用的权限。

原型集成答案

在此原型演示中，请先在工作区设置中邀请队友，然后在发送邀请之前选择每位队友所需的访问权限。

原型邀请团队答案

此原型演示目前尚未为该问题提供预设答案。请尝试询问如何邀请您的团队或打开源文章。未调用生产环境的 Fin API。

原型答案不可用

我已打开此页面。向我询问有关它的任何问题，我会根据文档作答。