Chat
این شی نشان‌دهنده یک گفتگو است.
📝 اسکیمای داده
| فیلد | نوع | توضیحات |
|---|---|---|
id | int | شناسه یکتای چت. می‌تواند بیشتر از ۲^۳۱ باشد و برخی زبان‌های برنامه‌نویسی ممکن است در تفسیر آن با مشکل روبه‌رو شوند. اما این فیلد حداکثر ۵۲ بیت با ارزش اهمیت دارد و فرمت ۶۴ بیتی علامت‌دار عدد صحیح یا عدد اعشاری ۶۴ بیتی برای ذخیره‌سازی آن مناسب است. |
type | string | نوع گفتگو که می‌تواند یکی از موارد "private”، “group” یا “channel” باشد. |
title | string | اختیاری. عنوان گفتگو‌های داخل گروه‌ها یا کانال‌ها |
username | string | اختیاری. نام کاربری برای گفتگو‌های خصوصی یا کانال‌ها در صورت وجود |
first_name | string | اختیاری. نام کوچک طرف دیگر در یک گفتگوی خصوصی |
last_name | string | اختیاری. نام خانوادگی طرف دیگر در یک گفتگوی خصوصی |
photo | ChatPhoto | اختیاری. تصویر گفتگو. فقط از طریق getChat بدست می‌آید. |
در حالی که مستندات رسمی بله اشاره می‌کند که فیلد photo تنها توسط متد getChat باز می‌گردد، امکان دریافت فیلد photo در بروزرسانی‌های webhook نیز وجود دارد. این بدین معنی است که حتی زمانی که مستندات رسمی چیز دیگری می‌گویند، API می‌تواند در برخی رویدادها فیلد photo را بازگشت دهد.
⚙️ متد‌های دریافت
getId()
شناسه چت را بازیابی می‌کند.
$chatId = $chatObject->getId();
getType()
نوع چت را بازیابی می‌کند (مثلاً "خصوصی"، "گروه"، "کانال").
$chatType = $chatObject->getType();
getTitle()
عنوان چت را بازیابی می‌کند (اگر موجود باشد، معمولاً برای گروه‌ها و کانال‌ها).
$chatTitle = $chatObject->getTitle();
getUsername()
نام‌کاربری مرتبط با چت را بازیابی می‌کند (اگر موجود باشد، معمولاً برای چت‌های خصوصی و کانال‌ها).
$chatUsername = $chatObject->getUsername();
getFirstName()
نام طرف مقابل در چت را بازیابی می‌کند (اگر موجود باشد، معمولاً برای چت‌های خصوصی).
$userFirstName = $userObject->getFirstName();
getLastName()
نام خانوادگی طرف مقابل در چت را بازیابی می‌کند (اگر موجود باشد).
$userLastName = $userObject->getLastName();
getPhoto()
عکس چت را بازیابی می‌کند (اگر موجود باشد). این فقط برای برخی انواع چت‌ها (مانند گروه‌ها، کانال‌ها) قابل دسترسی است.
$chatPhoto = $chatObject->getPhoto();
➕ بیشتر
برای اطلاعات بیشتر، به مستندات رسمی بله مراجعه کنید.