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

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

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

هشدارها، گزارش‌ها و گزارش‌وقایع مدیریت

مقدمه

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

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

نردبان هشدار

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

  • set_warnings_enabled — کلید روشن/خاموش. به‌صورت پیش‌فرض خاموش است.
  • set_warn_limit — تعداد تخلف‌هایی که باعث مسدودسازی می‌شود. پیش‌فرض 3 است.

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

  • /warn — ثبت یک تخلف. به پیام عضو پاسخ دهید، یا شناسه عددی او یا @handle را وارد کنید. می‌توانید دلیل اختیاری هم اضافه کنید، مثلاً /warn @user spamming links.
  • /unwarn — حذف یک تخلف از یک عضو، برای زمانی که هشدار به‌اشتباه صادر شده است.
  • /warns — بررسی اینکه یک عضو در حال حاضر چند تخلف از سقف مجاز دارد.

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

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

گزارش‌های اعضا

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

  • set_reports_enabled — کلید روشن/خاموش. به‌صورت پیش‌فرض خاموش است.

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

دو قانون باعث می‌شود گزارش‌ها مزاحمت ایجاد نکنند:

  • محدودیت نرخ. هر عضو فقط هر 30 ثانیه یک‌بار می‌تواند گزارش ارسال کند. گزارش‌های تکراری در این بازه بی‌سروصدا نادیده گرفته می‌شوند، تا هیچ‌کس نتواند ادمین‌ها را با اعلان‌های گزارش اسپم کند.
  • گفت‌وگوی مرتب. پیام دستور /report همیشه پس از رسیدگی حذف می‌شود، چه گزارش ثبت شود چه نشود، تا مکالمه‌ای که گزارش شده با دستورهای گزارش شلوغ نشود.

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

گزارش‌وقایع مدیریت

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

  • set_modlog_channel_id — شناسه عددی کانالی که گزارش‌وقایع را دریافت می‌کند. آن را در داشبورد ادمین گروه، در بخش Auto-Moderation تنظیم کنید. خالی گذاشتن آن (حالت پیش‌فرض) گزارش‌وقایع را غیرفعال می‌کند.

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

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

این قابلیت‌ها چطور کنار هم قرار می‌گیرند

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

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

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

خلاصه

هشدارها، گزارش‌ها و گزارش‌وقایع مدیریت، مدیریت گروه را از مجموعه‌ای از مسدودسازی‌های موردی به یک سیستم تبدیل می‌کنند. اعضا مشکلات را با /report علامت‌گذاری می‌کنند، ادمین‌ها با /warn، /unwarn و /warns تخلف‌های مرحله‌ای صادر می‌کنند، عضو فقط پس از رسیدن به سقف تنظیم‌شده به‌صورت خودکار مسدود می‌شود، و وقتی کانال گزارش‌وقایع تنظیم شده باشد، هر اقدام در آنجا منعکس می‌شود. همه این موارد تا وقتی ادمین فعالشان نکند خاموش می‌مانند، و دستورهای هشدار فقط برای ادمین‌ها قابل استفاده‌اند.

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

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

مسدود کردن بات‌های پورن Telegram: راهنمای فیلتر محتوای NSFW

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

تحلیل احساسات و تشخیص رفتار سمی

تشخیص خودکار رفتار سمی، ناسزا، توهین و تهدید

هوشمندی اسپم AI و ارزیابی ریسک کاربر

تحلیل رفتاری خودکار و پیشگیری هوشمند از اسپم با امتیازدهی ریسک