editEphemeralMessageText
编辑临时消息的文本 (Bot API 10.2)。
返回值: 调用成功时返回 True。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
chat_id | Integer or String | 是 | 聊天 ID 或 @username |
receiver_user_id | Integer | 是 | 收到该消息的用户 ID |
ephemeral_message_id | Integer | 是 | 临时消息 ID |
text | String | 可选 | 新文本(1-4096,未指定 rich_message 时必填) |
parse_mode | String | 可选 | HTML、Markdown 或 MarkdownV2 |
entities | Array of MessageEntity | 可选 | MessageEntity JSON 数组 |
rich_message | InputRichMessage | 可选 | InputRichMessage JSON 对象——未指定 text 时必填 (Bot API 10.3) |
link_preview_options | LinkPreviewOptions | 可选 | LinkPreviewOptions JSON 对象 |
reply_markup | InlineKeyboardMarkup | 可选 | JSON 对象:InlineKeyboardMarkup |
请求示例
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/editEphemeralMessageText" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"receiver_user_id": 123456789,
"ephemeral_message_id": 1
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/editEphemeralMessageText",
json={
"chat_id": 123456789,
"receiver_user_id": 123456789,
"ephemeral_message_id": 1
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/editEphemeralMessageText`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"receiver_user_id": 123456789,
"ephemeral_message_id": 1
}),
});
console.log(await res.json());
分步教程: Telegram 机器人教程:从零创建 Telegram 机器人并发送第一条消息
相关方法
editEphemeralMessageMedia编辑临时消息的媒体 (Bot API 10.2)。editEphemeralMessageCaption编辑临时消息的说明文字 (Bot API 10.2)。editEphemeralMessageReplyMarkup编辑临时消息的回复标记 (Bot API 10.2)。deleteEphemeralMessage删除临时消息 (Bot API 10.2)。