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 🟢 ON or 🔴 OFF

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.

Prompt: "What should happen next to the user if you approve a report request?"

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.
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.

Common Use Cases​

Transparent Community Moderation​

Scenario: Build trust through visible moderation process.

Configuration:

  • Report Mode: Main Chat
  • Aftermath: Warn
  • Report Limit: 2

Result: Community sees reports and admin actions, building accountability.

Private Admin Review​

Scenario: Handle sensitive reports discreetly.

Configuration:

  • Report Mode: Direct Message
  • Aftermath: Kick
  • Report Limit: 5

Result: Admins review reports privately, protecting reporter identity.

Team Moderation Channel​

Scenario: Dedicated mod team reviews all reports together.

Configuration:

  • Report Mode: Channel
  • Channel: #moderation-reports
  • Aftermath: Ban
  • Report Limit: 3

Result: Centralized report management for moderation team.

Community-Driven Enforcement​

Scenario: Empower community to moderate obvious spam.

Configuration:

  • Report Mode: Channel
  • Aftermath: Mute
  • Report Limit: 2

Result: Quick automated response to spam when multiple users report.

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 🟢 ON
  • 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
  • Confirm admins are actually designated as admins in the group

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 whitelisted or an admin

Reports being sent to wrong channel?

  • Reconfigure the Channel setting
  • Verify you forwarded a message from the correct channel
  • Check the channel ID is entered correctly
  • Ensure bot has access to the channel

Too many spam reports?

  • Increase Report Limit to reduce false positives
  • Switch to Channel or DM mode to reduce visibility
  • Warn users about report system abuse
  • Consider temporarily disabling public report visibility

Advanced Configuration​

Multi-Tier Response System​

Combine Report System with other features:

  1. Report Limit 1: Logs report in channel for admin review
  2. Report Limit 3: Automatically mutes user
  3. Report Limit 5: Automatically bans user

(Note: This requires manual workflow setup)

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

Report Categories​

Educate community to include categories in reports:

  • /report spam - Spam content
  • /report scam - Scam attempts
  • /report harassment - User harassment
  • /report offtopic - Off-topic content

(Note: Category parsing requires custom implementation)

tip

Remember to give the Fren One bot admin privileges in your chat for all Report System features to work properly.