一句话结论:MPChat Bot 是一个由你的后端通过 Bot API 控制的 MPChat 账号。它可以向已有会话发消息、接收用户与群事件、打开 MiniApp——但不能凭空主动发起会话,且部分 Telegram 风格的方法当前尚未提供。
总览
本文帮你在写代码前建立心智模型。Bot 使用一个保密的 bot token,在统一且可预测的路径上调用 Bot API:
https://call.mp.net/bot/bot{MPCHAT_BOT_TOKEN}/{methodName}API 同时支持上方 URL token 方式,以及不在 API 路径中携带 token、改用 Authorization: Bearer <token> 的方式;同时提供时 Bearer 优先。推荐请求格式见鉴权指南。不要在前端代码、公开截图或日志中暴露 token。
Bot 能做什么
向 Bot 已有上下文的会话发送文本与媒体消息。
通过轮询或 Webhook 接收用户/群的事件(Update)。
读取会话与成员信息,管理消息(编辑/置顶/转发/复制/撤回),管理命令菜单。
从消息按钮打开 MiniApp,并让后端验证签名后的用户身份。
数据流
所有接入都是同一个双向循环:
入站:用户消息 → Update → 你的
getUpdates轮询或 Webhook 处理器。出站:解析
chat_id→sendMessage带reply_markup(内联按钮:url/web_app/callback_data/copy_text;或底部 Reply Keyboard)。也可用setChatMenuButton配置左侧菜单按钮。
支持哪些能力
在方法矩阵中可按官方十个分类查阅方法,包括 Bot Profile、Bot Menu 和 MediaUpload。
当前暂不支持
Bot 不能主动发起会话。必须用户/会话先建立上下文,Bot 才能回复。
部分方法返回 HTTP 501(当前为
sendChatAction、sendLocation、sendPoll)。不支持 file_id 复用——媒体请用公网 URL 或 multipart 上传。
MiniApp 客户端回流能力受限(没有
web_app_data/sendData/answerWebAppQuery)。消息按钮的 callback(callback_query→answerCallbackQuery)是另一条已支持的链路。
下一步去哪
首次接入时,先阅读BotFather 指南并准备测试 token。
按需要选择 首次调试:手机测试与 Windows/macOS 操作,或使用 curl 与 Node.js 快速接入。
规划接入时,可以参考Bot 场景。
如果你要使用已有 Bot,请看机器人与 MiniApp 用户指南。
相关文章
支持的方法集合与 MP 差异可能变化。参数级权威来源始终是 core.mp.net/bots。
