跳转到主要内容

核心消息方法详解:getMe、getUpdates、sendMessage(含 web_app 按钮)

每个 Bot 最先要用的三个方法的参数级详解:getMe、getUpdates、sendMessage,含可打开 MiniApp 的 reply_markup.web_app 按钮。

这三个方法承载了大多数 MPChat Bot 早期接入。其余方法遵循同一信封;字段见方法矩阵与官方参考。


总览

getMe 验证身份,getUpdates 拿 chat_id,sendMessage 发送。sendMessage 属 MP 差异:支持 web_app 按钮,但不支持完整回流。

getMe

GET 或 POST,无 body。适合做健康检查,无副作用。

curl -s "https://call.mp.net/bot/bot${MPCHAT_BOT_TOKEN}/getMe"

{ "ok": true, "result": { "id": 123456789, "is_bot": true, "username": "my_mpbot" } }

401 表示 token 无效或已 revoke。

getUpdates

请求体字段:offsetlimit(1-100)、timeout(0-50)、allowed_updates

{ "offset": 0, "limit": 50, "timeout": 30, "allowed_updates": ["message"] }

{
  "ok": true,
  "result": [{
    "update_id": 10001,
    "message": { "message_id": 42, "chat": { "id": 987654321, "type": "private" }, "text": "你好" }
  }]
}

空的 result: [] 表示没有新消息或该批已被消费;409 表示已启用 Webhook。

sendMessage

字段

必填

说明

chat_id

整数或十进制字符串。

text

消息正文。

parse_mode

Markdown 或 HTML。

reply_to_message_id

回复指定消息。

reply_markup

内联键盘;web_app 类型可打开 MiniApp。

web_app 按钮示例

{
  "chat_id": "987654321",
  "text": "Open Demo MiniApp",
  "reply_markup": {
    "inline_keyboard": [
      [{ "text": "Open", "web_app": { "url": "https://mini.example.com/demo" } }]
    ]
  }
}

服务端用 web_app.url 解析当前 Bot 的 MiniApp;无需传 miniapp_id。完整 web_app_data / sendData / answerWebAppQuery 回流当前不支持。

相关文章

保存返回的 message_id 供后续 editMessageText 使用。deleteMessage 为 L3 DocOnly。

这是否解答了您的问题?