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.

Configuration​

In the webapp​

Open your workspace, select the Telegram group under Channels in the sidebar, then select Moderation, then the Reports tab. Changes save with the Save bar at the bottom of the page.

In Telegram (bot menu)​

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.

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