sendWidget
Gửi tin nhắn có widget HTML (Bot API 10.4).
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ả |
|---|---|---|---|
chat_id | Integer or String | Có | ID chat hoặc @username |
message_thread_id | Integer | Tùy chọn | ID chủ đề diễn đàn |
html | String | Có | Mã HTML của widget: 1-32768 byte, tối đa 4096 byte sau khi nén zlib |
width | Integer | Tùy chọn | Chiều rộng widget tính bằng pixel logic (bỏ qua để rộng bằng tin nhắn) |
height | Integer | Tùy chọn | Chiều cao widget tính bằng pixel logic, 50-600 (bỏ qua để vừa nội dung) |
public_data | String | Tùy chọn | Trạng thái công khai của widget (public_data), 0-1024 byte — hiển thị ở mọi nơi widget xuất hiện |
chat_data | String | Tùy chọn | Trạng thái của widget trong chat này (chat_data), 0-1024 byte |
caption | String | Tùy chọn | Chú thích (0-1024) |
parse_mode | String | Tùy chọn | HTML, Markdown, MarkdownV2 |
caption_entities | Array of MessageEntity | Tùy chọn | Mảng JSON MessageEntity cho chú thích |
show_caption_above_media | Boolean | Tùy chọn | Hiển thị chú thích phía trên widget |
allow_queries | Boolean | Tùy chọn | Cho phép widget gửi truy vấn đến bot (widget_query) |
is_shared | Boolean | Tùy chọn | Tạo widget dùng chung — có thể gửi lại bằng sendSharedWidget |
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í |
message_effect_id | String | Tùy chọn | ID hiệu ứng tin nhắn |
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/sendWidget" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendWidget",
json={
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendWidget`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
}),
});
console.log(await res.json());
Hướng dẫn từng bước: Widget Telegram: HTML tương tác ngay trong tin nhắn của bot
Phương thức liên quan
sendSharedWidgetGửi lại widget dùng chung do bot tạo (Bot API 10.4).answerWidgetQueryTrả lời truy vấn từ widget (Bot API 10.4).editMessageWidgetDataChỉnh sửa dữ liệu của widget trong tin nhắn (Bot API 10.4).editSharedWidgetDataChỉnh sửa dữ liệu công khai của widget dùng chung (Bot API 10.4).