Чугайстер?

Це один з ботів-модераторів для телеграм груп. Ціль його створення — потреба у гнучких налаштуваннях та специфічних функцій одразу в одному боті.

Чугайстер — фантастичний образ в українській міфології, невідомий іншим слов'янським народам. Вважалося, що чугайстер полює на небезпечних для людей жіночих духів (мавок, повітруль) і поїдає їх.

Wikipedia

Підключення

Щоб бот запрацював у твоїй групі достатньо виконати ось ці кроки:

Долучити @chugaisterbot у свою групу.
Надати боту права адміністратора.
Виконати команду !reload
Налаштувати під свої потреби (якщо потрібно).
Готово!

Команди

Функціонал бота доробляється та може змінюватися. Команди — певні фрази, які, при надсиланні у групу, будуть зрозумілі боту та опрацьовані. Всі перелічені команди працюють як із символом "!", так і з "/".

Наприклад: !reload і /reload — одна і та ж команда. Для зручності команди знизу будуть написані із символом "!".

!groupinfo

Коротка інформація про групу. Тут можна дізнатися ID групи.

!groupinfo

ID: -100099999

!reload

Оновити список адміністраторів, яких бот буде слухатись.

!warn

Вручити користувачу (користувачам) попередження.

!warn @user1

Користувачу @user1 вручено попередження!

!warn @user1 @user2 порушення правил

Користувачам @user1, @user2 вручено попередження! Коментар: порушення правил

!unwarn

Скасувати одне попередження.

!unwarn @user1

Користувачу @user1 анульовано одне попередження!

!unwarn @user1 @user2 гарні хлопці

Користувачам @user1, @user2 анульовано одне попередження! Коментар: гарні хлопці

!kick

Кікнути з групи, але з можливістю повернутися знову.

!kick @user1

Користувача @user1 кікнуто, зможе повернутися хоч вже.

!kick @user1 @user2 1m

Користувачів @user1, @user2 кікнуто, але повернутися зможуть за 1 хвилину.

!kick @user3 1d треба відплчити

Користувача @user3 кікнуто, але повернутися зможе не раніше, ніж через 1 день. Коментар: треба відплчити

!ban

Заблокувати в групі, без можливісті повернутися знову.

!ban @user1

Користувача @user1 заблоковано.

!ban @user2 @user3 не люблять котиків

Користувачів @user2, @user3 заблоковано. Коментар: не люблять котиків

!mute

Обмежити можливість надсилати повідомлення.

!mute @user1

Користувача @user1 попросили замовкнути на невизначений термін.

!mute @user1 @user2 1m

Користувачів @user1, @user2 попросили помовчати 1 хвилину.

!mute @user3 1d треба відплчити

Користувача @user3 попросили замовкнути на 1 день. Коментар: треба відплчити

!unmute

Зняти всі обмеження надсилати повідомлення.

!unmute @user1 досить з тебе

Користувачу @user1 знято обмеження. Коментар: досить з тебе

!unmute @user1 @user2

Користувачам @user1, @user2 знято обмеження.

Налаштування

!welcome

Встановити текст повідомлення, яким бот буде відповідати тим, хто долучився в групу.

!welcome Привіт, новенький!

Привіт, новенький!

!welcome Привіт, новенький!

Можна і два рядки, можна і <b>html</b> форматування!

Привіт, новенький!

Можна і два рядки, можна і html форматування!

!welcome_buttons

Встановити кнопки-посилання під повідомленням, яким бот буде відповідати тих, хто долучився в групу.

!welcome_buttons Гуглити тут | https://google.com

Привіт, новенький!

!welcome_buttons
Гуглити тут | https://google.com
А наш сайт тут | https://site.com

Привіт, новенький!

!welcome_clear

Видалити текст і кнопки повідомлення, яким бот буде відповідати тим, хто долучився в групу.

!welcome_clear

Повідомлення видалено!

!admin_chat

Команда для того, щоб налаштувати окрему групу як адмін-чат. В ту групу бот буде надстдати спрвіщення про блокування та обмеження в основній групі

В окрему групу треба також додати цього бота та дізнатися її ID командою !groupinfo.

!admin_chat -100045672

Адмін чат налаштовано!

!config

Команда для тонких налаштуваннь.

!config set key value — встановити параметру key значення value. Працює тільки з простими параметрами.

!config add key value — додати до списку значеннь параметра key значення value. Працює тільки зі списковими параметрами.

!config remove key value — видалити зі списку значень параметра key значення value. Працює тільки зі списковими параметрами.
Прості параметри. Їхнє значення вказується через конструкцію !config set param_name value, де param_name назва налаштування, переліченого нижче, а value — значення, яке встановлюється. Стандартно всі налаштування вимкнено (false).

restrict_unknown_username — видаляти сторонні телеграм посилання, наприклад, на користувачів, яких немає в групі або на канали і боти, які не додані в список allowed_usernames. Можливі значення: true (увімкнено) або false (вимкнено).

restrict_via_bot — заборонити надсилати повідомення через боти (via @bot), які не додані в список allowed_usernames. Можливі значення: true (увімкнено) або false (вимкнено).

restrict_forwards — заборонити надсилати повідостення з каналів, якщо вони не додані в список allowed_forwards. Можливі значення: true (увімкнено) або false (вимкнено).

limit_stickers — увімкнути ліміт надсилання стікерів (анти флуд). Кількість вказується в параметрі limit_stickers_count. Можливі значення: true (увімкнено) або false (вимкнено).

limit_stickers_count — кількість дозволених стікерів за 10 секунд 30 секунд і 1 хвилину відповідно. Стікери, які перевищують ліміт будуть видалені, після трьох видалянь за хвилину — користувача буде попереджено, а після четвертого — обмежено змогу надсилати стікери на годину. Можливі значення: 1 2 3 (1 стікер за 10 секунд, 2 за 30 секунд і 3 за хвилину) або 2 (2 стікери за 10 секунд).

delete_admin_commands — бот буде автоматично видаляти повідомлення з командами адміністраторів. Можливі значення: true (увімкнено) або false (вимкнено).

restrict_bots — бот не дасть додати в групу інших ботів, яких не вказано в списку allowed_usernames. Можливі значення: true (увімкнено) або false (вимкнено).

!config set restrict_unknown_username true

Тепер буду видаляти невідомі телеграм посилання.

!config set restrict_unknown_username false

Гаразд, а тепер не буду видаляти.

!config set limit_stickers true

!config set limit_stickers_count 1 2 3

Гаразд, а тепер я не дозволю кожному користувачу надсилати більше 1 стікера за 10 секунд, більше 2 за 20 секунд і більше 3 за хвилину.
Спискові параметри. Ці налаштування розраховані містити не одне значення, а довільну кількість. Нові значення можна додавати через: !config add param_name value, та видаляти відповідно: !config remove param_name value, де param_name назва налаштування, переліченого нижче, а value — значення.

allowed_forwards — білий список ID каналів, звідки можна пересилати повідомлення. Це налаштування буде ігноруватися якщо параметр restrict_forwards не увімкнено. Зверніть увагу: ID каналів мають від'ємне значення.

restricted_keywords — список ключових слів для фільтрації. Наприклад, повідомлення з текстом, де міститиметься хоча б один фрагмент з цього списку, буде видалене.

allowed_usernames — білий список @username, які дозволено надсилати у чат. Символ "@" вказувати не потрібно! Працює якщо увімкнено restrict_unknown_username, restrict_via_bot чи restrict_bots.

silent_hours — список годин (кожна у форматі 0-23), коли в групі видаляються всі повідомлення.

!config set restrict_forwards true

!config add allowed_forwards -1000356235252

Тепер буду видаляти вcі переслані повідомлення, окрім тих, що з каналу з id -1000356235252.

!config set restrict_unknown_username true

!config add allowed_usernames durov

!config add allowed_usernames chugaisterbot

Тепер буду видаляти вcі повідомлення, де будуть @username, яких немає у чаті, є телеграм каналами або іншими групами, окрім @durov та @chugaisterbot.

!config add restricted_keywords vk.com

!config add restricted_keywords fb.com

Буду видаляти вcі повідомлення, які будуть містити vk.com або fb.com.

!config remove restricted_keywords fb.com

Оукей, тепер з fb.com не видалятиму.

!config add silent_hours 4

!config add silent_hours 5

!config add silent_hours 6

Видалятиму усі повідомлення, які будуть надіслані о 4, 5 і 6 годині.