sendRichMessage
Gửi tin nhắn rich với định dạng có cấu trúc (Bot API 10.1).
Giá trị trả về: Nếu thành công, trả về Message.
Tham số
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
business_connection_id | String | Tùy chọn | ID kết nối doanh nghiệp |
chat_id | Integer or String | Có | ID chat hoặc @username |
message_thread_id | Integer | Tùy chọn | ID chủ đề diễn đàn |
direct_messages_topic_id | Integer | Tùy chọn | ID chủ đề tin nhắn trực tiếp (Bot API 10.0) |
ephemeral_message_parameters | EphemeralMessageParameters | Tùy chọn | Đối tượng JSON EphemeralMessageParameters — tin nhắn tạm thời chỉ hiển thị với một người dùng (Bot API 10.3) |
rich_message | InputRichMessage | Có | Đối tượng JSON InputRichMessage — nội dung tin nhắn rich |
disable_notification | Boolean | Tùy chọn | Gửi không âm thanh |
protect_content | Boolean | Tùy chọn | Bảo vệ nội dung |
allow_paid_broadcast | Boolean | Tùy chọn | Cho phép gửi hàng loạt trả phí (0.1 Stars/tin nhắn) |
message_effect_id | String | Tùy chọn | ID hiệu ứng tin nhắn |
suggested_post_parameters | SuggestedPostParameters | Tùy chọn | Đối tượng JSON SuggestedPostParameters (cho kênh) |
reply_parameters | ReplyParameters | Tùy chọn | Đối tượng JSON ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | Tùy chọn | JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
Ví dụ request
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendRichMessage" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"rich_message": {
"markdown": "**Hello** from a rich message"
}
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendRichMessage",
json={
"chat_id": 123456789,
"rich_message": {
"markdown": "**Hello** from a rich message"
}
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendRichMessage`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"rich_message": {
"markdown": "**Hello** from a rich message"
}
}),
});
console.log(await res.json());
Hướng dẫn từng bước: Cách tạo bot Telegram từ A đến Z: BotFather, token và tin nhắn đầu tiên
Phương thức liên quan
sendRichMessageDraftStream tin nhắn rich từng phần — bản xem trước trong 30 giây (Bot API 10.1).