copyMessage
متداز این متد برای کپی پیام‌هایی از هر نوع استفاده کنید. پیام‌های سرویسی، پیام‌های رسانهٔ پولی، قرعه‌کشی، برندگان قرعه‌کشی و صورتحساب قابل کپی نیستند. نظرسنجی آزمون (quiz) فقط وقتی قابل کپی است که مقدار فیلد correct_option_ids برای ربات شناخته‌شده باشد. این متد شبیه forwardMessage است، اما پیام کپی‌شده پیوندی به پیام اصلی ندارد. در صورت موفقیت، MessageId پیام ارسال‌شده را برمی‌گرداند.
خروجی: MessageId
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| chat_id | Integer or String | الزامی | شناسهٔ یکتای گفتگوی هدف یا نام‌کاربری ربات، ابرگروه یا کانال هدف با قالب @username |
| message_thread_id | Integer | اختیاری | شناسهٔ یکتای رشتهٔ پیام (تاپیک) فروم هدف؛ فقط برای ابرگروه‌های فروم و گفتگوهای خصوصی ربات‌هایی که حالت تاپیک فروم برایشان فعال است. |
| direct_messages_topic_id | Integer | اختیاری | شناسهٔ تاپیک پیام مستقیم که پیام به آن فرستاده می‌شود؛ اگر پیام به یک گفتگوی پیام مستقیم فرستاده شود الزامی است. |
| from_chat_id | Integer or String | الزامی | شناسهٔ یکتای گفتگویی که پیام اصلی در آن فرستاده شده است (یا نام‌کاربری ربات، ابرگروه یا کانال هدف با قالب @username) |
| message_id | Integer | الزامی | شناسهٔ پیام در گفتگوی مشخص‌شده در from_chat_id |
| video_start_timestamp | Integer | اختیاری | زمان شروع جدید ویدیوی کپی‌شده در پیام (برچسب زمانی) |
| caption | String | اختیاری | عنوان (caption) جدید رسانه؛ ۰ تا ۱۰۲۴ نویسه پس از تجزیهٔ موجودیت‌ها. اگر مشخص نشود، عنوان اصلی نگه داشته می‌شود. |
| parse_mode | String | اختیاری | حالت تجزیهٔ موجودیت‌ها در عنوان جدید. جزئیات بیشتر را در گزینه‌های قالب‌بندی ببینید. |
| caption_entities | Array of MessageEntity | اختیاری | فهرست JSON از موجودیت‌های ویژه‌ای که در عنوان جدید آمده‌اند و می‌توان آن را به‌جای parse_mode داد. |
| show_caption_above_media | Boolean | اختیاری | اگر عنوان باید بالای رسانهٔ پیام نمایش داده شود، True بدهید. اگر عنوان جدیدی مشخص نشده باشد نادیده گرفته می‌شود. |
| disable_notification | Boolean | اختیاری | پیام را بی‌صدا می‌فرستد. کاربران اعلانی بدون صدا دریافت می‌کنند. |
| protect_content | Boolean | اختیاری | محتوای پیام ارسالی را از فوروارد و ذخیره‌شدن محافظت می‌کند. |
| allow_paid_broadcast | Boolean | اختیاری | برای مجاز شدن ارسال تا ۱۰۰۰ پیام در ثانیه و نادیده‌گرفتن محدودیت‌های ارسال انبوه، با هزینهٔ ۰٫۱ ستارهٔ تلگرام برای هر پیام، True بدهید. ستارهٔ مربوط از موجودی ربات کسر می‌شود. |
| message_effect_id | String | اختیاری | شناسهٔ یکتای افکتی که به پیام اضافه می‌شود؛ فقط هنگام کپی به گفتگوهای خصوصی در دسترس است. |
| suggested_post_parameters | SuggestedPostParameters | اختیاری | شیء سریالایز‌شده به JSON شامل پارامترهای پست پیشنهادی که باید فرستاده شود؛ فقط برای گفتگوهای پیام مستقیم. اگر پیام در پاسخ به یک پست پیشنهادی دیگر فرستاده شود، آن پست پیشنهادی به‌طور خودکار رد می‌شود. |
| reply_parameters | ReplyParameters | اختیاری | توضیحات پیامی که به آن پاسخ داده می‌شود. |
| reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | اختیاری | گزینه‌های اضافی رابط. شیء سریالایز‌شده به JSON برای کیبورد اینلاین، کیبورد پاسخ سفارشی، دستور حذف کیبورد پاسخ یا اجبار به پاسخ از طرف کاربر. |