Skip to content

Troubleshooting

This section provides solutions for the most common issues you may encounter while using Imperium Guard.

Accesses and Permissions Issues

Bot Cannot Delete Messages or Ban Users

Problem: The bot is not responding to commands or cannot perform moderation actions.

Solution:

  1. Ensure that the bot has administrator privileges in the chat.
  2. Verify that the bot has the following permissions:
    • Delete messages
    • Ban users
  3. Ensure that you haven't disabled moderation commands in the settings.

Bot Cannot Send Messages to the Logs Channel

Problem: Moderation actions are not posted in the logs channel.

Solution:

  1. Verify that the bot has been added to the logs channel as an administrator.
  2. Ensure that the bot has permission to send messages in the channel.
  3. Verify that the logs channel ID is configured correctly in the bot settings.

Trigger Issues

Triggers Are Not Firing

Problem: Configured triggers are not responding to messages containing prohibited content.

Solution:

  1. Verify the syntax of the regular expressions if you are using "Regular Expression" mode.
  2. Ensure that the correct source text is selected (message text, username, etc.).
  3. Verify that the trigger is active and not disabled.
  4. Ensure that the bot has the necessary permissions to perform the trigger's actions (permission to delete messages/ban).
  5. Ensure that the sender of the prohibited content is not a moderator (for triggers with a terminating action).

Triggers Are Firing Too Frequently

Problem: Triggers are responding to normal messages that should not violate the rules.

Solution:

  1. Refine the trigger conditions by making the regular expression more specific.
  2. Use "Exact Match" mode instead of "Contains Text" if you only want to respond to specific phrases.

Automod Issues

Anti-Raid System Triggers with Normal User Influx

Problem: The raid mode is activated when a large number of regular users join the chat.

Solution:

  1. Increase the threshold for the raid system in the settings.
  2. Increase the check interval for the raid, making the system less sensitive.
  3. Temporarily disable the anti-raid system during planned mass user invitations.

API Issues

Authorization Error When Using the API

Problem: API requests return an authorization error.

Solution:

  1. Ensure that you are using the correct access token.
  2. Verify that the token is not expired and is active.
  3. Ensure that the token has the necessary permissions for the operations being performed.

API Returns a 404 Error

Problem: API requests return a "Not Found" error.

Solution:

  1. Verify the correctness of the API endpoint URL.
  2. Ensure that you are using the latest version of the API.
  3. Verify that the requested resource exists (e.g., user or chat ID).

Media Check Issues

Media is Not Checked for NSFW Content

Problem: The system is not filtering inappropriate stickers.

Solution:

  1. Ensure that the media check function is enabled in the settings.
  2. Ensure that the bot has permission to delete messages.
  3. Check the media status using @ImMediaGuardBot. If the status is incorrect, contact our technical support.

Media is Incorrectly Identified as NSFW Content

  1. If a terminating action was applied, use the "Delete and Report Error" button.
  2. If no terminating action was applied, provide the file to technical support.

General Issues

Bot Does Not Respond to Commands

Problem: The bot is not responding to user commands.

Solution:

  1. Ensure that the bot has permission to send messages.
  2. Ensure that you haven't disabled moderation commands in the settings.

High Latency in Bot Responses

Problem: The bot responds with a significant delay.

Solution:

  1. Check the queue using the /stats command.
  2. Check the live updates channel: https://t.me/sleeplesslive

If you encounter a problem that is not described in this section, please contact our technical support.