askReview
متداز این متد برای درخواست از کاربر جهت ثبت یا ویرایش نظر دربارهٔ بازو استفاده می‌شود. با فراخوانی آن، در کلاینت بله فرمی اختصاصی به کاربر نمایش داده می‌شود تا بتواند امتیاز و توضیحات خود را ثبت کند.
در صورت اجرای موفق، مقدار True برگردانده می‌شود.
این قابلیت از آبان ۱۴۰۴ در نسخه‌های جدید کلاینت‌های بله در دسترس است و در نسخه‌های قدیمی فعال نیست. در صورتی که کاربر از نسخه‌ای استفاده کند که از این ویژگی پشتیبانی نمی‌کند، فرم رضایت‌سنجی نمایش داده نخواهد شد.
این متد در کتابخانه‌های استاندارد ربات‌های تلگرام وجود ندارد. برای استفاده از آن، باید مستقیماً یک درخواست HTTP به سرور ارسال کنید (توضیحات بیشتر در بخش ایجاد درخواست).
نکات
بهترین زمان برای فراخوانی این متد، بلافاصله پس از انجام موفق یک عملیات یا ارائهٔ خدمتی مفید به کاربر است.
ارسال فرم رضایت‌سنجی به‌معنای نمایش قطعی آن به کاربر نیست؛ سرور ممکن است با توجه به شرایط کاربر، محدودیت‌هایی اعمال کند و فرم را به کاربر نشان ندهد. اما نیازی به بررسی دستی و مشخص کردن محدودیت از سوی توسعه‌دهنده برای ارسال آن نیست.
فرم رضایت‌سنجی فقط زمانی به کاربر نمایش داده می‌شود که در صفحهٔ بازو یا مینی‌اپ بازوی شما حضور داشته باشد.
برای دریافت بازخوردهای دقیق‌تر، پیشنهاد می‌شود فرم رضایت‌سنجی را برای کاربرانی ارسال کنید که پیش‌تر از خدمات بازوی شما استفاده کرده‌اند، و از ارسال آن برای کاربران جدید خودداری کنید.
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| user_id | Integer | الزامی | شناسهٔ یکتای کاربری که فرم رضایت‌سنجی برای او نمایش داده می‌شود. |
| delay_seconds | Integer | الزامی | تأخیر به ثانیه از زمان فراخوانی متد تا نمایش فرم رضایت‌سنجی |