Update
نوع دادهاین شیء یک آپدیت (به‌روزرسانی) دریافتی را نشان می‌دهد.
در هر آپدیت حداکثر یکی از فیلدهای اختیاری وجود دارد.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| update_id | Integer | شناسهٔ یکتای آپدیت. شناسه‌های آپدیت از یک عدد صحیح مثبت شروع می‌شوند و به‌ترتیب افزایش می‌یابند. اگر از وب‌هوک استفاده می‌کنید این شناسه به‌خصوص کاربردی است، چون به شما اجازه می‌دهد آپدیت‌های تکراری را نادیده بگیرید یا اگر آپدیت‌ها با ترتیب به‌هم‌ریخته رسیدند، ترتیب درست را بازیابی کنید. اگر دست‌کم یک هفته آپدیت جدیدی نباشد، شناسهٔ آپدیت بعدی به‌جای ترتیبی، تصادفی انتخاب می‌شود. |
| message | Message | اختیاری. پیام جدید ورودی از هر نوع: متن، عکس، استیکر و غیره. |
| edited_message | Message | اختیاری. نسخهٔ جدید پیامی که برای ربات شناخته‌شده است و ویرایش شده. گاهی این آپدیت ممکن است با تغییر فیلدهایی از پیام ایجاد شود که برای ربات شما در دسترس نیستند یا استفاده نمی‌شوند. |
| channel_post | Message | اختیاری. پست جدید ورودی کانال از هر نوع: متن، عکس، استیکر و غیره. |
| edited_channel_post | Message | اختیاری. نسخهٔ جدید پستی در کانال که برای ربات شناخته‌شده است و ویرایش شده. گاهی این آپدیت ممکن است با تغییر فیلدهایی از پیام ایجاد شود که برای ربات شما در دسترس نیستند یا استفاده نمی‌شوند. |
| business_connection | BusinessConnection | اختیاری. ربات به یک حساب کسب‌وکار وصل یا از آن جدا شد، یا کاربری اتصال موجود با ربات را ویرایش کرد. |
| business_message | Message | اختیاری. پیام جدید از یک حساب کسب‌وکار متصل |
| edited_business_message | Message | اختیاری. نسخهٔ جدید یک پیام از حساب کسب‌وکار متصل |
| deleted_business_messages | BusinessMessagesDeleted | اختیاری. پیام‌هایی از حساب کسب‌وکار متصل حذف شدند. |
| guest_message | Message | اختیاری. پیام مهمان جدید. ربات می‌تواند برای ارسال پاسخ از فیلد Message.guest_query_id و متد answerGuestQuery استفاده کند. |
| message_reaction | MessageReactionUpdated | اختیاری. کاربری واکنش (reaction) یک پیام را تغییر داده است. ربات باید در گفتگو ادمین باشد و برای دریافت این آپدیت‌ها باید «message_reaction» را صراحتاً در فهرست allowed_updates بنویسد. برای واکنش‌هایی که ربات‌ها ثبت می‌کنند این آپدیت دریافت نمی‌شود. |
| message_reaction_count | MessageReactionCountUpdated | اختیاری. واکنش‌های یک پیام با واکنش‌های ناشناس تغییر کرده‌اند. ربات باید در گفتگو ادمین باشد و برای دریافت این آپدیت‌ها باید «message_reaction_count» را صراحتاً در فهرست allowed_updates بنویسد. این آپدیت‌ها گروه‌بندی می‌شوند و ممکن است تا چند دقیقه با تأخیر ارسال شوند. |
| inline_query | InlineQuery | اختیاری. درخواست اینلاین (inline query) جدید |
| chosen_inline_result | ChosenInlineResult | اختیاری. نتیجهٔ یک درخواست اینلاین که کاربر آن را انتخاب کرده و برای مخاطب گفتگوی خود فرستاده است. برای جزئیات فعال‌کردن این آپدیت‌ها برای ربات، مستندات ما دربارهٔ جمع‌آوری بازخورد را ببینید. |
| callback_query | CallbackQuery | اختیاری. callback query جدید |
| shipping_query | ShippingQuery | اختیاری. درخواست shipping جدید. فقط برای صورتحساب‌هایی که قیمت انعطاف‌پذیر دارند. |
| pre_checkout_query | PreCheckoutQuery | اختیاری. درخواست pre-checkout جدید. شامل اطلاعات کامل پرداخت است. |
| purchased_paid_media | PaidMediaPurchased | اختیاری. کاربری رسانهٔ پولی (paid media) را خریده است که ربات آن را با payload غیرخالی در یک گفتگوی غیرکانال فرستاده بود. |
| poll | Poll | اختیاری. وضعیت جدید نظرسنجی. ربات‌ها فقط آپدیت نظرسنجی‌هایی را دریافت می‌کنند که به‌صورت دستی متوقف شده‌اند یا خود ربات فرستاده است. |
| poll_answer | PollAnswer | اختیاری. کاربری پاسخ خود را در یک نظرسنجی غیرناشناس تغییر داده است. ربات‌ها فقط رأی‌های جدید نظرسنجی‌هایی را دریافت می‌کنند که خود ربات فرستاده است. |
| my_chat_member | ChatMemberUpdated | اختیاری. وضعیت عضویت ربات در یک گفتگو تغییر کرده است. در گفتگوهای خصوصی، این آپدیت فقط وقتی دریافت می‌شود که کاربر ربات را مسدود یا از مسدودی خارج کند. |
| chat_member | ChatMemberUpdated | اختیاری. وضعیت عضویت یکی از اعضا در یک گفتگو تغییر کرده است. ربات باید در گفتگو ادمین باشد و برای دریافت این آپدیت‌ها باید «chat_member» را صراحتاً در فهرست allowed_updates بنویسد. |
| chat_join_request | ChatJoinRequest | اختیاری. درخواست پیوستن به گفتگو ارسال شده است. ربات برای دریافت این آپدیت‌ها باید در گفتگو دسترسی ادمین can_invite_users را داشته باشد. |
| chat_boost | ChatBoostUpdated | اختیاری. یک بوست (boost) به گفتگو اضافه یا تغییر داده شده است. ربات برای دریافت این آپدیت‌ها باید در گفتگو ادمین باشد. |
| removed_chat_boost | ChatBoostRemoved | اختیاری. یک بوست از گفتگو برداشته شده است. ربات برای دریافت این آپدیت‌ها باید در گفتگو ادمین باشد. |
| managed_bot | ManagedBotUpdated | اختیاری. رباتی جدید برای مدیریت‌شدن توسط ربات ساخته شد، یا توکن یا مالک یک ربات مدیریت‌شده تغییر کرد. |
| subscription | BotSubscriptionUpdated | اختیاری. اشتراک پرداخت کاربر تغییر کرده است. |
| stopped_message_generation | MessageGenerationStopped | اختیاری. کاربر از ربات خواسته است تولید یک پیام را متوقف کند. |