sendVideoNote

دسته‌بندی: رسانه · Bot API 10.3 · مستندات رسمی

پیام ویدیویی (ویدیوی دایره‌ای) ارسال می‌کند.

مقدار بازگشتی: در صورت موفقیت، Message برمی‌گرداند.

پارامترها

پارامتر	نوع	الزامی	توضیحات
`business_connection_id`	`String`	اختیاری	شناسه اتصال تجاری
`chat_id`	`Integer or String`	بله	شناسه چت یا @username
`message_thread_id`	`Integer`	اختیاری	شناسه تاپیک انجمن
`direct_messages_topic_id`	`Integer`	اختیاری	شناسه تاپیک پیام‌های مستقیم (Bot API 10.0)
`ephemeral_message_parameters`	`EphemeralMessageParameters`	اختیاری	آبجکت JSON از نوع EphemeralMessageParameters — پیام موقتی که فقط برای یک کاربر نمایش داده می‌شود (Bot API 10.3)
`video_note`	`InputFile or String`	بله	پیام ویدیویی (URL یا file_id)
`duration`	`Integer`	اختیاری	مدت به ثانیه
`length`	`Integer`	اختیاری	عرض و ارتفاع (قطر دایره)
`thumbnail`	`InputFile or String`	اختیاری	تصویر بندانگشتی (URL یا file_id)
`disable_notification`	`Boolean`	اختیاری	ارسال بی‌صدا
`protect_content`	`Boolean`	اختیاری	محافظت از محتوا
`allow_paid_broadcast`	`Boolean`	اختیاری	اجازه ارسال انبوه پولی
`message_effect_id`	`String`	اختیاری	شناسه افکت پیام
`suggested_post_parameters`	`SuggestedPostParameters`	اختیاری	آبجکت JSON از نوع SuggestedPostParameters
`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/sendVideoNote" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":123456789,"video_note":"FILE_ID"}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/sendVideoNote",
    json={
        "chat_id": 123456789,
        "video_note": "FILE_ID"
    },
    timeout=30,
)
print(resp.json())

JavaScript

const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendVideoNote`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "chat_id": 123456789,
    "video_note": "FILE_ID"
  }),
});
console.log(await res.json());

راهنمای گام‌به‌گام: ساخت ربات تلگرام: آموزش قدم‌به‌قدم از BotFather تا اولین پیام با Python

sendPhotoعکس ارسال می‌کند.
sendVideoویدیو ارسال می‌کند.
sendDocumentفایل ارسال می‌کند.
sendAudioفایل صوتی ارسال می‌کند.
sendAnimationانیمیشن (GIF) ارسال می‌کند.
sendStickerاستیکر ارسال می‌کند.
sendVoiceپیام صوتی ارسال می‌کند.
sendMediaGroupگروهی از رسانه‌ها (آلبوم) ارسال می‌کند.
sendPaidMediaرسانه پولی ارسال می‌کند (Bot API 8.0+).
sendDiceتاس ارسال می‌کند.
sendLivePhotoعکس زنده ارسال می‌کند (عکس + ویدیو، Bot API 10.0).