مستندات
مرکز آموزش

با راهنماها، آموزش‌ها و مستندات جامع، کار با Telegram Bot App را حرفه‌ای‌تر یاد بگیرید

پیوندهای سریع

داشبورد هوشمندی کاربران و تحلیل‌های گروهی

مقدمه

سیستم هوشمندی کاربران و تحلیل گروه، بینش‌هایی جامع و مبتنی بر داده درباره سلامت جامعه Telegram شما، رفتار اعضا و میزان اثربخشی مدیریت ارائه می‌دهد. این پلتفرم پیشرفته تحلیل، بسیار فراتر از شمارش ساده پیام‌ها عمل می‌کند و تحلیل عمیق رفتاری، پروفایل‌های ارزیابی ریسک، قابلیت‌های پایش لحظه‌ای و گزارش‌های آماری دقیق را در اختیار مدیران می‌گذارد تا بتوانند تصمیم‌های آگاهانه‌تری در مدیریت گروه بگیرند.

برخلاف آمارهای پایه گروه که فقط معیارهای سطحی را نشان می‌دهند، داشبورد هوشمندی و تحلیل با استفاده از تکنیک‌های پیشرفته علم داده، الگوها را آشکار می‌کند، مشکلات احتمالی را پیش از تشدید شناسایی می‌کند و درباره کاربران به‌صورت فردی و همچنین پویایی کلی جامعه، اطلاعات کاربردی و قابل اقدام ارائه می‌دهد. این سیستم با ترکیب تحلیل داده‌های تاریخی، جریان‌های رویداد لحظه‌ای و مدل‌سازی پیش‌بینانه ریسک، نمایی جامع از وضعیت عملیاتی جامعه شما ایجاد می‌کند.

این مجموعه قابلیت‌ها شامل گزارش‌های هوشمندی کاربران به‌صورت فردی است (که الگوهای رفتاری، سابقه تخلف و امتیازهای ریسک اسپم را نشان می‌دهد)، داشبوردهای آماری در سطح گروه (که معیارهای تجمیعی، تفکیک تخلف‌ها و الگوهای تعامل را نمایش می‌دهد)، فیدهای زنده مجازات‌ها (جریان‌های لحظه‌ای اقدامات مدیریتی در تمام گروه‌های شما) و دسترسی عمومی به API برای یکپارچه‌سازی برنامه‌محور با ابزارهای خارجی.

چگونه کار می‌کند

گزارش‌های هوشمندی کاربران

سیستم هوشمندی کاربران برای هر کاربر در جامعهٔ شما پروفایل‌های رفتاری دقیق نگهداری می‌کند. وقتی کاربر مشخصی را با نام، هندل یا Telegram ID جست‌وجو می‌کنید، سیستم تاریخچهٔ کامل تعاملات او را بازیابی می‌کند؛ از جمله پیام‌های ارسال‌شده، تخلف‌های ثبت‌شده، مدت‌زمان مجازات، الگوهای عضویت در گروه‌ها و امتیازهای ریسک محاسبه‌شده.

گزارش هوشمندی با یک ارزیابی جامع از ریسک اسپم آغاز می‌شود که توسط الگوریتم هوشمندی اسپم AI محاسبه شده است. این امتیاز (از 0.0 تا 1.0) احتمال آماری اسپمر بودن یا عامل مخرب بودن کاربر را بر اساس چندین سیگنال رفتاری نشان می‌دهد؛ از جمله نرخ تخلف، سطح اطمینان تخلف‌ها، ویژگی‌های پروفایل و الگوهای مشارکت.

زیر امتیاز ریسک، سیستم آمار دقیق تخلف‌ها را نمایش می‌دهد؛ شامل معیارهای اطمینان (میانگین، میانه، صدک ۹۵)، نرخ تخلف‌های با اطمینان بالا، رایج‌ترین نوع‌های تخلف و رایج‌ترین دلیل‌های تخلف. این آمار به مدیران کمک می‌کند بفهمند نه‌تنها کاربر قوانین را نقض کرده است، بلکه این تخلف‌ها با چه میزان اطمینانی شناسایی شده‌اند و چه الگوهایی رفتار مشکل‌ساز کاربر را مشخص می‌کنند.

تاریخچهٔ کامل تخلف‌ها به‌صورت فهرستی زمان‌مند نمایش داده می‌شود که هر تخلف را همراه با زمان ثبت، نوع تخلف (پورن، محتوای جنسی، زبان سمی، اسپم، کلمات نامناسب و غیره)، سطح اطمینان (0.0-1.0) و دلیل دقیق توضیح‌دهندهٔ عامل شناسایی نشان می‌دهد. این شفافیت به مدیران امکان می‌دهد ارزیابی کنند که آیا تخلف‌ها واقعاً نشان‌دهندهٔ مشکل هستند یا ممکن است تشخیص‌های مثبت کاذب باشند.

داشبورد آمار گروه

داشبورد آمار گروه دیدی تجمیعی از سلامت کلی جامعهٔ شما و اثربخشی مدیریت محتوا ارائه می‌دهد. سیستم چندین دسته از معیارها را محاسبه و نمایش می‌دهد:

معیارهای کلی شامل وضعیت گروه (مجاز/غیرمجاز)، تعداد کل اعضا، تعداد مدیران، تأیید حضور ربات، و این‌که آیا گروه تصویر پروفایل و لینک دعوت را به‌درستی پیکربندی کرده است یا نه.

معیارهای فعالیت مجموع پیام‌های ارسال‌شده در تاریخچهٔ گروه، مجموع تخلف‌های شناسایی‌شده، کل زمان مجازات اعمال‌شده (بر حسب دقیقه) و رابطهٔ بین این اعداد را نشان می‌دهد که سطح کلی پایبندی جامعه به قوانین را مشخص می‌کند.

کارایی مدیریت محتوا معیارهایی مانند نرخ مجازات به‌ازای هر ۱٬۰۰۰ پیام (نشان می‌دهد مدیریت محتوا نسبت به میزان فعالیت با چه بسامدی رخ می‌دهد)، میانگین مدت‌زمان مجازات (نشان‌دهندهٔ شدت معمول تخلف‌ها) و میانگین پیام به‌ازای هر عضو (شاخص مشارکت) را محاسبه می‌کند.

تحلیل زمانی فعالیت را در بازه‌های زمانی اخیر (۷ روز گذشته، ۳۰ روز گذشته) نمایش می‌دهد و روندهای تخلف‌ها و الگوهای مجازات را نشان می‌دهد؛ روندهایی که کمک می‌کنند تشخیص دهید جامعهٔ شما با گذشت زمان مشکل‌سازتر می‌شود یا کمتر مشکل‌ساز.

تفکیک تخلف‌ها همهٔ تخلف‌ها را بر اساس نوع دسته‌بندی می‌کند (محتوای پورنوگرافیک، محتوای جنسی، زبان سمی، اسپم، تخلف‌های زبانی، الفاظ رکیک، توهین، تهدید، کلمات نامناسب، پیام‌های فورواردشده، رسانه‌های ممنوع، لینک‌های دعوت، ربات‌های غیرمجاز) و تعداد دقیق هر دسته را نشان می‌دهد. این تفکیک مشخص می‌کند کدام قوانین بیشتر نقض می‌شوند و به تصمیم‌گیری دربارهٔ این‌که برخی محدودیت‌ها باید سخت‌گیرانه‌تر یا آسان‌گیرانه‌تر شوند کمک می‌کند.

فید زندهٔ مجازات‌ها

فید لحظه‌ای مجازات‌ها از اشتراک‌های WebSocket استفاده می‌کند تا رویدادهای مدیریت محتوا را همان لحظه که در همهٔ گروه‌هایی رخ می‌دهند که ربات شما در آن‌ها فعال است، پخش کند. این نمای زنده ۲۰ مجازات اخیر را در کل سیستم نمایش می‌دهد (نه فقط محدود به گروه‌های خودتان) و کاربری را که مجازات شده، نوع تخلف، دلیل دقیق، امتیاز اطمینان و زمان ثبت را نشان می‌دهد.

وقتی تخلف‌های جدید در هر نقطه از اکوسیستم تحت پایش رخ دهند، فید بلافاصله به‌روزرسانی می‌شود و پنجره‌ای لحظه‌ای به فعالیت جاری مدیریت محتوا ارائه می‌دهد. این شفافیت به مدیران کمک می‌کند:

  • کمپین‌های اسپم فعال را که چندین جامعه را تحت تأثیر قرار می‌دهند پایش کنند
  • فرایند تصمیم‌گیری لحظه‌ای ربات را مشاهده کنند
  • کاربرانی را شناسایی کنند که در چندین گروه قوانین را نقض می‌کنند
  • ببینند کدام نوع‌های تخلف در حال حاضر رایج‌تر هستند
  • اطمینان حاصل کنند که سیستم مدیریت محتوا فعالانه در حال کار است

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

دسترسی عمومی API

سیستم هوشمندی کاربران یک نقطهٔ پایانی عمومی REST API ارائه می‌دهد که به همه اجازه می‌دهد با ارائهٔ شناسهٔ کاربر، امتیاز اسپم کاربران Telegram را جست‌وجو کنند. API امتیاز اسپم (0.0-1.0) و دستهٔ سطح ریسک (کم، متوسط، زیاد، بحرانی) را در قالب JSON و بدون نیاز به احراز هویت برمی‌گرداند.

این API عمومی یکپارچه‌سازی‌های شخص ثالث را ممکن می‌کند و به توسعه‌دهندگان ربات‌های دیگر، پژوهشگران یا مدیران جوامع اجازه می‌دهد داده‌های هوشمندی را در ابزارها و گردش‌کارهای خود به کار بگیرند. مستندات API شامل نمونه‌کدهایی به چند زبان (cURL، JavaScript، Python) است که نشان می‌دهد چگونه درخواست ارسال کنید و پاسخ‌ها را پردازش کنید.

در حالی که امتیاز اسپم عمومی است، تاریخچه‌های دقیق تخلف و تحلیل‌های رفتاری خصوصی باقی می‌مانند و فقط برای مدیران گروه‌هایی قابل مشاهده‌اند که کاربر جست‌وجوشده عضو آن‌هاست. این توازن حریم خصوصی، اطلاعات مفید ریسک را در اختیار اکوسیستم گسترده‌تر Telegram قرار می‌دهد و هم‌زمان از حریم خصوصی تک‌تک کاربران محافظت می‌کند.

پیکربندی

دسترسی به هوشمندی کاربران

برای مشاهده گزارش‌های هوشمندی هر کاربر:

  1. از منوی اصلی پنل خود به بخش «User Intelligence» بروید
  2. برگه «User Intelligence» را انتخاب کنید (اولین برگه)
  3. از رابط جست‌وجو برای یافتن کاربران بر اساس موارد زیر استفاده کنید:
    • نام کامل یا بخشی از نام
    • شناسه Telegram (با نماد @ یا بدون آن)
    • شناسه کاربری Telegram (عددی)
  4. روی یک کاربر در نتایج جست‌وجو کلیک کنید تا گزارش کامل هوشمندی او را ببینید
  5. امتیاز اسپم، آمار تخلف‌ها و تاریخچه کامل تخلف‌های او را بررسی کنید

قابلیت جست‌وجو روی همه کاربران گروه‌هایی که در آن‌ها مدیر هستید کار می‌کند و به شما اجازه می‌دهد هر عضو جامعه را که رفتارش برایتان نگران‌کننده است بررسی کنید.

مشاهده آمار گروه

برای دسترسی به داشبورد تحلیل‌های گروه خود:

  1. از پنل به صفحه مدیریت گروه خود بروید
  2. برگه «Statistics» را انتخاب کنید
  3. زیر‌برگه «Group Statistics» را انتخاب کنید
  4. معیارهای جامع نمایش‌داده‌شده در چندین بخش را بررسی کنید:
    • نمای کلی (وضعیت، اعضا، پیکربندی ربات)
    • فعالیت (پیام‌ها، تخلف‌ها، مجازات‌ها)
    • کارایی مدیریت محتوا (نرخ‌ها، میانگین‌ها، تعامل)
    • فعالیت اخیر (روندهای ۷ روزه و ۳۰ روزه)
    • تخلف‌های برتر (تفکیک بر اساس نوع)
    • زمان‌ها (آخرین فعالیت، آخرین به‌روزرسانی)

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

دسترسی به آمار کاربران در گروه‌ها

برای مشاهده فعال‌ترین اعضا در یک گروه مشخص:

  1. در صفحه مدیریت گروه خود، برگه «Statistics» را انتخاب کنید
  2. زیر‌برگه «Users Statistics» را انتخاب کنید
  3. از قابلیت جست‌وجو برای فیلتر کردن کاربران بر اساس نام، شناسه، ID یا محتوای بیو استفاده کنید
  4. فهرستی را بررسی کنید که ۵۰ کاربر فعال‌تر را بر اساس تعداد پیام نشان می‌دهد
  5. هر کارت کاربر نمایش می‌دهد:
    • آواتار (در صورت وجود)
    • نام و شناسه
    • مجموع تعداد پیام‌ها در این گروه
    • زمان آخرین مشاهده
  6. روی هر کاربر کلیک کنید تا گزارش کامل هوشمندی او را ببینید

این قابلیت کمک می‌کند فعال‌ترین اعضای جامعه خود را شناسایی کنید و الگوهای فعالیت غیرعادی را تشخیص دهید (مثلاً کاربرانی با تعداد پیام بسیار بالا اما بدون تعامل قابل مشاهده ممکن است ربات‌های اسپم باشند).

پایش زنده جریان مجازات‌ها

برای مشاهده رویدادهای مدیریت محتوا به‌صورت لحظه‌ای:

  1. از منوی اصلی پنل به «User Intelligence» بروید
  2. برگه «Live Punishments» را انتخاب کنید
  3. جریان تخلف‌های اخیر را مشاهده کنید که موارد زیر را نشان می‌دهد:
    • آواتار و نام کاربر
    • نوع تخلف و دلیل دقیق
    • امتیاز اطمینان
    • زمان (مدت زمان گذشته به‌صورت نسبی)
    • نشانگر وضعیت اتصال (نمایش سلامت WebSocket)
  4. روی هر مورد مجازات کلیک کنید تا گزارش کامل هوشمندی فرد متخلف را ببینید

اگر اتصال قطع شود، این جریان به‌طور خودکار دوباره وصل می‌شود تا پایش بدون وقفه ادامه داشته باشد.

استفاده از API عمومی

برای دسترسی برنامه‌نویسی‌شده به امتیازهای اسپم کاربران:

  1. به برگه «User Intelligence» → «API Documentation» بروید
  2. نشانی و قالب endpoint مربوط به API را بررسی کنید
  3. نمونه‌کدهای ارائه‌شده را در زبان دلخواه خود کپی کنید:
    • cURL (خط فرمان)
    • JavaScript (fetch API)
    • Python (کتابخانه requests)
  4. شناسه کاربری نمونه را با شناسه‌ای که می‌خواهید استعلام کنید جایگزین کنید
  5. درخواست را اجرا کنید تا پاسخ JSON شامل موارد زیر را دریافت کنید:
    • spam_rating: امتیاز عددی (0.0-1.0)
    • risk_level: رشته دسته‌بندی (Low/Medium/High/Critical)

API برای جلوگیری از سوءاستفاده دارای محدودیت نرخ است، اما برای موارد استفاده مشروع، حجم معقولی از درخواست‌ها را مجاز می‌داند.

سناریوهای واقعی

سناریو ۱: بررسی اعضای جدید مشکوک

مدیر یک انجمن متوجه می‌شود چند عضو جدید هم‌زمان وارد شده‌اند و این پرسش برایش پیش می‌آید که آیا آن‌ها بخشی از یک عملیات هماهنگ اسپم هستند یا نه. مدیر با استفاده از جست‌وجوی User Intelligence، پروفایل هر یک از اعضای جدید را بررسی می‌کند.

گزارش‌های هوشمندی نشان می‌دهند که همه اعضای جدید این ویژگی‌ها را دارند:

  • امتیاز اسپم بالاتر از 0.70 (ریسک بالا)
  • نداشتن هندل Telegram (نشانه هشدار برای حساب‌های اسپم)
  • عضویت در بیش از 200 گروه با تعداد پیام بسیار کم در هر گروه (ویژگی رایج ربات‌ها)
  • تصاویر پروفایل NSFW (تاکتیک رایج اسپمرها)

مدیر با تکیه بر این اطلاعات، پیش از آنکه این حساب‌ها بتوانند اسپم ارسال کنند، آن‌ها را مسدود می‌کند و از ایجاد اختلال در انجمن جلوگیری می‌شود. بدون داده‌های هوشمندی، مدیر ناچار بود تا ظاهر شدن اولین پیام‌های اسپم صبر کند و سپس اقدام کند.

سناریو ۲: ارزیابی گزارش‌های مثبت کاذب

یکی از اعضای قدیمی انجمن به مدیران پیام می‌دهد و ادعا می‌کند که به‌ناحق به‌دلیل ارسال یک پیام معتبر بی‌صدا شده است. مدیران مطمئن نیستند که ربات اشتباه کرده یا کاربر نسبت به اجرای درست قوانین اعتراض دارد.

مدیران با استفاده از گزارش User Intelligence می‌بینند:

  • امتیاز اسپم: 0.15 (بسیار پایین، کاربر قابل اعتماد)
  • تنها یک تخلف در سابقه ۶ ماهه
  • اطمینان تخلف: 0.52 (مرزی، اطمینان پایین)
  • نوع تخلف: تحلیل احساسات - تشخیص الفاظ رکیک
  • دلیل دقیق: پیام حاوی واژه‌ای بوده که باعث مثبت کاذب شده است

امتیاز اطمینان پایین و وجود تنها یک تخلف، ادعای کاربر درباره مثبت کاذب بودن را تأیید می‌کند. مدیران فرایند تشخیص خودکار را توضیح می‌دهند، روشن می‌کنند که محدودیت فقط ۱ دقیقه بوده، و به کاربر اطمینان می‌دهند که جایگاه کلی او در انجمن همچنان عالی است (امتیاز اسپم 0.15).

سناریو ۳: پایش اثربخشی مدیریت محتوا

یک انجمن اخیراً چند قانون مدیریت محتوا را سخت‌گیرانه‌تر کرده و می‌خواهد اثر آن را ارزیابی کند. مدیران با استفاده از داشبورد آمار گروه، موارد زیر را بررسی می‌کنند:

  • نرخ مجازات: از 2.5 به 4.8 در هر 1K پیام افزایش یافته است
  • میانگین مدت مجازات: در 3.2 دقیقه ثابت مانده است
  • مجموع تخلف‌ها (۷ روز گذشته): 45 (در مقایسه با 28 در هفته قبل)
  • پرتکرارترین تخلف: تصاویر NSFW (۱۸ تخلف)

آمار نشان می‌دهد که اسکن سخت‌گیرانه‌تر تصاویر، محتوای نامناسب بیشتری را شناسایی می‌کند (همان‌طور که انتظار می‌رفت)، اما نرخ مجازات همچنان منطقی است (هنوز فقط 0.48% پیام‌ها قوانین را نقض می‌کنند). مدیران نتیجه می‌گیرند که تنظیمات جدید بدون مدیریت بیش‌ازحد، مطابق انتظار عمل می‌کنند.

سناریو ۴: شناسایی الگوهای اسپم بین‌گروهی

مدیری که Live Punishment Feed را پایش می‌کند، متوجه می‌شود نام‌های کاربری یکسانی با تخلف‌های مشابه (تشخیص الگوی اسپم، لینک‌های دعوت) در گروه‌های مختلف و در فاصله چند دقیقه از هم بارها ظاهر می‌شوند.

این الگو نشان‌دهنده یک کارزار هماهنگ اسپم است که هم‌زمان چندین انجمن را هدف قرار داده است. مدیر گزارش User Intelligence یکی از اسپمرها را بررسی می‌کند، امتیاز اسپم بالای او را تأیید می‌کند (0.85+)، و سپس برای شناسایی حساب‌های مرتبط، نام‌های کاربری مشابه را جست‌وجو می‌کند.

مدیر با مسدود کردن پیش‌دستانه این حساب‌های مرتبط از گروه‌های خود، پیش از آنکه موج اسپم به آن‌ها برسد، از حمله جلوگیری می‌کند؛ نه اینکه پس از ظاهر شدن اسپم صرفاً به آن واکنش نشان دهد.

سناریو ۵: بهینه‌سازی قوانین بر اساس داده

یک انجمن بازی به‌صورت ماهانه آمار گروه خود را مرور می‌کند تا تنظیمات مدیریت محتوا را بهینه کند. داده‌های این ماه نشان می‌دهد:

  • پرتکرارترین تخلف: اجرای قانون زبان (۳۵ تخلف)
  • مورد دوم: زبان سمی (۱۲ تخلف)
  • تخلف‌های NSFW: 2

تعداد بالای تخلف‌های مربوط به اجرای قانون زبان مدیران را غافلگیر می‌کند—آن‌ها متوجه می‌شوند انجمنشان بین‌المللی‌تر شده و اعضا به چندین زبان صحبت می‌کنند، اما ربات همچنان قوانین فقط انگلیسی را اعمال می‌کند.

بر اساس این بینش داده‌محور، آن‌ها اجرای قانون زبان را غیرفعال می‌کنند، چون می‌پذیرند انجمنشان به‌طور طبیعی به یک جامعه چندزبانه تبدیل شده است. آمار به آن‌ها کمک کرد قانونی را شناسایی کنند که دیگر با ترکیب فعلی انجمنشان سازگار نبود.

بهترین روش‌ها

ممیزی‌های منظم هوشمندی

هر هفته یا هر ماه، شاخص‌های کلیدی هوشمندی را بررسی کنید:

  • داشبورد آمار گروه را برای شناسایی روندها بررسی کنید
  • متخلفان برتر را در آمار کاربران مرور کنید
  • توزیع نوع تخلف‌ها را برای یافتن الگوها بررسی کنید
  • نرخ‌ها و مدت‌زمان مجازات‌ها را پایش کنید

ممیزی‌های منظم کمک می‌کنند مشکلات نوظهور را زود تشخیص دهید و مطمئن شوید تنظیمات مدیریت، هم‌زمان با رشد و تغییر جامعه شما همچنان مناسب باقی می‌مانند.

بررسی ناهنجاری‌ها

وقتی الگوهای غیرمعمولی در داده‌ها می‌بینید، فوراً بررسی کنید:

  • افزایش ناگهانی تخلف‌ها ممکن است نشان‌دهنده حمله اسپم یا تنظیمات نادرست باشد
  • امتیازهای اسپمِ غیرعادی بالا برای کاربرانی که می‌دانید معتبر هستند، ممکن است نشان‌دهنده تشخیص مثبت کاذب باشد
  • تعداد بالای پیام‌ها همراه با مشارکت کم ممکن است نشان‌دهنده ربات‌ها باشد
  • توزیع‌های غیرمعمولِ اطمینان به تخلف ممکن است مشکلات نظام‌مند در تشخیص را آشکار کند

داده‌های هوشمندی به شما کمک می‌کنند این ناهنجاری‌ها را ببینید؛ بررسی آن‌ها کمک می‌کند علت را بفهمید و برطرفشان کنید.

استفاده از هوشمندی برای درخواست‌های رفع مسدودی

وقتی کاربران درخواست رفع مسدودی می‌دهند یا به محدودیت‌ها اعتراض می‌کنند، از گزارش‌های هوشمندی برای تصمیم‌گیری آگاهانه استفاده کنید:

  • سابقه کامل تخلف‌های آن‌ها را بررسی کنید (نه فقط آخرین مورد)
  • امتیازهای اطمینان را بررسی کنید (تخلف‌های با اطمینان پایین ممکن است مثبت کاذب باشند)
  • امتیاز اسپم را بررسی کنید (۰٫۲ یا کمتر معمولاً نشان‌دهنده کاربر واقعی است)
  • الگوهای تخلف را در نظر بگیرید (یک مورد جداافتاده در برابر مشکلات تکراری)

ارزیابی درخواست‌ها بر پایه داده، تصمیم‌های مدیریت را منسجم و منصفانه می‌کند.

اشتراک‌گذاری بینش‌ها با هم‌مدیران

از داشبوردهای آماری به‌عنوان ابزار ارتباطی میان تیم مدیریت خود استفاده کنید:

  • از آمار هفتگی اسکرین‌شات بگیرید و در گفت‌وگوی مدیران به اشتراک بگذارید
  • درباره روندها و اینکه آیا تنظیمات نیاز به تغییر دارند گفت‌وگو کنید
  • پاسخ‌ها به الگوهای نوظهور اسپم را هماهنگ کنید
  • دانش سازمانی درباره پویایی‌های جامعه خود بسازید

شفافیت با تیم‌تان باعث مدیریت جمعی بهتر می‌شود.

استفاده از API عمومی برای یکپارچه‌سازی‌ها

اگر چند جامعه را مدیریت می‌کنید یا از ابزارهای مدیریت اضافی استفاده می‌کنید، API عمومی را یکپارچه کنید:

  • پیش از پذیرش اعضای جدید، امتیازهای اسپم را پرس‌وجو کنید
  • با پایگاه‌های داده اسپم خارجی تطبیق دهید
  • داشبوردهای سفارشی بسازید که داده‌ها را از چند منبع ترکیب می‌کنند
  • تصمیم‌های مدیریت مبتنی بر ریسک را خودکار کنید

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

پایش دوره‌ای فید زنده

بررسی فید زنده مجازات‌ها را بخشی از روال منظم مدیریت خود قرار دهید:

  • به‌صورت موردی بررسی کنید که اعمال قوانین درست کار می‌کند
  • کمپین‌های اسپم هماهنگ را زود شناسایی کنید
  • پیگیری کنید کدام نوع تخلف‌ها در حال حاضر رایج‌ترند
  • بررسی کنید امتیازهای اطمینان با کیفیت واقعی محتوا هم‌خوانی دارند

فید بی‌درنگ، آگاهی موقعیتی‌ای فراهم می‌کند که آمارهای با تأخیر قادر به ارائه آن نیستند.

یکپارچگی با سایر قابلیت‌ها

پایه‌ای برای هوش ضداسپم AI

گزارش‌های هوشمندی کاربر، شفافیتی را فراهم می‌کنند که باعث می‌شود هوش ضداسپم AI قابل اعتماد باشد. وقتی AI به‌صورت خودکار کاربری را با امتیاز اسپم بالاتر از 0.75 اخراج می‌کند، مدیران می‌توانند گزارش هوشمندی را بررسی کنند تا دقیقاً بفهمند چرا آن امتیاز محاسبه شده و مطمئن شوند تصمیم گرفته‌شده درست بوده است.

سوابق تخلف، آمار اطمینان، و تحلیل رفتاریِ نمایش‌داده‌شده در گزارش‌های هوشمندی، داده‌های خامی هستند که الگوریتم محاسبه ریسک AI از آن‌ها تغذیه می‌کند. این یکپارچگی یک چرخه بسته ایجاد می‌کند: AI بر اساس داده تصمیم می‌گیرد، و مدیران می‌توانند با مشاهده همان داده‌ها، آن تصمیم‌ها را بازبینی کنند.

مکملی برای مدیریت دستی

در حالی که سامانه‌های خودکار اجرای معمول قوانین را بر عهده دارند، داده‌های هوشمندی به مدیران کمک می‌کند درباره موارد مرزی تصمیم‌های دقیق‌تری بگیرند:

  • امتیازهای اسپم نزدیک به مرز (0.60-0.74) ممکن است به‌جای اخراج، نیازمند هشدار باشند
  • تخلف‌های با اطمینان پایین ممکن است شایسته فرصت دوباره باشند
  • کاربرانی که سابقه بلندمدت خوبی دارند اما اخیراً تخلف‌هایی داشته‌اند، شاید بهتر باشد به‌جای تنبیه، راهنمایی شوند

سامانه هوشمندی، زمینه‌ای را فراهم می‌کند که خودکارسازیِ صرف قادر به ارائه آن نیست.

تقویت تشخیص الگو

گزارش‌های هوشمندی فردی، الگوهای سطح کاربر را نشان می‌دهند، در حالی که آمار گروهی الگوهای سطح جامعه را آشکار می‌کند:

  • تخلف تعداد زیادی از کاربران از یک قانون یکسان نشان می‌دهد که شاید آن قانون بیش از حد سخت‌گیرانه باشد
  • نرخ بالای تخلف در زمان‌های مشخص نشان می‌دهد کمپین‌های اسپم چه زمانی رخ می‌دهند
  • تغییر در توزیع نوع تخلف‌ها نشان می‌دهد تاکتیک‌های اسپم در طول زمان چگونه تغییر می‌کنند

ترکیب هر دو دیدگاه، آگاهی جامعی از الگوها ایجاد می‌کند.

اعتبارسنجی پیکربندی قابلیت‌ها

از آمار استفاده کنید تا بررسی کنید آیا تنظیمات قابلیت‌هایتان همان‌طور که انتظار دارید عمل می‌کنند یا نه:

  • اگر تشخیص NSFW تخلف‌های زیادی ایجاد می‌کند، یعنی محتوا را شناسایی می‌کند (در حال کار است)
  • اگر تحلیل احساسات با وجود گفت‌وگوی سمی هیچ تخلفی نشان نمی‌دهد، شاید آستانه بیش از حد بالا باشد
  • اگر تشخیص اسپم، اسپم‌های آشکار را از دست می‌دهد، شاید آستانه بیش از حد سخت‌گیرانه باشد

اعتبارسنجی مبتنی بر داده تضمین می‌کند قابلیت‌ها برای جامعه شما به‌صورت بهینه پیکربندی شده‌اند.

استفادهٔ پیشرفته

تحلیل همبستگی

مدیران پیشرفته می‌توانند معیارهای مختلف را با هم همبسته کنند تا به بینش‌های عمیق‌تری برسند:

  • نرخ مجازات در برابر سطح فعالیت: گروه‌های پرفعالیت با نرخ مجازات پایین، فرهنگ سالمی دارند
  • اطمینان از تخلف در برابر نوع تخلف: تخلف‌های NSFW با اطمینان پایین ممکن است نشان‌دهندهٔ آستانه‌ای بیش از حد حساس باشد
  • امتیاز اسپم کاربر در برابر تعداد عضویت در گروه‌ها: کاربرانی که در گروه‌های زیادی عضو هستند و امتیاز اسپم بالایی دارند، احتمالاً اسپمرهای حرفه‌ای‌اند
  • الگوهای زمانی: تجمع تخلف‌ها در زمان‌های خاص ممکن است نشان‌دهندهٔ کمپین‌های اسپم هدفمند باشد

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

تحلیل هم‌گروه با استفاده از آمار کاربران

برای درک سلامت جامعه، هم‌گروه‌های مشخصی از کاربران را دنبال کنید:

  • اعضای جدید (پیوسته در ۳۰ روز گذشته): چه درصدی از آن‌ها تخلف جمع می‌کنند؟
  • مشارکت‌کنندگان برتر (تعداد پیام بالا): آیا امتیاز اسپم پایینی دارند؟
  • اعضای غیرفعال (بدون فعالیت اخیر): آیا دوباره فعال می‌شوند یا در حال ترک کردن هستند؟

تحلیل هم‌گروه نشان می‌دهد آیا جامعهٔ شما اعضای باکیفیت را حفظ می‌کند و تازه‌واردها را با موفقیت ادغام می‌کند یا نه.

تحلیل توزیع اطمینان از تخلف

گزارش هوشمندی میانگین، میانه و صدک ۹۵ اطمینان را نشان می‌دهد. از این موارد برای درک کیفیت تشخیص استفاده کنید:

  • میانگین بالا + میانه بالا (هر دو >0.7): تشخیص‌های قوی و مطمئن
  • میانگین پایین + صدک ۹۵ بالا: عمدتاً تشخیص‌های ضعیف با موارد قویِ گاه‌به‌گاه
  • انحراف معیار بالا (فاصلهٔ زیاد بین میانگین و صدک): کیفیت تشخیص ناپایدار

این الگوها به شما کمک می‌کنند ارزیابی کنید که آیا تنظیمات مدیریت محتوا نتایج قابل اعتمادی تولید می‌کنند یا نه.

مقایسه با داده‌های تاریخی

برای ایجاد خط مبنا و شناسایی روندها، معیارهای کلیدی را در طول زمان دنبال کنید:

  • نرخ معمول مجازات شما به ازای هر ۱K پیام چقدر است؟
  • توزیع معمول تخلف‌ها چگونه است (کدام نوع‌ها رایج‌ترند)؟
  • توزیع امتیاز اسپم در جامعهٔ شما چه شکلی دارد؟

با ایجاد خط مبناهای تاریخی، ناهنجاری‌ها فوراً آشکار می‌شوند.

لایه‌بندی ریسک

کاربران را بر اساس امتیازهای اسپم در سطوح ریسک دسته‌بندی کنید:

  • 0.00-0.30: کاربران قابل اعتماد (سبز)
  • 0.31-0.60: کاربران عادی (زرد)
  • 0.61-0.74: ریسک افزایش‌یافته (نارنجی)
  • 0.75+: ریسک بالا (قرمز، اگر AI فعال باشد به‌طور خودکار اخراج می‌شود)

برای هر سطح، سیاست‌های متفاوتی برای پایش یا اعمال محدودیت در نظر بگیرید. برای مثال، کاربران با ریسک افزایش‌یافته ممکن است سریع‌تر به محدودیت‌ها برسند، در حالی که با کاربران قابل اعتماد در تخلف‌های مرزی با ملایمت بیشتری برخورد شود.

پیاده‌سازی فنی

سیستم User Intelligence به‌عنوان بخشی از میکروسرویس telegram_intelligence عمل می‌کند؛ این میکروسرویس یک پایگاه‌داده را که به‌طور مداوم به‌روزرسانی می‌شود نگه‌داری می‌کند و شامل پروفایل‌های رفتاری استخراج‌شده از رویدادهای تخلف، آمار پیام‌ها، داده‌های عضویت در گروه و اطلاعات پروفایل است.

محاسبه امتیاز اسپم از یک مدل آماری استفاده می‌کند که نظریه احتمال بیزی را با منحنی‌های ریسک لجستیک ترکیب می‌کند. این الگوریتم به عوامل متعددی وزن می‌دهد، از جمله نرخ تخلف (تخلفات / پیام‌ها)، توزیع‌های اطمینان (میانگین، میانه، صدک)، میزان شیوع نوع تخلف، سیگنال‌های رفتاری (ویژگی‌های پروفایل، الگوهای عضویت در گروه) و عوامل اعتبارسنجی (وضعیت ادمین، سطح تعامل).

آمار گروه از طریق کوئری‌های تجمیعی پایگاه‌داده محاسبه می‌شود که مجموع تخلفات، تعداد پیام‌ها، مدت‌زمان مجازات‌ها و سایر معیارها را در تمام رویدادهای ثبت‌شده برای گروه جمع می‌زنند. این کوئری‌ها از ایندکس‌گذاری و کش‌کردن کارآمد استفاده می‌کنند تا زمان بارگذاری داشبورد حتی برای گروه‌هایی با سابقه گسترده نیز سریع باقی بماند.

فید زنده مجازات‌ها از اشتراک‌های GraphQL روی اتصال‌های WebSocket استفاده می‌کند و رویدادهای بی‌درنگ را از جدول tg_punishments هم‌زمان با درج ردیف‌های جدید استریم می‌کند. کوئری اشتراک شامل یک محدودیت است (۲۰ مورد از جدیدترین مجازات‌ها) و بر اساس زمان ایجاد به‌صورت نزولی مرتب می‌شود تا تازه‌ترین رویدادها ابتدا نمایش داده شوند.

نقطه پایانی عمومی API یک رابط REST ساده ارائه می‌دهد که پارامترهای شناسه کاربر را می‌پذیرد و پایگاه‌داده هوش را برای امتیاز اسپم متناظر جست‌وجو می‌کند. قالب‌بندی پاسخ از قراردادهای استاندارد JSON پیروی می‌کند و شامل هدرهای CORS مناسب است تا درخواست‌های مبدأ-متقاطع از برنامه‌های وب مجاز باشند.

تمام داده‌های هوش در پایگاه‌داده PostgreSQL با ایندکس‌های مناسب روی فیلدهایی که زیاد کوئری می‌شوند (user_id, group_id, created_at, violation_type) ذخیره می‌شوند تا حتی با رشد مجموعه‌داده تا میلیون‌ها رکورد، بازیابی داده‌ها سریع باقی بماند.

حریم خصوصی و مدیریت داده‌ها

سیستم User Intelligence این موارد را پردازش و ذخیره می‌کند:

  • سوابق تخلف: نوع، زمان، میزان اطمینان، جزئیات
  • آمار پیام‌ها: تعداد به‌ازای هر کاربر در هر گروه
  • عضویت در گروه‌ها: اینکه کاربران عضو کدام گروه‌ها هستند
  • اطلاعات پروفایل: وضعیت NSFW، وجود handle، محتوای bio (در صورت اسکن‌شدن)
  • شاخص‌های محاسبه‌شده: امتیازهای اسپم، آمار اطمینان

همه داده‌ها از اطلاعاتی استخراج می‌شوند که از طریق API تلگرام در دسترس است، یا از طریق اقدامات مدیریتی ربات تولید می‌شود. سیستم مستقیماً به محتوای پیام‌ها دسترسی ندارد—بلکه گزارش‌های تخلف را از سیستم‌های تحلیل محتوا دریافت می‌کند؛ سیستم‌هایی که پیش‌تر پیام‌ها را بر اساس تنظیمات مدیریتِ پیکربندی‌شده اسکن کرده‌اند.

حفاظت‌های حریم خصوصی شامل موارد زیر است:

  • کنترل دسترسی: فقط مدیران گروه می‌توانند اطلاعات دقیق کاربران را در گروه‌های خود مشاهده کنند
  • محدودیت‌های API: API عمومی فقط امتیاز اسپم را ارائه می‌دهد، نه تاریخچه دقیق تخلف‌ها
  • کمینه‌سازی داده‌ها: گزارش‌های تخلف نوع تخلف و میزان اطمینان را ذخیره می‌کنند، نه محتوای کامل پیام
  • ناشناس‌سازی: آمارهای تجمیعی هویت کاربران منفرد را افشا نمی‌کنند

کاربران نمی‌توانند از تحلیل رفتارشان انصراف دهند (چون این کار به اسپمرها اجازه می‌دهد از شناسایی فرار کنند)، اما تاریخچه‌های دقیق آن‌ها فقط برای مدیران گروه‌هایشان خصوصی باقی می‌ماند. میزان محدودِ داده‌های قابل‌دسترسی از طریق API عمومی، میان محافظت از جامعه (اشتراک‌گذاری اطلاعات ریسک) و حریم خصوصی افراد (محافظت از جزئیات تخلف‌ها) تعادل برقرار می‌کند.

عیب‌یابی

«نمی‌توان کاربر مشخصی را در جست‌وجوی هوشمند پیدا کرد»

دلایل احتمالی:

  • کاربر با هیچ‌یک از گروه‌هایی که ربات شما در آن‌ها حضور دارد تعامل نداشته است
  • جست‌وجو با قالب نادرست نام/هندل انجام شده است
  • کاربر به‌تازگی عضو شده و هنوز به‌طور کامل ایندکس نشده است

راه‌حل: کاربران فقط زمانی در جست‌وجو نمایش داده می‌شوند که در گروه‌های تحت نظارت ربات فعال بوده باشند. مطمئن شوید با هندل دقیق Telegram جست‌وجو می‌کنید (هم با نماد @ و هم بدون آن امتحان کنید) یا از شناسه عددی کاربر استفاده کنید. کاربران جدید ممکن است پس از اولین فعالیت، چند دقیقه زمان نیاز داشته باشند تا به‌طور کامل ایندکس شوند.

«آمار گروه با وجود تخلف‌های شناخته‌شده، تعداد تخلف‌ها را صفر نشان می‌دهد»

دلایل احتمالی:

  • تخلف‌ها قبل از اضافه شدن ربات به گروه رخ داده‌اند
  • قابلیتی که باید تخلف‌ها را شناسایی کند فعال نیست
  • تخلف‌ها رخ می‌دهند اما به‌درستی ثبت نمی‌شوند

راه‌حل: بررسی کنید که قابلیت‌های مرتبط با مدیریت محتوا واقعاً در تنظیمات فعال باشند. گزارش‌های هوشمند کاربران را برای متخلفان شناخته‌شده بررسی کنید تا مطمئن شوید تخلف‌های آن‌ها ثبت می‌شود. آمار فقط شامل تخلف‌هایی است که توسط ربات شناسایی شده‌اند، نه مشکلاتی که از قبل وجود داشته‌اند.

«فید زنده مجازات‌ها وضعیت 'disconnected' را نشان می‌دهد»

دلایل احتمالی:

  • اتصال WebSocket به‌دلیل مشکل شبکه قطع شده است
  • تب مرورگر برای مدت طولانی غیرفعال بوده است
  • سرور در حال نگهداری یا راه‌اندازی مجدد است

راه‌حل: فید باید به‌صورت خودکار ظرف ۳۰ ثانیه دوباره وصل شود. اگر همچنان قطع باقی ماند، صفحه را تازه‌سازی کنید. نشانگر وضعیت اتصال را بررسی کنید—اگر "connected" را نشان می‌دهد اما هیچ مجازاتی نمایش داده نمی‌شود، ممکن است به معنی دوره‌ای بدون تخلف باشد (که در زمان‌های آرام طبیعی است).

«امتیازهای اسپم برای اسپمرهای واضح، کمتر از حد انتظار به نظر می‌رسند»

دلایل احتمالی:

  • اسپمر هنوز تخلف‌های کافی جمع نکرده است
  • تخلف‌ها امتیاز اطمینان پایینی دارند
  • اسپمر سیگنال‌های اعتبار مثبت دارد که اثر تخلف‌ها را خنثی می‌کند

راه‌حل: امتیازهای اسپم احتمال آماری را بر اساس داده‌های انباشته‌شده نشان می‌دهند. اسپمرهای جدید با تخلف‌های کم تا زمانی که الگوی مشخصی ایجاد نکنند امتیاز بالایی نخواهند داشت. گزارش هوشمند آن‌ها را بررسی کنید تا امتیازهای اطمینان را ببینید—اگر تخلف‌ها اطمینان پایینی داشته باشند (0.50-0.60)، الگوریتم به‌درستی ریسک پایین‌تری اختصاص می‌دهد. با انباشته شدن تخلف‌های بیشتر با اطمینان بالا، امتیاز افزایش خواهد یافت.

«Public API خطا یا پاسخ خالی برمی‌گرداند»

دلایل احتمالی:

  • قالب شناسه کاربر نامعتبر است
  • کاربر هرگز با گروه‌های تحت نظارت ربات تعامل نداشته است
  • محدودیت نرخ درخواست فعال شده است

راه‌حل: مطمئن شوید یک شناسه عددی معتبر Telegram برای کاربر وارد می‌کنید، نه نام کاربری یا هندل. API فقط برای کاربرانی داده برمی‌گرداند که در گروه‌هایی که ربات در آن‌ها فعالیت می‌کند فعال بوده‌اند. اگر درخواست‌های زیادی ارسال می‌کنید، سرعت را کاهش دهید تا از محدودیت نرخ جلوگیری شود (حداکثر ۱۰۰ درخواست در دقیقه برای هر IP).

«User Statistics با وجود بزرگ‌تر بودن گروه، کمتر از ۵۰ کاربر نشان می‌دهد»

دلایل احتمالی:

  • بسیاری از اعضا هیچ پیامی ندارند
  • فیلتر جست‌وجو فعال است و نتایج را محدود می‌کند
  • اعضای غیرفعال در فهرست مشارکت‌کنندگان برتر لحاظ نمی‌شوند

راه‌حل: فهرست Users Statistics فقط کاربرانی را نشان می‌دهد که حداقل یک پیام ارسال کرده‌اند و بر اساس تعداد پیام مرتب شده‌اند. اعضایی که عضو شده‌اند اما هرگز مشارکت نکرده‌اند نمایش داده نمی‌شوند. برای دیدن فهرست کامل، هرگونه فیلتر جست‌وجوی فعال را پاک کنید. این شمارش فقط شامل مشارکت‌کنندگان فعال است، نه کل اعضا.

نتیجه‌گیری

سیستم هوشمندی کاربر و تحلیل گروه، دید روشنی از پویایی‌های جامعه، رفتار اعضا و میزان اثربخشی مدیریت محتوا در اختیار شما می‌گذارد. این سیستم پروفایل‌های رفتاری فردی را با آمارهای تجمیعی، پایش لحظه‌ای و دسترسی عمومی به API ترکیب می‌کند.

چه بخواهید یک کاربر مشکوک را بررسی کنید، مطمئن شوید تنظیمات مدیریت محتوای شما درست کار می‌کنند، کمپین‌های اسپمِ در حال اجرا را به‌صورت لحظه‌ای زیر نظر بگیرید، یا داده‌های هوشمندی را در ابزارهای خارجی ادغام کنید، داشبورد تحلیل اطلاعات لازم را فراهم می‌کند تا سریع و با اطمینان تصمیم‌های آگاهانه بگیرید.

شفافیت گزارش‌های هوشمندی تضمین می‌کند که تصمیم‌های خودکار مدیریت محتوا قابل بررسی و توضیح‌پذیر باقی بمانند—مدیران همیشه می‌توانند دقیقاً بررسی کنند چرا یک کاربر امتیاز اسپم مشخصی دریافت کرده یا چه تخلف‌هایی در یک اقدام اجرایی نقش داشته‌اند. این پاسخ‌گویی، مدیریت خودکار محتوا را قابل اعتماد می‌کند و به مدیران کمک می‌کند حتی هنگام انجام اقدامات اجرایی، اعتماد جامعه را حفظ کنند.

استفاده منظم از این گزارش‌ها به شما امکان می‌دهد به‌جای واکنش نشان دادن پس از وقوع مشکل، پیشگیرانه مدیریت کنید—بررسی امتیازهای اسپم و فید مجازات‌ها، مشکلات را پیش از گسترش آشکار می‌کند و ردپای حسابرسی باعث می‌شود هر تصمیم خودکار قابل بازبینی بماند.

نوشته‌شده توسط Telegram Bot App team · آخرین به‌روزرسانی June 2026

مقاله‌های مرتبط

چرا باید از ربات استفاده کنم؟

مزایا و امتیازهای مدیریت خودکار گروه

ضداسپم چگونه کار می‌کند؟

آشنایی با تشخیص اسپم مبتنی بر AI ما

اگر ربات اشتباه کند چه می‌شود؟

مدیریت تشخیص‌های نادرست و اصلاح اقدامات ربات