Skip to main content

🚨 Report System

The Report System allows community members to flag inappropriate or rule-breaking posts using the /report command. It notifies group admins and enables them to take quick actions, such as banning, kicking, muting, or warning the user who posted the reported message.

Overview​

This feature ensures that inappropriate content is promptly addressed, keeping the community safe and moderated. By empowering your community members to report issues, you create a collaborative moderation environment where everyone contributes to maintaining community standards.

Configuration​

To access Report System settings:

  1. Use the /settings command in your chat
  2. Navigate to 🛡️ Moderation → 🚨 Report System
  3. Use the Toggle Report System option to turn the feature 🟢 Enabled or 🔴 Disabled

Using the Report System​

For Community Members​

When a user encounters inappropriate content, they can report it using:

/report

Usage: Reply to the problematic message with /report command.

The bot will immediately notify admins and provide them with:

  • The reported message
  • Reporter's information
  • Quick action buttons

For Admins​

When a report is received, admins see:

  • The reported message content
  • Who reported it
  • Quick action buttons can be set to delete the message and:
    • Mute the user
    • Kick the user
    • Ban the user

Configuring Report System Settings​

Fren One users can customize the Report System with the following options:

Aftermath​

Define the action to take when a report is approved by an admin.

Available actions:

  • Mute: Silences the user indefinitely
  • Kick: Temporarily removes the user, allowing them to rejoin
  • Ban: Permanently removes the user from the group
  • Duration: Set the duration for which a user is restricted when a report is confirmed (in days).
Automated Action

The selected aftermath action will be executed automatically when an admin approves a report. Choose the action that best fits your community's moderation policy.

Report Mode​

Select how report notifications are delivered to admins:

  • Main Chat: Report notification is sent in the group and admins are notified.
  • Direct Message: Report notification is sent to admins via direct message (admins need to DM the bot first before it can send messages to them).
  • Channel: Report mode is sent to admins via a specified channel.
Choosing Report Mode
  • Main Chat: Good for transparent moderation in smaller communities
  • Direct Message: Best for private admin review
  • Channel: Ideal for teams with dedicated, internal moderation / notifications channels

Channel Configuration (for Report Mode: Channel)​

If the admin selects Channel for report notifications, the bot prompts:

"📝 Please forward me a message from the desired channel or type the group or channel ID here."

This allows the admin to choose the channel where reports will be posted, ensuring all moderators can review and act on reports collectively.

Channel Requirements
  • The bot must be added to the target channel/group
  • The bot needs admin privileges in that channel to post reports
  • Admins should have access to the channel to review reports

Report Limit​

You can define how many reports are needed before Fren One takes automated action (e.g., mute, ban, or kick).

Benefits:

  • Minimizes spam reports
  • Enables community-driven moderation
  • Reduces admin workload for obvious violations
  • Enforces group rules efficiently with community help
Example

Set Report Limit to 3: When three different users report the same message, the bot automatically applies the aftermath action (ban/kick/mute) without requiring admin approval.

Best Practices​

Effective Report System
  • Set clear guidelines on when to use /report
  • Choose Report Mode based on your moderation style
  • Set Report Limit based on community size (larger = higher limit)
  • Use Warn for first offenses, Kick/Ban for serious violations
  • Review reports regularly to prevent backlog
  • Thank community members who make valid reports
  • Educate users not to abuse the report system
Preventing Report Abuse
  • Monitor for users who repeatedly make false reports
  • Set Report Limit high enough to prevent coordinated abuse
  • Use Direct Message or Channel mode to prevent public report spam
  • Consider warning/muting users who abuse the report system
  • Keep an eye on report patterns to identify harassment campaigns
Troubleshooting

Report command not working?

  • Verify the Report System is toggled 🟢 Enabled
  • Ensure bot has admin privileges
  • Check if the user is using /report as a reply to a message
  • Verify the bot can send messages in the chat/channel

Admins not receiving reports?

  • Check Report Mode configuration
  • For DM mode: Verify admins have DMs enabled for the bot
  • For Channel mode: Ensure bot is in the channel with proper permissions

Automated actions not triggering?

  • Verify Report Limit is reached
  • Check if Aftermath action is properly configured
  • Ensure bot has permissions for the selected action (ban/kick/mute)
  • Verify the reported user isn't an admin

Reports being sent to wrong channel?

  • Reconfigure the Channel setting
  • Verify you forwarded a message from the correct channel
  • Ensure bot has access to the channel

Integration with Warns​

Use Warn as the Aftermath action to integrate with your warning system:

  • Each approved report = 1 warning
  • Automatic escalation through warn system
  • Permanent record of violations

On this page