ChatFullInfo
نوع دادهاین شیء شامل اطلاعات کامل یک گفتگو است.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| id | Integer | شناسهٔ یکتای این گفتگو. این عدد ممکن است بیش از ۳۲ بیت معنادار داشته باشد و بعضی زبان‌های برنامه‌نویسی در تفسیر آن دچار مشکل یا خطای بی‌صدا شوند؛ اما حداکثر ۵۲ بیت معنادار دارد، بنابراین عدد صحیح ۶۴ بیتی علامت‌دار یا اعشاری با دقت دوگانه برای نگهداری آن امن است. |
| type | String | نوع گفتگو؛ یکی از «private»، «group»، «supergroup» یا «channel» |
| title | String | اختیاری. عنوان، برای ابرگروه‌ها، کانال‌ها و گفتگوهای گروهی |
| username | String | اختیاری. نام‌کاربری، برای گفتگوهای خصوصی، ابرگروه‌ها و کانال‌ها در صورت وجود |
| first_name | String | اختیاری. نام کوچک طرف مقابل در یک گفتگوی خصوصی |
| last_name | String | اختیاری. نام خانوادگی طرف مقابل در یک گفتگوی خصوصی |
| is_forum | Boolean | اختیاری. True اگر ابرگروه یک فروم باشد (تاپیک‌ها فعال باشند). |
| is_direct_messages | Boolean | اختیاری. True اگر گفتگو، گفتگوی پیام‌های مستقیم (direct messages) یک کانال باشد. |
| accent_color_id | Integer | شناسهٔ رنگ تأکیدی (accent color) برای نام گفتگو و پس‌زمینهٔ عکس گفتگو، سربرگ پاسخ و پیش‌نمایش لینک. جزئیات بیشتر را در رنگ‌های تأکیدی ببینید. |
| max_reaction_count | Integer | بیشینهٔ تعداد واکنش‌هایی که می‌توان روی یک پیام در گفتگو گذاشت. |
| photo | ChatPhoto | اختیاری. عکس گفتگو |
| active_usernames | Array of String | اختیاری. اگر خالی نباشد، فهرست همهٔ نام‌های کاربری فعال گفتگو؛ برای گفتگوهای خصوصی، ابرگروه‌ها و کانال‌ها |
| birthdate | Birthdate | اختیاری. در گفتگوهای خصوصی، تاریخ تولد کاربر |
| business_intro | BusinessIntro | اختیاری. در گفتگوهای خصوصی با حساب‌های کسب‌وکار، معرفی کسب‌وکار |
| business_location | BusinessLocation | اختیاری. در گفتگوهای خصوصی با حساب‌های کسب‌وکار، موقعیت مکانی کسب‌وکار |
| business_opening_hours | BusinessOpeningHours | اختیاری. در گفتگوهای خصوصی با حساب‌های کسب‌وکار، ساعات کاری کسب‌وکار |
| personal_chat | Chat | اختیاری. در گفتگوهای خصوصی، کانال شخصی کاربر |
| parent_chat | Chat | اختیاری. اطلاعات کانال متناظر؛ فقط برای گفتگوهای پیام مستقیم |
| available_reactions | Array of ReactionType | اختیاری. فهرست واکنش‌های مجاز در گفتگو. اگر ذکر نشود، همهٔ واکنش‌های ایموجی مجاز است. |
| background_custom_emoji_id | String | اختیاری. شناسهٔ ایموجی سفارشی که گفتگو برای سربرگ پاسخ و پس‌زمینهٔ پیش‌نمایش لینک انتخاب کرده است. |
| profile_accent_color_id | Integer | اختیاری. شناسهٔ رنگ تأکیدی برای پس‌زمینهٔ پروفایل گفتگو. جزئیات بیشتر را در رنگ‌های تأکیدی پروفایل ببینید. |
| profile_background_custom_emoji_id | String | اختیاری. شناسهٔ ایموجی سفارشی که گفتگو برای پس‌زمینهٔ پروفایل خود انتخاب کرده است. |
| emoji_status_custom_emoji_id | String | اختیاری. شناسهٔ ایموجی سفارشی وضعیت ایموجی گفتگو یا طرف مقابل در گفتگوی خصوصی |
| emoji_status_expiration_date | Integer | اختیاری. تاریخ انقضای وضعیت ایموجی گفتگو یا طرف مقابل در گفتگوی خصوصی (به زمان یونیکس)، در صورت وجود |
| bio | String | اختیاری. بیوگرافی طرف مقابل در گفتگوی خصوصی |
| has_private_forwards | Boolean | اختیاری. True اگر تنظیمات حریم خصوصی طرف مقابل در گفتگوی خصوصی اجازه دهد لینک‌های tg://user?id=<user_id> فقط در گفتگو با خود آن کاربر استفاده شود. |
| has_restricted_voice_and_video_messages | Boolean | اختیاری. True اگر تنظیمات حریم خصوصی طرف مقابل، ارسال پیام صوتی و پیام ویدیویی گرد (video note) در گفتگوی خصوصی را محدود کرده باشد. |
| join_to_send_messages | Boolean | اختیاری. True اگر کاربران برای ارسال پیام باید ابتدا به ابرگروه بپیوندند. |
| join_by_request | Boolean | اختیاری. True اگر همهٔ کاربرانی که مستقیم و بدون لینک دعوت به ابرگروه می‌پیوندند باید توسط ادمین‌های ابرگروه تأیید شوند. |
| description | String | اختیاری. توضیحات، برای گروه‌ها، ابرگروه‌ها و کانال‌ها |
| invite_link | String | اختیاری. لینک دعوت اصلی، برای گروه‌ها، ابرگروه‌ها و کانال‌ها |
| pinned_message | Message | اختیاری. آخرین پیام سنجاق‌شده (بر اساس تاریخ ارسال) |
| permissions | ChatPermissions | اختیاری. دسترسی‌های پیش‌فرض اعضای گفتگو، برای گروه‌ها و ابرگروه‌ها |
| accepted_gift_types | AcceptedGiftTypes | اطلاعات انواع هدیه‌هایی که گفتگو یا (در گفتگوی خصوصی) کاربر مربوطه می‌پذیرد. |
| can_send_paid_media | Boolean | اختیاری. True اگر بتوان پیام‌های رسانهٔ پولی را به کانال فرستاد یا در آن فوروارد کرد. این فیلد فقط برای کانال‌ها در دسترس است. |
| slow_mode_delay | Integer | اختیاری. برای ابرگروه‌ها، کمترین فاصلهٔ مجاز بین پیام‌های پیاپی هر کاربر عادی (بدون دسترسی ویژه)؛ به ثانیه |
| unrestrict_boost_count | Integer | اختیاری. برای ابرگروه‌ها، کمترین تعداد بوستی که کاربر غیرادمین باید اضافه کند تا از حالت آهسته (slow mode) و محدودیت‌های دسترسی گفتگو معاف شود. |
| message_auto_delete_time | Integer | اختیاری. مدت زمانی که پس از آن همهٔ پیام‌های ارسالی به گفتگو به‌طور خودکار حذف می‌شوند؛ به ثانیه |
| has_aggressive_anti_spam_enabled | Boolean | اختیاری. True اگر بررسی‌های تهاجمی ضد اسپم در ابرگروه فعال باشد. این فیلد فقط برای ادمین‌های گفتگو در دسترس است. |
| has_hidden_members | Boolean | اختیاری. True اگر غیرادمین‌ها فقط بتوانند فهرست ربات‌ها و ادمین‌های گفتگو را ببینند. |
| has_protected_content | Boolean | اختیاری. True اگر پیام‌های گفتگو را نتوان به گفتگوهای دیگر فوروارد کرد. |
| has_visible_history | Boolean | اختیاری. True اگر اعضای جدید گفتگو به پیام‌های قدیمی دسترسی داشته باشند؛ فقط برای ادمین‌های گفتگو در دسترس است. |
| sticker_set_name | String | اختیاری. برای ابرگروه‌ها، نام بستهٔ استیکر گروه |
| can_set_sticker_set | Boolean | اختیاری. True اگر ربات بتواند بستهٔ استیکر گروه را تغییر دهد. |
| custom_emoji_sticker_set_name | String | اختیاری. برای ابرگروه‌ها، نام بستهٔ استیکر ایموجی سفارشی گروه. ایموجی‌های سفارشی این بسته را همهٔ کاربران و ربات‌های گروه می‌توانند استفاده کنند. |
| linked_chat_id | Integer | اختیاری. شناسهٔ یکتای گفتگوی مرتبط، یعنی شناسهٔ گروه بحث یک کانال و برعکس؛ برای ابرگروه‌ها و کانال‌ها. این شناسه ممکن است بیش از ۳۲ بیت باشد و بعضی زبان‌های برنامه‌نویسی در تفسیر آن دچار مشکل یا خطای بی‌صدا شوند؛ اما کمتر از ۵۲ بیت است، بنابراین عدد صحیح ۶۴ بیتی علامت‌دار یا اعشاری با دقت دوگانه برای نگهداری آن امن است. |
| location | ChatLocation | اختیاری. برای ابرگروه‌ها، موقعیت مکانی‌ای که ابرگروه به آن متصل است. |
| rating | UserRating | اختیاری. برای گفتگوهای خصوصی، امتیاز کاربر در صورت وجود |
| first_profile_audio | Audio | اختیاری. برای گفتگوهای خصوصی، نخستین فایل صوتی که به پروفایل کاربر اضافه شده است. |
| unique_gift_colors | UniqueGiftColors | اختیاری. طرح رنگ مبتنی بر یک هدیهٔ یکتا که باید برای نام گفتگو، پاسخ‌های پیام و پیش‌نمایش لینک‌ها استفاده شود. |
| paid_message_star_count | Integer | اختیاری. تعداد ستارهٔ تلگرام (Telegram Stars) که یک کاربر عادی باید برای ارسال پیام به گفتگو بپردازد. |
| guard_bot | User | اختیاری. رباتی که درخواست‌های پیوستن (join request query) را در گفتگو پردازش می‌کند. این فیلد فقط برای ادمین‌های گفتگو در دسترس است. |
| community | Community | اختیاری. جامعه (Community) که گفتگو به آن تعلق دارد. |