验证机器人并发送文本

验证 Bot Token，然后向已经主动联系机器人的用户发一条文本。

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

接入准备

通过 BotFather 的 /newbot 创建机器人并保存 Token。
测试用户先打开机器人并发送 /start；私聊中通常不能向未主动联系或未授权的用户直接发消息。

准备环境变量

示例值需要替换为自己的凭证或资源 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
把 Bot Token 放入 TELEGRAM_BOT_TOKEN，运行 getMe 确认身份。
02
按长轮询场景取得 Update，从 message.chat.id 取得 chat_id，替换 sendMessage body。
03
运行发送消息，检查 ok=true 与 result.message_id；机器人账号不能用来操作普通个人账号。

调用 01

验证 Bot Token

不需要其他参数，返回当前机器人的 User 对象。

GEThttps://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/getMe

参数说明

本接口无额外业务参数；按上方要求提供凭证。

调用代码

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

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

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}/getMe")
headers = {

}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method="GET")
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}/getMe");
const headers = Object.fromEntries(
  Object.entries({}).map(([key, value]) => [key, expand(value)])
);
const response = await fetch(url, {
  method: "GET",
  headers,
  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，不是实测结果。确认 result.is_bot=true、username 为目标机器人。以下为结构示意，非本站实测结果。

{
  "ok": true,
  "result": {
    "id": 123456789,
    "is_bot": true,
    "first_name": "示例通知机器人",
    "username": "example_notification_bot"
  }
}

常见错误与排查

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

调用注意

Bot Token 包含冒号，不要在日志公开整个 URL；如泄露在 BotFather 中重置。

getMe

调用 02

发送一条文本

示例 chat_id 是虚构值，执行前替换为你已获授权会话的真实 ID。

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

请求头

Content-Type: application/json

参数说明

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

字段 / 位置	类型 / 必填	说明
`chat_id`请求体	integer\|string必填	从收到的 Update.message.chat.id 获取；频道或超级群也可用 @username，但机器人需有对应发言权限。
`text`请求体	string必填	文本长度 1–4096 个字符，按实体解析后的内容计算。
`disable_notification`请求体	boolean可选	true 为静默推送，仍会产生消息。
`parse_mode`请求体	string可选	可选 HTML 或 MarkdownV2 等；本例省略以免未转义内容报错。

调用代码

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

cat > request-body.json <<'JSON'
{
  "chat_id": 123456789,
  "text": "接入测试：通知服务已启动",
  "disable_notification": true
}
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": "接入测试：通知服务已启动",
    "disable_notification": True,
}
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": "接入测试：通知服务已启动",
  "disable_notification": true
};
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，不是实测结果。返回 Message 对象，保留 message_id 和 chat.id。以下为结构示意，非本站实测结果。

{
  "ok": true,
  "result": {
    "message_id": 42,
    "date": 1792022400,
    "chat": {
      "id": 123456789,
      "type": "private"
    },
    "text": "接入测试：通知服务已启动"
  }
}

常见错误与排查

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

调用注意

普通广播约 30 条/秒；同一聊天避免超过每秒 1 条，群约 20 条/分钟。按 429 和 retry_after 动态退避。
没有开启 allow_paid_broadcast；本例不消耗付费加速广播的 Stars。

sendMessage Bot FAQ：频率和会话限制

注意事项

用户屏蔽机器人后无法继续发送；消息发送成功不等于用户已读。

核验来源

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

01
Bots: introduction for developers核验日期 2026-10-15
02
Bot FAQ：频率和会话限制核验日期 2026-10-15
03
getMe核验日期 2026-10-15
04
sendMessage核验日期 2026-10-15

Telegram 机器人的其他调用手册

用长轮询接收消息和事件发送按钮并回答点击回调

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