Справка

Установка и первый запуск

Что нужно владельцу чата

1. Добавьте бота в свою группу. Cerswe работает в обычных группах Телеграма.
2. Выдайте боту права администратора: как минимум «Блокировка участников» и «Удаление сообщений». Без них бот увидит нарушение, но ничего не сможет сделать — и напишет об этом владельцу чата.
3. Напишите в чате настройки — так открывается приложение управления чатом. Открыть его можно и кнопкой «Открыть приложение чата» из приветствия бота, а в личных сообщениях — кнопкой меню Телеграма рядом с полем ввода.

Владелец чата и его возможности

Кто считается владельцем чата

Владелец чата для Cerswe — тот, кто создал группу в Телеграме. Тот, кто добавил бота, владельцем не становится. Если Cerswe пока не показывает владельца, напишите в чате любое сообщение: после этого чат и его создатель запомнятся.

Настройками чата управляют только владелец и назначенные им модераторы.

Что может владелец чата

• включать и выключать защиту: антифлуд, антирейд, капчу, ночной режим, NSFW-защиту, стоп-слова и ссылки;
• выдавать и забирать права модераторов;
• управлять чёрным списком своего чата;
• смотреть историю наказаний каждого участника;
• удалить все данные чата из Cerswe, если это понадобится.

Если бот перестал реагировать

Откройте настройки чата в Телеграме и проверьте, что Cerswe всё ещё администратор и у него есть права «Блокировка участников» и «Удаление сообщений». Если их сняли, выдайте заново там же, в списке администраторов.

Права и модераторы

Роли

• Владелец чата — ему открыты все настройки своего чата.
• Заместитель владельца — так подписан модератор, у которого есть сразу все категории прав. Владельцем он при этом не становится: исключения из проверок, правила чата, разделы «NSFW-защита» и «Наказания», удаление данных чата, оплата и подписка остаются только за владельцем. Заберите любое право — и подпись снова станет «Модератор».
• Модератор — у него есть только те категории прав, которые выдал владелец. Подпись «Модератор³» означает три выданные категории.
• Участник — ему доступны общие команды: топ, профиль, правила, жалоба и другие.

Сверх прав владелец может дать заместителю два полномочия: «Назначать модераторов» и «Менять права других модераторов». В «N из 12» они не считаются, выдаёт их только владелец и только тому, у кого полный набор прав, и действуют они, пока набор полный. Даже с ними заместитель не сможет выдать кому-то все права сразу: заместителей назначает только владелец чата. Без второго полномочия он меняет права только тех модераторов, которых назначил сам.

Категории прав

Мут, Бан, Исключение из чата, Предупреждения, Удаление сообщений, Закрытие чата, Добавление ботов, Антифлуд и новички, Стоп-слова, Ссылки, Чёрный список, Статистика нарушений.

Названия те же, что на экране выдачи прав в приложении.

Как выдать или забрать право

Права выдают и забирают в приложении управления чатом, раздел «Модераторы»: выберите участника и отметьте нужные категории. Там же видно, какие права есть у каждого модератора. Это делает владелец чата, а заместитель — только если владелец дал ему такое полномочие.

Команду Модераторы может написать любой участник чата: в ответе придут владелец и модераторы Cerswe с их публичными именами и ролями.

Права действуют, пока человек состоит в чате. Если он вышел сам, права снимаются сразу. У забаненного они сохраняются, но не действуют, пока он вне чата: вернётся после разбана — права снова заработают.

Права в разных чатах

Права действуют только в том чате, где их выдали, и в другие не переносятся. Если в одном чате работают два разных бота Cerswe, у каждого свой набор прав.

Модерация: предупреждения, муты и баны

Кого наказать, Cerswe понимает двумя способами: по ответу на сообщение нарушителя или по юзернейму в самой команде — Мут 20 часов @ivan реклама. Порядок слов такой: команда, срок, юзернейм, причина. Если юзернейм попадётся ещё раз в тексте причины, адресат не поменяется.

Обычная фраза, которая начинается со слова команды («бан уже есть», «мут закончился», «варн уже был»), командой не считается и никого не наказывает. Чтобы бот принял её за команду, дальше должен идти срок, юзернейм или причина: причину можно написать одним словом (бан спам) или после «за», «причина», тире или двоеточия (бан за рекламу в чате).

Владелец чата и администраторы Телеграма не получают наказания от бота — ни по команде, ни автоматически.

Команды

• Мут <время> [@юзернейм] [причина] — запретить участнику писать на время. Срок пишется минутами, часами, днями, неделями или месяцами; без срока мут выдаётся на неделю.
• Размут [@юзернейм] — снять мут: Размут @ivan или ответом на его сообщение.
• Бан [время] [@юзернейм] [причина] — заблокировать участника. Со сроком бан снимется сам, когда время выйдет; без срока он бессрочный. Сделать бессрочным уже действующий временный бан можно словом «навсегда»: Бан навсегда @ivan.
• Разбан [@юзернейм] — снять бан: Разбан @ivan, ответом на сообщение или по числовому ID: Разбан <id>.
• Варн [время] [@юзернейм] [причина] — выдать предупреждение. Со сроком, например Варн 6 дней @ivan реклама, оно перестанет действовать само: в чат придёт сообщение, а запись останется в истории. Снять варн [@юзернейм] убирает одно предупреждение, а снять все сразу можно в профиле участника в приложении.
• Очистить <N> — удалить N последних сообщений перед командой, от 1 до 1000 за раз. Сама команда тоже удаляется.
• Продлить наказание можно той же командой: если мут или бан уже действует и у него есть срок, Мут <время> и Бан <время> прибавят указанное время к оставшемуся. Так же работает повторное нажатие «Мут» или «Бан» в приложении. Отдельных команд «Продлить мут» и «Продлить бан» нет.
• Мутлист, Банлист — кто сейчас в муте или в бане, по одной строке на участника: когда наказание кончится по часовому поясу чата и сколько осталось — «до 20 сентября 2026, 18:31 · осталось 6 дн. 23 ч.» или «бессрочно». Варнлист — у кого сейчас есть предупреждения: сколько их и когда выдано последнее. Уже отправленный список обновится сам, когда наказание снимут или выдадут.

Страницы в списках

В списке по 10 записей на странице, а внизу подписано, какая это страница: «Страница 2 из 7 · всего 63 участника». Кнопки «Назад» и «Дальше» появляются только там, где есть куда идти: на первой странице нет «Назад», на последней — «Дальше», а если всё уместилось на одну страницу, кнопок нет совсем. Нажатие меняет то же самое сообщение, а нумерация идёт подряд: 1–10, 11–20 и дальше.

Пока список открыт, он обновляется сам: выдали, сняли или изменили наказание, кончился срок — страница и счётчик обновятся. Если записей стало меньше и показанной страницы больше нет, список перейдёт на последнюю. Список, отправленный давно, кнопками уже не листается: в ответ придёт сообщение, что список устарел и его нужно открыть заново.

Причина стоит в той же строке, рядом с именем и сроком. В варнлисте показана причина последнего предупреждения — так она и подписана; более ранние причины в список не попадают.

В приложении управления чатом откройте профиль участника: там его история наказаний и кнопка «Применить действие», а ещё исключение из чата и снятие всех предупреждений сразу. Команды для исключения из чата нет — только эта кнопка.

Кто наказан сейчас, видно в приложении: «Наказания» → «Действующие наказания». Списки переключаются — муты, баны, предупреждения; в строке участник, вид наказания, срок или «бессрочно» и причина, если она есть. Это только обзор: ничего из него не выполняется и в чат не отправляется. То же самое показывают команды Мутлист, Банлист и Варнлист в самом чате.

Если наказание выдал другой модератор

У участника одновременно действует не больше одного мута и одного бана.

Решает право, а не то, кто выдал наказание: модератор с правом «Мут» может изменить срок или снять любой мут, с правом «Бан» — любой бан. Владелец чата может всё. Право проверяется в момент действия — одинаково и для команды в чате, и для приложения.

Можно ли наказать модератора

Наказать модератора может владелец чата или модератор, у которого категорий прав больше. При равном количестве прав наказать друг друга нельзя. Само право тоже нужно: старшинство его не заменяет. Владелец чата и администраторы Телеграма защищены всегда.

Пока на модераторе действует мут, в этом чате он пользуется приложением как обычный участник: наказания, настройки и списки ему недоступны. Кнопки панели «Настройки», уже открытой в чате, в это время тоже ничего не меняют — бот ответит, что действие недоступно до конца мута. Права никуда не денутся и вернутся сами, когда мут закончится, а в других чатах они продолжают действовать.

В истории остаётся, кто выдал наказание, кто изменил срок и каким срок был до изменения. Первая запись задним числом не переписывается.

Наказание, выданное автоматически, может смягчить или снять любой модератор с нужным правом. А вот ручное наказание защита сама не сокращает — только продлевает, и то если её срок кончается позже.

О наказаниях из приложения и об их снятии в чат не сообщается: результат виден в самом приложении, а запись остаётся в истории. Когда срок мута, бана или временного предупреждения кончается сам, в чат приходит сообщение — один раз: «У ivan истёк срок мута». Если наказание продлили, изменили или сняли раньше срока, такого сообщения не будет; у бессрочного наказания его не бывает вовсе.

В сообщениях о наказании и о его снятии имя участника не называется: сказано, что произошло, до какого времени и по какой причине. Имя есть только в сообщении об окончании срока — иначе непонятно, у кого он кончился. Ник в нём кликабельный и ведёт на профиль, но это не упоминание: уведомление человеку не придёт.

Порог предупреждений

Когда действующих предупреждений наберётся столько, сколько задано, мут или бан выдаётся сам. Пороги задаёт владелец чата в приложении управления чатом: «Настройки» → «Наказания» → «Порог предупреждений». Пороги мута и бана задаются отдельно: видно, на каком предупреждении выдаётся мут и на какой срок, а на каком — бан. Ноль выключает порог, и там же есть общий переключатель «Выключить пороги предупреждений».

До порога считаются только действующие предупреждения. Истёкшее или снятое модератором на наказание больше не влияет, хотя запись о нём в истории остаётся.

Антифлуд и защита чата

Антифлуд сообщений

Антифлуд — это несколько отдельных проверок, и каждая включается сама по себе: приложение управления чатом → «Настройки» → «Антифлуд».

В новом чате антифлуд выключен. Бот сначала просто работает, а защиту от флуда владелец включает сам, когда она понадобится, — одним переключателем «Антифлуд включён». В чатах, где он уже был включён, ничего не изменилось.

• Частота сообщений — слишком много сообщений подряд за короткое время. Один такой всплеск — замечание; поток, который не остановился и продолжается столько же времени снова, удаляется.
• Одинаковые сообщения — повтор одинакового или почти одинакового текста подряд.
• Капс — длинные сообщения почти целиком заглавными буквами.
• Повторяющиеся символы — длинные ряды одного и того же символа, например «!!!!!!!!».
• Медиафлуд — слишком много фото, стикеров, видео и файлов за короткое время.
• Слоу-мод — участник может писать не чаще одного сообщения за выбранный промежуток времени.
• Ограничение частоты команд — то же самое, но для команд: не больше одной за промежуток.

Если признаков набралось достаточно, участник получит предупреждение или мут, а сообщение может быть удалено. Давних активных участников проверка смотрит мягче; это касается всех проверок выше, кроме слоу-мода и ограничения частоты команд — у них жёсткий предел для всех одинаковый. Слабый сигнал поправка наказуемым не делает.

Первый всплеск за сутки мутом не наказывается. Лишние сообщения убираются, а в чат приходит короткое замечание: «Олег, слишком много фото подряд. В следующий раз будет мут на час.» Срок в замечании — тот же, что стоит в настройках чата. Остальные сообщения того же всплеска просто удаляются — второго замечания не будет, человек ещё не успел прочитать первое. Следующий всплеск — обычный мут.

Мут за флуд выдаётся один раз на всплеск. Пока он действует, следующие сообщения того же всплеска просто удаляются: второго мута не будет, и второго сообщения бот в чат не пришлёт. Как только мут снят — командой «Размут», окончанием срока или снятием ограничения прямо в Телеграме, — счёт начинается заново: следующий всплеск снова начнётся с замечания, а за ним пойдёт мут с обычным сроком из настроек чата.

Владельца чата и администраторов всё это не касается: их сообщения убираются, если всплеск подтверждён, но ни наказания, ни замечания в чат они не получают.

В приложении можно включить или выключить весь антифлуд целиком и настроить частоту сообщений, проверку медиа, длительность мута и защиту от повторяющегося текста. Неподходящее значение приложение сохранить не даст. Отдельной команды в чате у антифлуда нет: и настройки, и текущие значения — в приложении.

Управлять антифлудом может владелец чата или модератор с правом «Антифлуд и новички».

Антирейд

Антирейд настраивается в приложении: «Настройки» → «Защита» → «Антирейд». Если за выбранное время в чат зайдёт много людей, бот включит режим рейда и временно закроет вход для новых участников. Владельцу придёт сообщение о начале и о завершении рейда. Настроить антирейд может только владелец.

Капча

Капча включается в приложении: «Настройки» → «Защита» → «Капча для новых участников». После входа участнику нужно успеть нажать «Я не бот», иначе бот исключит его из чата. Настроить капчу может только владелец.

Ограничения для новичков

В приложении можно выбрать, какие сообщения временно запретить новым участникам и как долго это продлится: «Настройки» → «Новички». Это не наказание: ни мута, ни бана, ни предупреждения новичок не получает, а обычный текст пишет свободно.

Работает это двумя способами, и разница видна в чате.

• Сообщение не отправится — фото, видео, музыку, файлы, голосовые, видеосообщения, опросы, а также стикеры, GIF и inline-контент. Телеграм не даст их отправить, и в чате они не появятся.
• Сообщение появится и исчезнет — ссылки, контакты, геолокация, пересланные сообщения и другое медиа: кубики, игры, истории, платное содержимое, розыгрыши. Их Cerswe удаляет уже после отправки.

«Стикеры, GIF и inline-контент» — одна настройка: вместе со стикерами и GIF новичок не сможет отправить игры и результаты inline-ботов.

Срок отсчитывается от момента вступления: по умолчанию час, а задать можно от минуты до 60 дней. Есть и готовые наборы — «Только текст» и «Без медиа». Когда срок выйдет, вернутся ровно те права, что были: запрет, который администратор поставил участнику вручную, и общий запрет чата никуда не денутся. Владельца чата, администраторов Телеграма и модераторов Cerswe ограничения не касаются. Если Cerswe не знает, когда человек вступил, ограничения на него не действуют.

Сторонние боты

Добавление других ботов можно запретить или снова разрешить в приложении: «Настройки» → «Защита» → «Запрет сторонних ботов». Чтобы менять эту настройку, нужно право «Добавление ботов».

Закрытие чата и ночной режим

• -чат и +чат — закрыть или открыть чат вручную. В закрытом чате обычные участники писать не могут: это запрет на уровне настроек самого Телеграма. Писать остаются владелец и администраторы чата; модератор Cerswe без статуса администратора Телеграма — нет. +чат возвращает те права чата, которые были до закрытия.
• Ночной режим закрывает чат по времени сам. Включить и выключить его можно в приложении: «Настройки» → «Ночной режим»; там же задаётся время начала и окончания, с точностью до минуты. В чате то же самое делает команда ночь 22:30 2:15 (целые часы тоже принимаются: ночь 23 7). Окно может лежать внутри одних суток, например с 12:00 до 23:00, а может переходить через полночь. Минута начала уже считается ночной, минута окончания — нет. Если начало и окончание совпадают, ночной режим чат не закроет.
• Чат, закрытый вручную, ночной режим не откроет. И наоборот: если чат открыли вручную посреди ночного окна, до конца этого окна ночь его больше не закроет.
• Закрывать и открывать чат может владелец и модератор с правом «Закрытие чата».
• Если у бота нет права менять настройки чата, закрыть чат не получится: об этом придёт сообщение, и состояние чата не изменится.
• Часовой пояс чата для ночного режима и статистики задаётся в приложении: «Настройки» → «Ночной режим» → «Часовой пояс чата». Его меняет только владелец.

Исключения

Исключение избавляет участника от автоматических действий выбранной защиты. Виды исключений: автомодерация (это антифлуд, стоп-слова и ссылки), nsfw-защита, антирейд, чёрный список, ограничение команд, ограничения новичков и всё сразу. Добавить, посмотреть и снять исключения можно в приложении: «Модераторы» → «Исключения», либо кнопкой «Исключения из проверок» в профиле участника. Там выбираются участник, вид исключения и срок: бессрочно, 1 час, 1 день, 7 дней или 30 дней. Это доступно только владельцу чата.

Исключения nsfw-защита и всё выдаются только там, где NSFW-защита есть, то есть в чате с Premium: исключение из защиты, которой у чата нет, не создаётся.

NSFW-защита

NSFW-защита работает только в чатах с Premium.

Проверка смотрит медиа в чате и убирает только то, в чём уверена. Спорное остаётся в чате и показывается владельцу.

Что проверяется

Фото, GIF, стикеры (включая анимированные и видеостикеры), видео, видеосообщения-кружки, а также изображения и видео, отправленные файлом.

Проверяются медиа из сообщений чата. Сам файл после проверки не хранится — остаётся только её результат: что бот решил и что сделал.

Что происходит после проверки

• Признаков нарушения нет. Сообщение остаётся в чате, ничего не происходит.
• Случай спорный. Ничего не удаляется и никто не получает наказание. Сообщение остаётся в чате, а владельцу приходит просьба посмотреть самому.
• Нарушение подтверждено. Сообщение удаляется, а участник получает наказание по настройкам чата — сначала муты растущей длительности, затем временная и постоянная блокировка.

Так происходит на всех трёх уровнях. Уровень влияет только на то, насколько рано проверка признаёт нарушение, а не на то, что будет дальше.

Уровни защиты

• Мягкий. Проверка терпимее: удаляет реже, но и пограничное чаще остаётся в чате.
• Обычный. Середина между мягким и строгим.
• Строгий. Проверка срабатывает раньше: нарушений подтверждается больше, и владельцу чаще приходят сообщения.

Спорные случаи на строгом уровне тоже не удаляются. «Строгий» не означает «удалять всё подозрительное».

Почему бот иногда не удаляет очевидное

Иногда нарушение кажется очевидным, но одного подозрительного признака боту мало. Если проверка сомневается, сообщение останется в чате, а владелец увидит результат и сможет разобраться.

Видео проверить сложнее: короткий эпизод в середине ролика иногда остаётся незамеченным, и полностью исключить пропуск не получится.

Цвет волос, стиль рисунка, телосложение, одежда или поза сами по себе нарушение не доказывают. Если файл повреждён или бот не умеет его открыть, нарушением это не считается и ничего не удаляется.

Изображения и видео не сохраняются и не используются для обучения.

Где настраивается

Приложение управления чатом → «Настройки» → «NSFW-защита»:

• один переключатель включает защиту сразу для изображений и видео;
• уровень: мягкий, обычный или строгий;
• исключения — участники, чьи медиа не проверяются; добавить и снять их можно в разделе «Модераторы» → «Исключения».

Чёрный список и ПРЕ-бан

У каждого чата свой чёрный список. Человека из списка бот блокирует в момент входа — это и есть ПРЕ-бан, — и сообщает об этом владельцу чата.

Управление — в приложении управления чатом

Откройте приложение — словом настройки в чате или кнопкой меню Телеграма в личных сообщениях — и перейдите в раздел «Чёрный список». Это доступно владельцу чата и модераторам с правом «Чёрный список».

• Добавить участника — с причиной и сроком или бессрочно.
• Убрать запись и посмотреть историю действий по участнику.
• Там же — чёрный список каналов этого чата.

Из личных сообщений с ботом чёрным списком управлять нельзя.

Каналы

У каналов свой список, в том же разделе приложения. Со сроком запись временная, без срока — бессрочная.

Ограничения Телеграма

Если человек скрыл свой аккаунт в настройках приватности, найти его в приложении можно только по числовому ID.

Владельца чата и тех, у кого есть исключение «чёрный список», бот при входе не блокирует.

Статистика и активность

В статистику попадают сообщения, которые остались в чате: текст, фотография, стикер или команда модерации. Каждое считается за одно — правила одинаковые для участника, модератора и владельца. Команда вдобавок учитывается как команда, но дважды её не считают: прибавлять её к общему числу отдельно не нужно.

Сообщение, удалённое защитой, в статистику не попадёт, даже если это была команда. То же самое с сообщениями, которые убрал сам бот (например по команде «Очистить»), модератор, антифлуд или запоздавшее решение проверки изображений. Входы и выходы участников тоже не учитываются: это не сообщения.

День считается по часовому поясу чата: приложение → «Настройки» → «Ночной режим» → «Часовой пояс чата». По умолчанию это UTC.

Команды, доступные всем

Топ активности

• Топ за день, Топ за неделю, Топ за месяц, Топ за 3 месяца, Топ вся, Топ 3 дня, Топ 2 недели, Топ 10 дней — активность чата за период: сколько было сообщений и сколько человек писали, до 30 самых активных участников и разбивка по дням.

«Месяц» — это последние 30 дней, включая сегодня, а «3 месяца» — последние 90 дней. «Топ месяца» и «Топ за месяц» показывают одно и то же, как и «Топ 3 месяца» с «Топ за 3 месяца».

Если Cerswe считает в этом чате меньше, чем длится выбранный период, в карточке будут только те дни, за которые уже есть данные. Там же видно, с какого дня начался учёт.

Профиль

• Профиль — карточка участника картинкой прямо в чате: имя, роль, сообщения, место в топе и активность. В ней только то, что Cerswe знает о человеке. Подробный профиль с графиком активности есть в приложении чата.
• Профиль без ответа на чужое сообщение покажет ваш собственный профиль: сообщения, активные дни и предупреждения нарисованы на самой карточке. Чужие числа не показываются — сведения о других участниках остаются в приложении управления чатом, по правам.
• Профиль ответом на сообщение канала покажет карточку канала: название, юзернейм, тип — «Привязанный канал» или «Внешний канал» — и сколько сообщений канала в этом чате. В группе обсуждения Телеграм считает каждый комментарий ответом на пост канала, поэтому участник группы получит карточку канала вместо своей. Тем, кто комментирует, не вступая в группу, придёт их собственный профиль. Чтобы наверняка получить свой, отправьте Профиль без ответа на сообщение.

Топ за конкретный день

• Топ 2 марта, Топ 2 марта 2025, Топ 02.03 — активность за эту дату: участники и число их сообщений именно за тот день. Без года берётся ближайшая прошедшая дата. Команда доступна всем, как и остальные варианты топа.

Всё перечисленное выше — команды в чате. В приложении управления чатом есть свой раздел «Статистика», и набор периодов там другой: сегодня, 7 дней, 30 дней и всё время. Периоды команды и периоды этого раздела между собой не связаны.

Хранение

Сами тексты сообщений хранятся не дольше нескольких дней — они нужны антифлуду, чтобы находить повторы, — и удаляются сами. Счётчики активности остаются, но уже без текстов.

Настройки чата

Приложение управления чатом

Слово настройки в чате открывает приложение управления этим чатом. В личных сообщениях его открывает кнопка меню Телеграма рядом с полем ввода. В нём собраны все настройки с подсказками, а также участники, модераторы, правила, чёрный список и статистика.

Настройки меняет владелец чата, а отдельные разделы — модераторы с нужным правом. Посмотреть раздел и изменить его — разные права, поэтому бывает так: раздел виден, а менять в нём ничего нельзя.

Правила чата

• правила в чате — показать правила.
• В личных сообщениях слово правила показывает правила выбранного чата с кнопками «Изменить правила», «Предпросмотр» и «Сбросить к стандартным». Те же действия можно написать словами: изменить правила, предпросмотр правил, сбросить правила. В тексте правил работают оформление и ссылки. Изменить правила можно и в приложении управления чатом, раздел «Правила».

Жалобы участников

• Участник отвечает на сообщение словом жалоба, и владелец чата получает её в личные сообщения.
• Включить или выключить жалобы можно командами +жалобы и -жалобы либо в приложении: «Настройки» → «Наказания» → «Жалобы участников». Это доступно только владельцу чата. По умолчанию жалобы включены.

Сообщения

• Автоудаление служебных сообщений о входе и выходе — приложение → «Настройки» → «Защита».
• Тихий режим — приложение → «Настройки» → «Наказания». Пока он включён, бот не пишет в чат об автоматических действиях, но сами действия выполняются как обычно.

Стоп-слова и ссылки

• Стоп-слова — приложение → «Настройки» → «Защита» → «Стоп-слова». Там их можно добавить, убрать и выбрать, как сравнивать: отдельное слово, фраза, «содержит текст» или точное совпадение. Заглавные буквы, «ё» вместо «е» и лишние пробелы на проверку не влияют. Стоп-слова действуют на всех, включая владельца и модераторов, и срабатывают даже в сообщениях, которые начинаются со слова команды. Освобождает от них только исключение «автомодерация».
• Запрет посторонних ссылок включается там же, в разделе «Защита». Ссылки внутри Телеграма посторонними не считаются. Список разрешённых сайтов там же, пункт «Разрешённые ссылки».

Удаление данных

• удалить данные чата удаляет все данные этого чата из Cerswe. Бот спросит подтверждение, а отменить удаление потом нельзя.
• удалить мои данные в личных сообщениях удаляет ваши личные данные — сообщения, активность, имена, счётчики и собственный баннер профиля — у основного бота Cerswe и у всех собственных ботов пользователей. Записи о наказаниях и о чёрных списках при этом остаются: это журнал действий администрации чата.

История наказаний

Историю наказаний можно посмотреть в профиле участника в приложении управления чатом. Там видно, какое наказание выдали, когда, кто и на какой срок.

Частые ошибки и вопросы

«Мут не прошёл, потому что у Cerswe нет нужного права»

Без права «Блокировка участников» бот не может никого замутить. Выдайте его в настройках чата в Телеграме: «Администраторы» → Cerswe.

«Для этого действия не хватает прав»

Нужной категории прав у вас пока нет. Попросите владельца чата выдать её в приложении управления чатом, раздел «Модераторы».

«Эта команда доступна только владельцу чата»

Эта команда меняет настройки чата, поэтому доступна только владельцу — тому, кто создал группу.

Бот не отвечает на команды в чате

• Возможно, сработало ограничение частоты команд — подождите несколько секунд.
• Бот должен видеть сообщения. Пока он не администратор, Телеграм показывает ему только команды и ответы на его собственные сообщения — сделайте Cerswe администратором.

Чат закрыт, хотя ночь закончилась

Чат закрыли вручную командой -чат. Такой чат ночной режим не открывает — для этого есть команда +чат.

Изображение удалено, но оно не было запрещённым

Проверка могла ошибиться, а ещё в чате может быть выбран строгий уровень — на нём она реагирует раньше. Уровень защиты меняется в приложении управления чатом: «Настройки» → «NSFW-защита». Если сообщение удалено по ошибке, откройте в приложении Cerswe раздел «Помощь» и нажмите «Открыть бот поддержки».

Не могу найти участника в приложении

Телеграм не выдаёт ботам список участников группы, поэтому в поиске есть только те, кого Cerswe уже видел в этом чате: кто писал сообщения или вступил, пока бот был на месте. Cerswe не использует пользовательские аккаунты и не собирает списки участников в обход Телеграма.

Если нужного человека в поиске нет:

• нажмите «Выбрать в Телеграме». Такая кнопка есть у владельца чата при назначении модератора и у модератора с правом наказаний в разделе «Наказания». Откроется личка бота, где кнопкой «Выбрать участника» можно выбрать человека из своих контактов и диалогов; ссылка действует 10 минут, и Cerswe проверит, что выбранный состоит в чате;
• попросите человека написать любое сообщение в чат — после этого он появится в поиске;
• ответьте в чате на его сообщение командой, например мут 1 час;
• введите в поиске числовой ID, если вы его знаете: участник найдётся, если он сейчас в чате.

Если кнопка «Выбрать участника» в личке не работает и просто отправляет эти слова сообщением, обновите Телеграм: старые версии её не поддерживают.

Владелец чата не видит свой чат в личных сообщениях

Напишите любое сообщение в чате, где есть бот: после этого чат и его создатель запомнятся. Если бота удалили из чата, чат перестанет показываться.

Я хочу удалить свои данные

В личных сообщениях с ботом Cerswe отправьте удалить мои данные и подтвердите. Ваши личные данные удалятся у основного бота Cerswe и у всех собственных ботов пользователей, в том числе отключённых. Что именно останется — записи о наказаниях, платежи, обращения в поддержку и прочее — бот перечислит в подтверждении. Владелец чата может удалить все данные чата командой удалить данные чата, пока бот состоит в чате.

Если бота уже удалили из чата или собственный бот отключён, владелец чата может попросить удалить данные чата в поддержке @cersweSupport_bot. Там же можно попросить удалить свои личные данные — только за себя. Удаление выполняет вручную владелец Сервиса после проверки. Владелец бота удалить данные чужого чата не может.

Платежи и подписка

Уровни доступа

У Cerswe три уровня:

• Бесплатно — модерация, антифлуд, чёрные списки и ПРЕ-бан, приложение управления чатом и вся статистика чата: и активность участников, и работа модераторов. Это работает в любом чате, без оплаты.
• Premium — платный тариф для одного чата. Он открывает единственную платную функцию: NSFW-защиту. Бот проверяет изображения, стикеры и видео из сообщений чата, а в статистике видно, сколько нарушений и участников она нашла.
• Custom Pro — уровень на человека, а не на чат: один собственный бот, все возможности Premium в его чатах и личный баннер профиля. Баннер виден на карточке профиля в чате; в чатах, где владелец выбрал текстовый вид карточек, карточки нет — и баннера тоже. Платят звёздами Телеграма раз в 30 дней, с автопродлением, и цену видно до оплаты. Если выключить продление, новых списаний не будет, а доступ доработает до конца оплаченного периода. Вернуть звёзды можно по тем же правилам, что и за Premium.

Custom Pro и Premium чата — разные подписки. Пока у владельца собственного бота действует Custom Pro, оформить отдельный Premium для чатов этого бота нельзя: возможности уже открыты, и платить за них второй раз не нужно. Это проверяется и в момент оплаты: по старой кнопке или старой ссылке на счёт деньги не спишутся.

Premium оформляет владелец чата, и работает он только в этом чате. Платят звёздами Телеграма, не выходя из Телеграма: цену видно до оплаты, период — 30 дней, продление автоматическое. Cerswe не запрашивает данные карт и не хранит платёжные реквизиты.

Как оформить

1. Откройте приложение Cerswe → «Подписка» → ваш чат. Это доступно владельцу чата. Подпиской управляют только в приложении, а в личные сообщения приходит кнопка, которая его открывает.
2. Нажмите «Оформить Premium». Приложение покажет цену и срок, а затем откроется счёт на указанное число звёзд.
3. Как только оплата подтвердится, Premium включится, и придёт сообщение с состоянием подписки.

Дальше подписка продлевается сама раз в 30 дней, списание проходит в Телеграме. Цена закрепляется на момент покупки: если тариф подорожает, уже оформленной подписки это не коснётся.

Как отменить автопродление

Приложение → «Подписка» → ваш чат → «Отменить автопродление». Оплаченный период доработает до конца срока, и только потом Premium отключится. Пока период не закончился, продление можно включить обратно кнопкой «Снова включить автопродление». Отменить подписку можно и в настройках Телеграма.

Автопродление выключается само, если чат больше некому вести: владелец удалил данные чата; собственный бот, который работал в этом чате, остановлен владельцем, приостановлен без Custom Pro или отключён от Cerswe; либо токен такого бота перестал действовать и трое суток никто не поставил новый. Оплаченный период и здесь сохраняется до конца срока, плательщику приходит сообщение, и включить автопродление снова может только он сам.

Я плачу за Premium в чате, а бот принадлежит другому человеку с Custom Pro

Premium в этом чате держится сразу на двух основаниях: Custom Pro владельца бота и ваша оплаченная подписка. Так бывает, если подписку чата оформили раньше, чем владелец бота оформил Custom Pro. Оплаченный период не пропадает и не сокращается, Cerswe его не отменяет. Если платить за то, что и так открыто, не хочется, отключите автопродление в разделе «Подписка» — оплаченный период останется до конца срока. А если Custom Pro владельца бота закончится, ваша подписка продолжит держать Premium в чате. О таком совпадении Cerswe пишет плательщику один раз.

Что будет после окончания периода

Если автопродление выключено, по окончании оплаченного периода Premium отключится: NSFW-защита и её статистика перестанут работать. Бесплатные функции останутся, в том числе вся статистика чата. Об окончании подписки придёт сообщение, а оформить Premium заново можно в разделе «Подписка».

История платежей и помощь с оплатой

Приложение → «Подписка» → «История платежей» показывает ваши платежи, включая Custom Pro: дату, тариф, число звёзд, статус и возврат, если он был. Чужие платежи там не показываются.

Если с оплатой что-то не так, откройте историю платежей и напишите в поддержку @cersweSupport_bot. Если вопрос про конкретный платёж, пришлите сотруднику его номер из истории — по нему платёж найдут.

Возвраты

Вернуть звёзды можно в течение 24 часов после подтверждённой оплаты: приложение → «Подписка» → чат → «Вернуть звёзды». Каждое автоматическое продление — отдельный платёж, и его тоже можно вернуть в течение 24 часов после списания. Сам возврат проходит в Телеграме. Если ответ не пришёл сразу, Cerswe проверит возврат сам и сообщит результат — повторять запрос не нужно.

После возврата Premium, оплаченный этой покупкой, прекращается, а автопродление отключается. Если у чата есть другое основание для Premium, он останется. Если за 7 дней вернуть звёзды три раза или больше, на 30 дней закроются новые покупки Premium и Custom Pro, а также повторное включение их автопродления. Уже оплаченные периоды это не затрагивает.

Отмена автопродления звёзды не возвращает, а оплаченный период остаётся активным до конца срока. Если вернуть звёзды самостоятельно не получается, напишите в поддержку через приложение Cerswe, раздел «Помощь».

Добровольный возврат по истечении 24 часов рассматривается и выполняется только по решению администрации. Это не ограничивает рассмотрение обоснованных претензий по оплате и возвраты, обязательные по применимым правилам.

Ошибка при оплате

Если счёт не открылся или устарел, оформите его заново в приложении, раздел «Подписка»: счёт действует один час. Если звёзды списались, а Premium не появился, подождите — Cerswe регулярно проверяет такие платежи и доведёт покупку сам. Если за час этого не произошло, напишите в поддержку и укажите номер платежа из истории.

Собственные боты

Что это

Собственный бот входит в уровень Custom Pro, который оформляется на человека, а не на чат. К Cerswe можно подключить своего бота, созданного в @BotFather. После подключения он работает как отдельный бот: со своими чатами, настройками, модераторами и статистикой. Пока действует Custom Pro, в чатах вашего бота открыты все возможности Premium — то есть NSFW-защита и её статистика, — и отдельно оформлять Premium для этих чатов не нужно. Данные разных ботов не пересекаются, даже если они работают в одном чате.

Custom Pro оплачивается звёздами Телеграма раз в 30 дней, с автопродлением; цену видно до оплаты. Кроме собственного бота и возможностей Premium в его чатах, в него входит личный баннер профиля: он виден на карточке профиля в чате, а в чатах с текстовым видом карточек карточки нет — и баннера тоже. Если выключить продление, новых списаний не будет, а доступ доработает до конца оплаченного периода. Вернуть звёзды можно по тем же правилам, что и за Premium.

Как подключить

1. Создайте бота в @BotFather командой /newbot и скопируйте токен.
2. Откройте приложение Cerswe — кнопкой меню Телеграма в личных сообщениях или кнопкой «Открыть Cerswe» под ответом на /start — и выберите «Мои боты» → «Подключить бота». Отдельной команды для этого нет.
3. Вставьте токен. Cerswe проверит его в Телеграме и покажет найденного бота. Подтвердите подключение — бот сохранится и запустится.
4. Добавьте бота в свой чат кнопкой «Добавить бота в чат» и выдайте ему права администратора: «Удаление сообщений» и «Блокировка участников». Без них модерация не работает, и приложение покажет, каких прав не хватает.

Токен хранится в зашифрованном виде и больше нигде не показывается. Если он не подошёл, проверьте его в @BotFather и попробуйте ещё раз.

Управление

В карточке бота собраны его чаты, права, статистика и текущее состояние. Оттуда же бота можно остановить, перезапустить, обновить ему токен или отключить. По состоянию видно, запускается бот, работает или остановлен, нужен ли ему Custom Pro или новый токен и не случилось ли ошибки подключения.

Владение ботом не даёт прав в чатах. Настройками, модераторами и наказаниями в чате управляют его владелец в Телеграме и назначенные им модераторы.

Если что-то пошло не так

• «Требуется обновить токен» — токен отозвали или изменили в @BotFather. Вставьте в карточке бота новый токен того же бота.
• «Ошибка подключения» — бот несколько раз подряд не смог выйти на связь. Проверьте бота и нажмите «Перезапустить». Ошибка одного бота на другие не влияет.
• «Требуется Custom Pro» — подписка закончилась или была возвращена. Бот приостановлен, а настройки и чаты сохранены. После продления он запустится сам. Посмотреть и отключить такого бота можно и без Custom Pro.
• Токен вводить заново не нужно: подключённый бот остаётся подключённым, пока вы сами его не отключите.

Лимиты

Подключить можно одного собственного бота. Место занято, пока бот подключён, в каком бы он ни был состоянии: работает, остановлен, приостановлен, с ошибкой или с недействующим токеном. Освобождает место только «Отключить бота», так что для другого бота сначала отключите текущего. Замена токена тому же боту место не освобождает и не занимает, а Premium чата на это никак не влияет.

Ограничено и число чатов на одного бота, и то, как часто можно подключать, менять токен, запускать, останавливать, перезапускать и отключать бота.

Отключение

«Отключить бота» спросит подтверждение, а затем остановит бота, удалит его токен и освободит место. Настройки, модераторы, чёрные списки и статистика чатов сохраняются. Автопродление Premium в чатах этого бота отключится, а оплаченный период останется. Подключить того же бота можно позже снова.

Удаление данных чатов собственного бота

Отключение бота данные его чатов не удаляет. Попросить об удалении может только владелец этого чата — тот, кто создал его в Телеграме. Это касается и чатов отключённого бота, и чатов, из которых бота удалили. Напишите в поддержку @cersweSupport_bot: удаление выполняет вручную владелец Сервиса после проверки. Владелец бота удалить данные чужих чатов не может, даже если эти чаты вёл его бот.

Участник чата собственного бота удаляет свои личные данные командой удалить мои данные в личных сообщениях с ботом Cerswe. Писать то же самое каждому собственному боту не нужно: одна команда удаляет данные и у всех собственных ботов пользователей, включая отключённых. Об этом же можно попросить через @cersweSupport_bot — только за себя.

Как обратиться в поддержку

Поддержка Cerswe работает в отдельном боте @cersweSupport_bot. Отвечают сотрудники, автоматических ответов там нет.

Что делать

1. Откройте @cersweSupport_bot и нажмите «Написать в поддержку».
2. Опишите, что случилось. Можно приложить снимок экрана — отправьте его фотографией.
3. Бот спросит: «Передать это сообщение сотруднику поддержки?» Обращение появится только после кнопки «Отправить»; «Отмена» ничего не создаёт.
4. После подтверждения создаётся одно обращение, даже если нажать «Отправить» дважды. Дальше переписка идёт в том же чате — вспомнили подробности, просто напишите туда.

Срок ответа Cerswe не обещает: сотрудники отвечают по мере разбора обращений.

Пока обращение открыто, второе не создаётся — пишите в то же. После закрытия новое можно открыть не раньше чем через час. Если этот час истекает, когда приём уже закрыт по часам работы, ждать придётся до их начала — бот назовёт точное время. На переписку в уже открытом обращении это не влияет.

Часы работы

Новые обращения принимают в часы работы поддержки — они указаны в самом боте. Вне этих часов обращение не создаётся, а бот скажет, когда приём откроется.

Переписка по уже открытому обращению идёт в любое время: часы ограничивают только создание новых.

Что происходит с сообщением

• Текст обращения и снимки экрана видят сотрудники поддержки.
• Перед отправкой бот ищет в тексте то, что явно похоже на секрет: токены ботов и токены доступа, ключи API, приватные ключи, ссылки с логином и паролем, данные сессии, пароли, одноразовые коды, номера карт и сид-фразы. Найденное он закрывает пометкой ещё до отправки — в обращение и к сотруднику попадает уже закрытый текст. Вам он при этом покажет, что именно нашёл, и подскажет, что делать: перевыпустить токен, сменить пароль, перевести средства на новый кошелёк.
• Это защита от очевидных случаев, а не гарантия: секрет, записанный необычно или разбитый на части, бот не заметит. Пароли, коды подтверждения и номера карт присылать в поддержку не нужно — сотрудникам они ни к чему.
• Внешним поставщикам ИИ Cerswe пользовательские данные не передаёт.

Полные условия — в Политике конфиденциальности.

Сколько хранится переписка

• Обращения и переписка по ним хранятся, пока работает Сервис или пока вы не попросите их удалить.
• Технические журналы работы Сервиса — 30 дней. Текстов обращений в них нет.
• Уже созданные резервные копии базы удаляются по своему сроку, обычно около двух недель.

Попросить удалить данные поддержки можно в самом @cersweSupport_bot — только за себя. Удалят ваши обращения и переписку по ним, неотправленный черновик и уведомления об ограничениях. Останутся ограничение доступа к поддержке, если сотрудник его выдал (удаление данных его не снимает), и журнал действий сотрудников — в него же попадает запись о самом удалении. Удаление выполняет вручную владелец Сервиса.

Команда удалить мои данные в личных сообщениях с Cerswe данные поддержки не трогает: это отдельный бот со своей базой, и попросить нужно именно в нём.