发送按钮并回答点击回调

在消息下放一个确认按钮，接收 callback_query 后结束客户端等待状态。

官方资料核对 2026-10-15示例代码，未进行真实接口实测

接入准备

机器人已能收发消息；轮询或 Webhook 订阅 callback_query。
回调业务中必须核对 from.id 与可操作资源，不能只信任 callback_data。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行；密钥不应放进公开网页。

TELEGRAM_BOT_TOKEN: 从 BotFather 新建机器人所得 Token；示例是假值。

export TELEGRAM_BOT_TOKEN='123456789:replace_with_bot_token'

以上 export 适用于 macOS / Linux 的终端，在同一终端内运行后续代码。Python 示例保存为 request.py 后执行 python3 request.py。

调用步骤

01
把 sendMessage body 的 chat_id 改成目标会话。
02
发送消息后由用户点击确认按钮。
03
从收到的 Update.callback_query 读取 id、from、data；验证权限后将 id 填入第二个请求。
04
立即调用 answerCallbackQuery；耗时业务另行排队，可随后更新消息。

调用 01

发送带确认按钮的消息

callback_data 是供程序识别的短值，不在其中塞入 Secret 或完整业务数据。

POSThttps://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage

请求头

Content-Type: application/json

参数说明

参数表可左右滑动，查看完整说明。

字段 / 位置	类型 / 必填	说明
`reply_markup.inline_keyboard`请求体	array[]必填	二维数组，每个内层数组是一行按钮。
`text`请求体	string必填	消息正文。
`chat_id`请求体	integer\|string必填	已授权目标聊天。
`callback_data`请求体	string必填	本例按钮类型，1–64 字节；不能同时再填 url 等另一种按钮行为。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误，业务状态还需按下方返回示例核对。

cat > request-body.json <<'JSON'
{
  "chat_id": 123456789,
  "text": "是否确认收到这条测试通知？",
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "确认收到",
          "callback_data": "ack:test_notice"
        }
      ]
    ]
  }
}
JSON

# 执行后核对返回 JSON 的业务状态；HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
  --header "Content-Type: application/json" \
  --data-binary @request-body.json

import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage")
headers = {
    "Content-Type": expand("application/json"),
}
body = {
    "chat_id": 123456789,
    "text": "是否确认收到这条测试通知？",
    "reply_markup": {
        "inline_keyboard": [
            [
                {
                    "text": "确认收到",
                    "callback_data": "ack:test_notice",
                },
            ],
        ],
    },
}
data = json.dumps(body, ensure_ascii=False).encode("utf-8")
request = urllib.request.Request(url, data=data, headers=headers, method="POST")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
if isinstance(result, dict) and "ok" in result and result["ok"] != True:
    raise SystemExit("平台返回业务错误，请结合下方排错说明检查响应")

// Node.js 22+，保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage");
const headers = Object.fromEntries(
  Object.entries({
  "Content-Type": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const body = {
  "chat_id": 123456789,
  "text": "是否确认收到这条测试通知？",
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "确认收到",
          "callback_data": "ack:test_notice"
        }
      ]
    ]
  }
};
const response = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));
if (Object.hasOwn(result, "ok") && result["ok"] !== true) {
  throw new Error('平台返回业务错误，请结合下方排错说明检查响应');
}

返回示例

按官方字段整理的节选示意，使用虚构 ID，不是实测结果。返回带 reply_markup 的 Message；点击事件另由更新通道接收。以下为结构示意，非本站实测结果。

{
  "ok": true,
  "result": {
    "message_id": 43,
    "date": 1792022400,
    "chat": {
      "id": 123456789,
      "type": "private"
    },
    "text": "是否确认收到这条测试通知？",
    "reply_markup": {
      "inline_keyboard": [
        [
          {
            "text": "确认收到",
            "callback_data": "ack:test_notice"
          }
        ]
      ]
    }
  }
}

常见错误与排查

ok=falseTelegram 拒绝请求: 读取 description 定位；Token 不正确、目标 chat 不可用及机器人被封禁需分别排查。
HTTP 429 / retry_after请求过快: 读取 parameters.retry_after，按秒等待，不立即重复请求。

调用注意

reply_markup 在 JSON 请求体中是对象，不需额外序列化为字符串。

sendMessage InlineKeyboardButton

调用 02

回答按钮回调

callback_query_id 不是 message_id，要替换成刚收到的 callback_query.id。

POSThttps://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/answerCallbackQuery

请求头

Content-Type: application/json

参数说明

参数表可左右滑动，查看完整说明。

字段 / 位置	类型 / 必填	说明
`callback_query_id`请求体	string必填	Update.callback_query.id；及时响应本次点击。
`text`请求体	string可选	提示文案，最长 200 字符；即使不展示文案也要调用此接口。
`show_alert`请求体	boolean可选	false 顶部提示，true 弹窗。
`cache_time`请求体	integer可选	客户端缓存秒数，默认 0。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误，业务状态还需按下方返回示例核对。

cat > request-body.json <<'JSON'
{
  "callback_query_id": "replace_with_current_callback_query_id",
  "text": "已收到你的确认",
  "show_alert": false
}
JSON

# 执行后核对返回 JSON 的业务状态；HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/answerCallbackQuery" \
  --header "Content-Type: application/json" \
  --data-binary @request-body.json

import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/answerCallbackQuery")
headers = {
    "Content-Type": expand("application/json"),
}
body = {
    "callback_query_id": "replace_with_current_callback_query_id",
    "text": "已收到你的确认",
    "show_alert": False,
}
data = json.dumps(body, ensure_ascii=False).encode("utf-8")
request = urllib.request.Request(url, data=data, headers=headers, method="POST")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
if isinstance(result, dict) and "ok" in result and result["ok"] != True:
    raise SystemExit("平台返回业务错误，请结合下方排错说明检查响应")

// Node.js 22+，保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/answerCallbackQuery");
const headers = Object.fromEntries(
  Object.entries({
  "Content-Type": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const body = {
  "callback_query_id": "replace_with_current_callback_query_id",
  "text": "已收到你的确认",
  "show_alert": false
};
const response = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));
if (Object.hasOwn(result, "ok") && result["ok"] !== true) {
  throw new Error('平台返回业务错误，请结合下方排错说明检查响应');
}

返回示例

按官方字段整理的节选示意，使用虚构 ID，不是实测结果。成功结果是布尔 true。以下为结构示意，非本站实测结果。

{
  "ok": true,
  "result": true
}

常见错误与排查

ok=falseTelegram 拒绝请求: 读取 description 定位；Token 不正确、目标 chat 不可用及机器人被封禁需分别排查。
HTTP 429 / retry_after请求过快: 读取 parameters.retry_after，按秒等待，不立即重复请求。

调用注意

回答回调仅结束等待/显示提示，不会自动修改原消息，也不能代表业务已经持久化成功。

answerCallbackQuery

注意事项

先校验用户和业务状态再执行有副作用动作，并对重复 callback 做去重。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码，覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

01
InlineKeyboardButton核验日期 2026-10-15
02
answerCallbackQuery核验日期 2026-10-15
03
sendMessage核验日期 2026-10-15

Telegram 机器人的其他调用手册

验证机器人并发送文本用长轮询接收消息和事件

← 返回Telegram 机器人的全部功能