پرش به مطلب اصلی

CallbackQuery

این شی نشان‌دهنده‌ی یک فراخوان برگشتی ورودی از یک دکمه در یک صفحه‌کلید inline است. اگر دکمه‌ای که مبدا درخواست است به یک پیام ارسال‌شده توسط بازو پیوست شود، فیلد message وجود خواهد داشت. اگر دکمه به یک پیام ارسال‌شده از طریق بازو پیوست شده باشد، فیلد iniline_message_id وجود خواهد داشت.

📝 اسکیمای داده

فیلدنوعتوضیحات
idstringشناسه منحصربه‌فرد این درخواست
fromUserارسال‌کننده
messageMessageاختیاری. پیامی که دکمه به آن پیوست شده است. توجه داشته باشید که برای پیام‌های خیلی قدیمی، محتوای پیام و تاریخ آن در دسترس نخواهد بود.
datastringاختیاری. داده‌های مرتبط با دکمه. توجه داشته باشید که امکان دارد پیام، هیچ دکمه‌ای با این داده‌ها نداشته باشد.

⚙️ متد‌های دریافت

getId()

شناسه منحصر به فرد برای درخواست بازگشتی را بازیابی می‌کند.

$queryId = $callbackQueryObject->getId();

getFrom()

ارسال‌کننده درخواست بازگشتی را بازیابی می‌کند که یک شیء User است.

$user = $callbackQueryObject->getFrom();

getMessage()

بررسی می‌کند که آیا درخواست بازگشتی از یک پیام ارسال‌شده توسط ربات ناشی شده است. اگر موجود باشد، شیء Message را بازیابی می‌کند.

$message = $callbackQueryObject->getMessage();

getData()

داده‌های مربوط به دکمه بازگشتی را بازیابی می‌کند که یک رشته است.

$data = $callbackQueryObject->getData();

➕ بیشتر

نکته

برای اطلاعات بیشتر، به مستندات رسمی بله مراجعه کنید.