About Watchdog Robot

Watchdog Robot deletes messages of blacklisted types: link, sticker, gif, voice attachment, file attachment and other. Also it can ban other bots.

Installation

Follow these steps:

  • Add @watchdog_robot as admin into your chatroom
  • Give bot a permission to delete messages and to ban users. No other permissions are required
  • Configure content to be removed with command /watchdog block <filter-name>. See Filters section for available filters. Note that by default all filters are disabled i.e. watchdog does nothing. You can specify multiple filters at once, just delimit them with comma.

(!!!) For idiots: do not write to chat exactly the /watchdog block <filter-name>. Instead of <filter-name> use one of names listed in Filters section. Example of command: /watchdog block sticker. Example of multiple filters at once: /watchdog block photo,video.

Filters

List of filters which Watchdog Robot can work with. First word (colored) in each line is name of filter. Use this name in /watchdog block and /watchdog allow commands.

  • Links:
    • link - message that contains a link
    • channel_mention - message that contains @username of channel
    • group_mention - message that contains @username of group (chat)
    • user_mention - message that contains @username of user
    • bot_mention - message that contains @username of bot
    • mention - message that contains @username of any kind
  • Media:
    • sticker - sticker
    • gif - animated GIF image
    • voice - voice recording
    • attachment - file attachment
    • audio - audio clip
    • video - message with a video movie
    • photo - photo file
    • media_group - message that contains multiple media objects (photos usually)
    • video_message - video clip
    • not_sticker - message that IS NOT sticker
  • System Messages:
    • user_joined_msg - service message about user joined the chatroom
    • user_left_msg - service message about user left the chatroom
    • system - any system message (user joined chat, chat photo updated, message pinned, etc)
  • Text:
    • command - bot command (it'll be processed by corresponding bot anyway, just the text of command will be removed)
    • char1 - message that has length of one or zero chars, spaces are not counted as chars
    • emoji - message that contains ONLY emoji symbols (any number). Filter does not match message that contains both emoji and text symbols.
    • emoji_spam - any message that contains text AND 4 or more emoji symbols
    • bold - matches the message if most of its content is formatted bold
    • char500 - message that contains more than 500 character symbols
    • char1000 - message that contains more than 1000 character symbols
    • hashtag - message that contains a hashtag
    • not_hashtag - message that DOES not contains a hashtag
    • text - any text message (emoji is text too)
    • cryptohash - address of crypto wallet
    • uppercase - matches message which lenght is more than 30 symbols and most of symbols are in upper case
    • number - matches message which contains a number (yeah, just any number like "234234" or "1")
    • number9 - matches message which contains a number which is 9 digits or more
    • number11 - matches message which contains a number which is 11 digits or more
  • Users:
    • bot - if bot invited into chat it will be kicked by @watchdog_robot
    • bot_inviter - user who invited bot into chatroom will be kicked by @watchdog_robot
    • new_user - if new user joines to chat it will be kicked (not banned)
    • nousername - new users with no @username will be kicked from the chat
  • Other:
    • msg - any visible message from user. DOES NOT implies bot and bot_inviter rules. Using this filter you just mute the chat. Check out also Hush Robot, it is designed specially for muting chat.
    • forwarded - message forwarded from any other place
    • button - message that contains button of any kind. Usually it is message that posted via inline bot.
    • poll - a poll
    • contact - message with telegram contact card
    • game - message that contains a telegram game
    • inline - matches messages sent with inline bot (like @gif bot)
    • dice - single emoji that renders as Dice Throw kinda animation. These are dice, dart, football ball, etc emojis.
    • location - a location (map) message

For example, you want to block stickers and WWW links. Use two commands /watchdog block sticker and /watchdog block link. Also you can specify multiple filters in one command like /watchdog block sticker,link.

Commands

  • /watchdog block FILTER - tell Watchdog Robot to remove messages match this filter. You can specify multiple filters delimited by comma.
  • /watchdog allow FILTER - allow messages match this filter.
  • /watchdog config - see Watchdog Robot configuration for the current chat
  • /watchdog set notify_actions=yes - ask bot to display message about some message was removed
  • /watchdog set notify_actions=no - tell bot to remove messages silently
  • /watchdog check - check if bot is installed correctly.
  • /watchdog reload_admins - ask bot to reload admin IDs for current chat. Admins list is collected once and cached. Use this command to update cached data.
  • /watchdog analyze - write this command in reply to existing message to see what filters you can use to block this kind of message.

All these commands have to be entered in chatroom where watchdog is installed. Do not send these commands in private messages to watchdog.

FAQ

How to check if bot installed correctly?

First, complete installation instructions. Then type into chat this command: /watchdog check. Fix any issues bot talkes about.

Why watchdog does not kick other bots?

First, check you have told watchdog to do it with command /watchdog block bot. Second, check that you have given watchdog permission to ban other users.

See Also

If you need to block undesired content these bots could be helpful: @chatsearchrobot, @daysandbox_bot, @freqrobot, @grep_robot, @hushrobot, @joincleanerbot, @joinhider_bot, @lang_blocker_bot, @noarab_bot, @nochinabot, @nohello_robot, @nopigrobot, @nosticker_bot, @orgrobot, @reqmxbot, @tagchannelbot, @tgscanrobot, @wikirobot.

Support

You may ask question, send feedback or bugreport in these telegram groups: