sendWidget
Надсилає повідомлення з HTML-віджетом (Bot API 10.4).
Повертає: У разі успіху повертає Message.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
chat_id | Integer or String | Так | ID чату або @username |
message_thread_id | Integer | Ні | ID теми форуму |
html | String | Так | HTML-код віджета: 1-32768 байтів, не більше 4096 байтів після стиснення zlib |
width | Integer | Ні | Ширина віджета в логічних пікселях (не вказуйте — на всю ширину повідомлення) |
height | Integer | Ні | Висота віджета в логічних пікселях, 50-600 (не вказуйте — за вмістом) |
public_data | String | Ні | Публічний стан віджета (public_data), 0-1024 байти — видно всюди, де показано віджет |
chat_data | String | Ні | Стан віджета в цьому чаті (chat_data), 0-1024 байти |
caption | String | Ні | Підпис (0-1024) |
parse_mode | String | Ні | HTML, Markdown, MarkdownV2 |
caption_entities | Array of MessageEntity | Ні | JSON-масив MessageEntity для підпису |
show_caption_above_media | Boolean | Ні | Показати підпис над віджетом |
allow_queries | Boolean | Ні | Дозволити віджету надсилати запити боту (widget_query) |
is_shared | Boolean | Ні | Створити спільний віджет — його можна повторно надіслати через sendSharedWidget |
disable_notification | Boolean | Ні | Надіслати без звуку |
protect_content | Boolean | Ні | Захистити вміст |
allow_paid_broadcast | Boolean | Ні | Дозволити платну розсилку |
message_effect_id | String | Ні | ID ефекту повідомлення |
reply_parameters | ReplyParameters | Ні | JSON-об’єкт ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | Ні | JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
Приклад запиту
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());
Покроковий посібник: Віджети Telegram: інтерактивний HTML просто в повідомленнях бота
Схожі методи
sendSharedWidgetПовторно надсилає спільний віджет, створений ботом (Bot API 10.4).answerWidgetQueryВідповідає на запит від віджета (Bot API 10.4).editMessageWidgetDataРедагує дані віджета в повідомленні (Bot API 10.4).editSharedWidgetDataРедагує публічні дані спільного віджета (Bot API 10.4).