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 | Нет | Создать общий виджет (shared widget) — его можно отправлять снова через 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Изменяет общее состояние shared-виджета (Bot API 10.4).