Message
نوع دادهاین شی نشان‌دهنده یک پیام است.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| message_id | Integer | شناسه منحصربه‌فرد پیام در داخل این گفتگو |
| from | User | اختیاری. کاربر ارسال‌کننده‌ی پیام. برای پیام‌هایی که در کانال ارسال می‌شوند، مقدار آن خالی است. |
| date | Integer | تاریخی که پیام ارسال شده است (در قالب زمان یونیکس) |
| chat | Chat | اطلاعات گفتگویی که پیام به آن تعلق دارد. |
| sender_chat | Chat | اختیاری. زمانی مقداردهی می‌شود که پیام از طرف یک گفتگو ارسال شده و فرستندهٔ واقعی برای کاربران پنهان باشد (مانند پیام‌های کانال)؛ در این حالت برای حفظ سازگاری، فیلد from دارای یک مقدار ساختگی است. |
| forward_from | User | اختیاری. برای پیام‌های باز ارسال شده که ارسال‌کننده‌ی پیام اصلی را نشان می‌دهد |
| forward_from_chat | Chat | اختیاری. برای پیام های باز ارسال شده که اطلاعات مربوط به گفتگوی اصلی پیام را نشان می‌دهد و در کانال‌ها, از طرف مدیران ناشناس است |
| forward_from_message_id | Integer | اختیاری. شناسه پیام اصلی در کانال، برای پیام‌های باز ارسال شده از کانال‌ها |
| forward_date | Integer | اختیاری. برای پیام های باز ارسال شده , تاریخی که پیام اصلی در آن زمان ارسال شده است (در قالب زمان یونیکس) |
| reply_to_message | Message | اختیاری. پیامی که این پیام در پاسخ به آن ارسال شده است. توجه داشته باشید که در شیء Message قرارگرفته در این فیلد، مقدار reply_to_message دوباره مقداردهی نخواهد شد. |
| edit_date | Integer | اختیاری. تاریخ آخرین باری که پیام ویرایش شده است (در قالب زمان یونیکس) |
| media_group_id | String | اختیاری. شناسه یکتایی برای پیام آلبومی که این پیام به آن تعلق دارد. |
| text | String | اختیاری. متن واقعی پیام با فرمت UTF-8 برای پیام‌های متنی |
| entities | Array of MessageEntity | اختیاری. برای پیام‌های متنی، بخش‌های خاصی از متن پیام مانند نام کاربری یا دستور بازو. |
| animation | Animation | اختیاری برای پیام‌های که تصویر متحرک دارند این فیلد پر می شود و اطلاعاتی در مورد انیمیشن می‌دهد. برای سازگاری عقب‌رو، زمانی که این فیلد تنظیم شود، فیلد document نیز تنظیم خواهد شد. |
| audio | Audio | اختیاریبرای پیام‌هایی که به صورت فایل صوتی هستند این فیلد با اطلاعات فایل مقدار دهی می شود. |
| document | Document | اختیاری. برای پیام‌هایی که به صورت فایل عمومی هستند، اطلاعاتی در مورد فایل می‌دهد. |
| photo | Array of PhotoSize | اختیاری. برای پیام‌هایی که به صورت تصویر هستند، اندازه‌های موجود برای تصویر را می‌دهد. |
| sticker | Sticker | اختیاری. برای پیام‌هایی که به صورت استیکر هستند، اطلاعاتی در مورد استیکر می‌دهد. |
| video | Video | اختیاری. برای پیام‌هایی که به صورت ویدیو هستند، اطلاعاتی در مورد ویدیو می‌دهد. |
| voice | Voice | اختیاری. برای پیام‌های صوتی، اطلاعاتی در مورد فایل می‌دهد. |
| caption | String | اختیاری. توضیحات مربوط به انیمیشن، فایل صوتی، سند، تصویر، ویدیو یا پیام صوتی |
| caption_entities | Array of MessageEntity | اختیاری. برای پیام‌های دارای زیرنویس، بخش‌های خاصی از متن آن مانند نام کاربری یا دستور بازو. |
| contact | Contact | اختیاری. در صورتی که پیام یک مخاطب به اشتراک‌گذاشته‌شده باشد، اطلاعاتی در مورد مخاطب می‌دهد. |
| location | Location | اختیاری. اگر پیام یک موقعیت به اشتراک‌گذاشته‌شده باشد، اطلاعاتی در مورد این موقعیت می‌دهد. |
| new_chat_members | Array of User | اختیاری.اطلاعاتی در مورد اعضای جدیدی که به گروه اضافه شده‌اند می دهد (خود بازو می‌تواند یکی از این اعضا باشد) |
| left_chat_member | User | اختیاری. عضوی که از گروه حذف یا خارج شده است و اطلاعاتی در مورد آن (این عضو می‌تواند خود بازو باشد) |
| invoice | Invoice | اختیاری. در صورتی که پیام از نوع درخواست پول یا جمع‌سپاری باشد، اطلاعاتی در مورد آن می‌دهد. |
| successful_payment | SuccessfulPayment | اختیاری. رسید یک پرداخت موفق که اطلاعاتی در مورد پرداخت می‌دهد. |
| web_app_data | WebAppData | اختیاری. یک پیام سرویس حاوی داده ارسالی از مینی‌اپ است. |
| reply_markup | InlineKeyboardButton | اختیاری. صفحه‌کلید inline که به یک پیام پیوست شده است. |