متغیرها چیست؟
متغیر یک کد کوچک داخل علامت { } است که در «ویرایش ربات» بهجای متن ثابت مینویسید؛
وقتی ربات پاسخ را میفرستد، بهجای خودِ متغیر، مقدار واقعی جایگزین میشود یا یک عمل خاص انجام میشود.
بعضی متغیرها فقط در متن پاسخ کار میکنند و بعضی دیگر فقط در دکمهها — همانطور که پایینتر برای هرکدام نوشته شده.
🎲 Lucky_Number — عدد تصادفی
یک عدد تصادفی بین دو عدد دلخواه تولید میکند. فقط در «متن پاسخ» کار میکند؛ اگر آن را در متن یا callback_data یک دکمه بگذارید هیچ اتفاقی نمیافتد و همانطور که نوشتهاید عیناً باقی میماند.
فرمت: {Lucky_Number,شروع,پایان}
مثال: نوشتن {Lucky_Number,1,100} در متن پاسخ، یک عدد تصادفی بین ۱ تا ۱۰۰ میفرستد.
🕒 time — ساعت فعلی
ساعت فعلی (به وقت ایران) را در پاسخ مینویسد. فقط در «متن پاسخ» کار میکند.
فرمت: {time}
مثال: نوشتن زمان : {time} در متن پاسخ، چیزی شبیه «زمان : ۱۴:۰۸» میفرستد.
👥 users — تعداد کل کاربران ربات
تعداد کل کسانی که تا الان ربات شما را استارت کردهاند. کاربران از همان اولین پیام ذخیره میشوند، پس حتی اگر این متغیر را بعداً اضافه کنید، عدد درست و کامل نمایش داده میشود. فقط در «متن پاسخ» کار میکند.
فرمت: {users}
مثال: نوشتن تعداد کل کاربران : {users} در متن پاسخ، چیزی شبیه «تعداد کل کاربران : ۱۲۸» میفرستد.
🔗 Link — دکمهی لینکدار
دکمه را به یک لینک تبدیل میکند؛ کاربر با زدن آن دکمه به همان آدرس هدایت میشود. فقط برای دکمهی شیشهای (Inline) کار میکند — آن را در کادر callback_data همان دکمه بنویسید (بهجای پر کردن کادر URL).
فرمت: {Link/آدرس}
مثال: {Link/sorosaz.ir}
↩️ back — بازگشت به پاسخ قبلی
وقتی این را روی یک دکمهی شیشهای بگذارید، با کلیک کاربر روی آن دکمه، همان پاسخِ قبلی که برایش ارسال شده بود دوباره فرستاده میشود (یعنی یک قدم در مسیر گفتگو به عقب برمیگردد). این را هم در کادر callback_data دکمه بنویسید.
فرمت: {back}
🏠 home — بازگشت به منوی اصلی
وقتی این را روی یک دکمهی شیشهای بگذارید، با کلیک کاربر روی آن دکمه، همان پاسخِ دستور /start دوباره برایش فرستاده میشود —
یعنی کاربر از هر جای گفتگو به منوی ابتدایی ربات برمیگردد. این را هم در کادر callback_data دکمه بنویسید.
فرمت: {home}
نکته: back و home و Link مخصوص دکمهی شیشهای (Inline) هستند و روی دکمهی زیر کیبورد (Reply) اثری ندارند،
چون آن دکمهها callback_data ندارند و کلیک روی آنها فقط متن روی دکمه را بهعنوان یک پیام عادی میفرستد.