Grep Robot

grep_robot telegram bot

Bot to remove messages that contains words from black-list.


Follow these steps:

  • Add @grep_robot as admin into your chatroom
  • Give bot a permission to delete messages. No other permissions are required
  • Configure notifications and language of notifications, see commands section.


  • /grep config - see bot configuration for the current chat e.g. list of blocked words
  • /grep check - check if bot is installed correctly.
  • /grep set notify_actions=yes - tell bot to write explanation to the chat about deleted messages (recommended).
  • /grep set notify_actions=no - tell bot to remove messages silently
  • /grep set lang=<lang-code> - setup language of notifications. Valid values for this settings is en and ru.
  • /grep add word <word> - add word to black list. Example: /grep add word porn
  • /grep remove word <word> - stop blocking word. Example remove word from blacklist. Example: /grep remove word porn
  • /grep 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.

All these commands have to be sent to the chat which you want to configure. Do not send this command in private message to the bot, it will ignore such private messages.


How to check if bot installed correctly?

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

How words are matched?

Words are matched from beginning to end. For example, if you have added word "coin" into blacklist then bot will block word "coin" but it will not block word "bitcoin" or even "coins".