sendWidget
پیامی حاوی ویجت HTML ارسال میکند (Bot API 10.4).
مقدار بازگشتی: در صورت موفقیت، Message برمیگرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
chat_id | Integer or String | بله | شناسه چت یا @username |
message_thread_id | Integer | اختیاری | شناسه تاپیک انجمن |
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 | اختیاری | شناسه افکت پیام |
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());
راهنمای گامبهگام: ویجت تلگرام چیست؟ HTML تعاملی داخل پیامهای ربات
متدهای مرتبط
sendSharedWidgetویجت اشتراکی ساختهشده توسط ربات را دوباره ارسال میکند (Bot API 10.4).answerWidgetQueryبه کوئری ویجت پاسخ میدهد (Bot API 10.4).editMessageWidgetDataدادههای ویجت در پیام را ویرایش میکند (Bot API 10.4).editSharedWidgetDataدادههای عمومی ویجت اشتراکی را ویرایش میکند (Bot API 10.4).