sendMessageDraft
发送消息草稿——临时预览 (Bot API 9.5+)。
返回值: 调用成功时返回 True。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
chat_id | Integer | 是 | 私聊 ID |
message_thread_id | Integer | 可选 | 话题 ID(用于论坛) |
draft_id | Integer | 是 | 唯一草稿 ID(非零) |
text | String | 可选 | 草稿文本(0-4096,留空 = "Thinking...") |
parse_mode | String | 可选 | HTML、Markdown 或 MarkdownV2 |
entities | Array of MessageEntity | 可选 | MessageEntity JSON 数组 |
can_stop | Boolean | 可选 | 显示停止后续草稿的按钮 (Bot API 10.3) |
keep_on_stop | Boolean | 可选 | 按下停止按钮时将草稿保留在聊天中 (Bot API 10.3) |
请求示例
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendMessageDraft" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"draft_id":1}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendMessageDraft",
json={
"chat_id": 123456789,
"draft_id": 1
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendMessageDraft`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"draft_id": 1
}),
});
console.log(await res.json());
分步教程: Telegram 机器人教程:从零创建 Telegram 机器人并发送第一条消息
相关方法
sendMessage发送文本消息。forwardMessage转发一条消息。forwardMessages转发多条消息。copyMessage复制一条消息(不带转发来源)。copyMessages复制多条消息。deleteMessage删除一条消息。deleteMessages删除多条消息。sendChatAction发送聊天动作(typing 等)。sendContact发送联系人。sendLocation发送位置。sendVenue发送地点。setMessageReaction为消息设置回应。