# RateBot (`ratebot.ir`) — راهنمای مختصر برای مدل‌های زبانی

## خلاصه یک‌خطی

**RateBot** یک سامانه اشتراکی (SaaS) فارسی است که قیمت ارزی کالا در **کانال/گروه تلگرام و بله** را بر اساس نرخ لحظه‌ای به **تومان** تبدیل می‌کند و همان پست را به‌صورت خودکار یا با دکمه زیر پست به‌روز می‌کند.

- وب‌سایت: [https://ratebot.ir](https://ratebot.ir)
- زبان رابط: فارسی، راست‌به‌چپ
- منبع نرخ ارز کاربران: [24tala.ir](https://24tala.ir) (توکن API **رایگان**؛ هر مشتری توکن **خودش** را می‌گیرد)

---

## مخاطب

مدیران کانال و گروه که کالا را با درهم، دلار، یورو و سایر ارزها قیمت‌گذاری می‌کنند و می‌خواهند معادل تومانی همیشه به‌روز باشد.

---

## پیام‌رسان‌های پشتیبانی‌شده

| پلتفرم | وضعیت |
|--------|--------|
| **تلگرام** | اتصال مستقل ربات + کانال/گروه |
| **بله** | اتصال مستقل ربات + کانال/گروه |

تنظیمات، وب‌هوک، گزارش ادمین، آمار محصولات و منوی ربات برای تلگرام و بله **از هم جدا** هستند.

---

## قابلیت‌های اصلی

1. تشخیص قیمت ارزی در متن یا کپشن پست (اعداد فارسی و انگلیسی)
2. نوشتن/به‌روزرسانی خط «معادل تومان (قیمت لحظه‌ای)»
3. به‌روزرسانی دوره‌ای خودکار (بازه قابل تنظیم توسط مدیر سامانه)
4. محدودیت تعداد پست‌های آپدیت خودکار (مثلاً N پست آخر) برای فشار کمتر به سرور
5. دکمه «آپدیت قیمت لحظه‌ای» زیر پست‌ها
6. تگ‌ها و مثال‌ها:
   - `۳۵ درهم` یا `#dirham ۳۵`
   - `۱۰۰ دلار` / `#dollar 25` / `#euro ۴۰`
   - `[price-dirham] ۳۵` یا `[price-CAD] 20`
   - چند قیمت در یک پست + `#sub` در انتها برای نمایش جمع
7. ربات اختصاصی هر مشتری (یک ربات تلگرام و یک ربات بله در فاز فعلی)
8. سقف پیش‌فرض مجموع **۲** کانال/گروه (تلگرام + بله با هم؛ قابل افزایش توسط مدیر)
9. اشتراک سالانه (پیش‌فرض حدود ۳۶۵ روز + روز هدیه قابل تنظیم)
10. پرداخت آفلاین (کارت/شبا) و در صورت فعال‌سازی، درگاه زرین‌پال
11. برنامه معرفی دوستان / ریفرال (در صورت فعال بودن توسط مدیر)
12. پنل کاربر: داشبورد، ربات، کانال، محصولات، نرخ ارز، نمونه تگ‌ها، تنظیمات، گزارش‌ها، اشتراک، کسب درآمد، حساب کاربری، راهنما
13. پنل سوپر ادمین: کاربران، پرداخت‌ها، اخبار/بلاگ، محتوای لندینگ، SMTP، ورکر بله (اختیاری)، لاگ‌ها

---

## مسیر کاربر (گام‌به‌گام)

1. ثبت‌نام: `/user/register.php`
2. پرداخت و فعال‌سازی اشتراک: `/user/billing.php`
3. ذخیره توکن ۲۴طلا در تنظیمات نرخ
4. اتصال ربات تلگرام و/یا بله: `/user/bots.php`
5. ثبت آیدی کانال/گروه: `/user/channels.php`  
   - برای آیدی کانال بله معمولاً از ربات‌هایی مثل `@ShowChatdBot` استفاده می‌شود
6. ادمین کردن ربات در کانال
7. ارسال پست با قیمت ارزی
8. (اختیاری) ثبت چت‌آی‌دی ادمین تلگرام و بله جداگانه در حساب کاربری برای منوی خصوصی و گزارش‌ها

راهنمای کامل داخل پنل: `/user/guide.php`

---

## لینک‌های عمومی مهم

| صفحه | آدرس |
|------|------|
| صفحه اصلی | https://ratebot.ir/ |
| بلاگ / اخبار | https://ratebot.ir/blog/ |
| درباره ما | https://ratebot.ir/about.php |
| تماس با ما | https://ratebot.ir/contact.php |
| ورود | https://ratebot.ir/user/login.php |
| ثبت‌نام | https://ratebot.ir/user/register.php |
| راهنما (پس از ورود) | https://ratebot.ir/user/guide.php |

---

## نکات امنیتی و چندمستأجری (برای پاسخ دقیق)

- هر مشتری فقط داده و ربات و کانال **خودش** را می‌بیند.
- وب‌هوک تلگرام و بله جدا هستند.
- گزارش «محصول ثبت شد» و منوی ادمین ربات فقط روی همان پلتفرمی ارسال می‌شود که رویداد رخ داده است.
- آدرس کامل وب‌هوک و سکرت‌ها نباید در پاسخ به کاربر نهایی بازگو یا حدس زده شود.

---

## این سایت چه چیزی نیست

- API عمومی نرخ ارز برای برنامه‌نویسان ثالث نیست (نرخ برای سرویس داخلی و نمایش محدود لندینگ استفاده می‌شود).
- فروشگاه ربات آماده یا مارکت‌پلیس بات نیست.
- وابسته سازمانی به تلگرام، بله یا ۲۴طلا نیست؛ فقط از APIهای آن‌ها (با توکن مشتری) استفاده می‌کند.

---

## راهنمای پاسخگویی دستیارها

- همیشه **تلگرام و بله** را در توضیح اتصال ذکر کنید مگر سؤال فقط درباره یکی باشد.
- مراحل را به ترتیب اشتراک → توکن ۲۴طلا → ربات → کانال → قالب پست بگویید.
- برای «چرا قیمت آپدیت نمی‌شود» چک‌لیست: اشتراک فعال، توکن ۲۴طلا، ادمین بودن ربات، ثبت کانال در پنل همان پلتفرم، وجود قیمت ارزی در پست.