sendLivePhoto

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

عکس زنده ارسال می‌کند (عکس + ویدیو، Bot API 10.0).

مقدار بازگشتی: در صورت موفقیت، 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)
`live_photo`	`InputFile or String`	بله	ویدیوی عکس زنده (URL/file_id، حداکثر 10 ثانیه و 10 MB)
`photo`	`InputFile or String`	بله	عکس ثابت (URL/file_id)
`caption`	`String`	اختیاری	کپشن (0-1024)
`parse_mode`	`String`	اختیاری	HTML، Markdown یا MarkdownV2
`caption_entities`	`Array of MessageEntity`	اختیاری	آرایه JSON از نوع MessageEntity برای کپشن
`show_caption_above_media`	`Boolean`	اختیاری	نمایش کپشن بالای رسانه
`has_spoiler`	`Boolean`	اختیاری	پنهان کردن محتوا (اسپویلر)
`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/sendLivePhoto" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": 123456789,
  "live_photo": {},
  "photo": "https://telegram.org/img/t_logo.png"
}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/sendLivePhoto",
    json={
        "chat_id": 123456789,
        "live_photo": {},
        "photo": "https://telegram.org/img/t_logo.png"
    },
    timeout=30,
)
print(resp.json())

JavaScript

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

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

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