answerCallbackQuery
متداز این متد برای پاسخ دادن به یک Callback Query که از طریق دکمههای اینلاین ارسال شده، استفاده میشود. این متد به بازو امکان میدهد بازخوردی سریع (مانند پیام هشدار یا تایید) به کاربر نمایش دهد.
با توجه به اینکه این قابلیت از خرداد ۱۴۰۴ به کلاینتهای بله افزوده شده و در نسخههای قدیمی در دسترس نیست، برای بررسی پشتیبانی این ویژگی در کلاینت کاربر، فیلد callback_query_id را بررسی کنید؛ اگر مقدار این فیلد با 1 آغاز شود، بهمعنای استفادهی کاربر از نسخهای قدیمی و عدم پشتیبانی از این قابلیت است. در چنین شرایطی میتوانید اطلاعات موردنظر را از طریق روشهای جایگزین، مانند ارسال پیام، به کاربر نمایش دهید.
در صورت اجرای موفق، مقدار True برگردانده میشود.
نکته: پس از فشردهشدن یک دکمهٔ اینلاین توسط کاربر، دکمه وارد حالت انتظار و تا زمان فراخوانی متد answerCallbackQuery در این حالت باقی میماند. بنابراین، لازم است این متد را حتی در صورتی که نیازی به نمایش پیامی به کاربر ندارید (بدون استفاده از پارامترهای اختیاری)، فراخوانی کنید.
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| callback_query_id | String | الزامی | شناسهٔ یکتای callback query که باید به آن پاسخ داده شود. |
| text | String | اختیاری | متن اعلانی که به کاربر نمایش داده میشود. در صورت خالی بودن، چیزی به کاربر نمایش داده نمیشود و صرفاً دکمه اینلاین از حالت انتظار خارج میشود. بین ۰ تا ۲۰۰ کاراکتر |
| show_alert | Boolean | اختیاری | اگر True باشد، پیام بهصورت هشدار (Alert) نمایش داده میشود. در غیر این صورت، بهصورت یک اعلان در بالای صفحه نمایش داده میشود. |