一句话结论: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。
