Сообщение
Адресаты
Клик по аудитории добавляет её чаты, повторный клик убирает ровно их. Галочки ниже служат для ручной донастройки. Адресаты — это галочки плюс список id в поле под чатами: рассылка уходит в объединение.
Чаты «не админ» не получат сообщение, пока боту не выдадут права. Добавленные в чат группы появляются здесь сами.
Календарь
Клик по дню открывает задания этого дня. Наведение на событие показывает окошко с его подробностями: полное сообщение, картинка, повтор, число адресатов и пометка дня. Календарь живой: запущенные, завершённые и пропущенные задания перекрашиваются сами, без перезагрузки страницы.
Задания
Новое задание
Адресаты выбрано 0
Чаты, где состоит бот
| Чат | chat_id | Бот-админ | В рассылке | Аудитории | Активность |
|---|
Аудитории
| Название | Описание | Чатов |
|---|
Состав:
Шаблоны
| Название | Тип | Формат | Символов | Обновлён |
|---|
Шаблон — заготовка текста с разметкой: в «Рассылке» он подставляется целиком. Вставка — короткий кусок (набор @username, контакты, подпись): он добавляется в текст редактора через список «Вставить» в тулбаре.
Новый шаблон
Наборы смайлов
Вставьте ссылку на набор из Telegram (https://t.me/addemoji/<имя>)
или просто его имя — панель спросит набор у бота и добавит его во вкладку
«Кастом-эмодзи» в пикере смайлов. Картинки скачиваются один раз и лежат на сервере;
анимированные в панели показаны статичной картинкой, в Telegram они оживают.
| Название | Имя в Telegram | Смайлов | Анимация | Добавлен |
|---|
Заводской набор @tatyemoji вшит в панель и не удаляется.
История рассылок
| # | Дата | Сообщение | Отправлено | Ошибки | Статус |
|---|
Кампания
| chat_id | Группа | Тема | Статус | Попытки | Ошибка |
|---|
Выгрузка аналитики
Реестр встреч (.xlsx, лист «реестр») → по каждому показателю план/факт и процент по области и по каждому агенту, текст для чата и картинка. Сам реестр остаётся на сервере панели; в Telegram уходит только то, что вы отправили кнопкой «Отправить в чаты».
Чипы включают показатели в выгрузку. «Динамика» необязательна: с ней каждая строка покажет «было → стало».
Показатели
Знаменатель и числитель — условия вида
Колонка: значение, значение, по одной строке на условие: строка
попадает в знаменатель, если выполнили все его условия, и в числитель — если
выполнили все условия числителя. Колонки берутся из загруженного реестра,
опечатку сервер не примет.
Текст для чата
Карточка
Итог по агентам
Отчёт — картинкой и текстовым блоком
Идёт тем же ботом в чаты из списка панели: каждая страница — своя кампания, она видна в «Истории» и перезапускается оттуда, если доставка упала. Картинка совпадает с превью слева, включая тему.
Рейтинг по агентам
Рейтинг — среднее арифметическое процентов по включённым показателям. Пункт с пустым знаменателем в деление не входит: у агента без анкет КК рейтинг считается по остальным, а не обнуляется. По каждой области — три лучших и три худших; если агентов в области три или меньше, худших не показываем, это те же люди.
Доступ к панели
Пользователь пишет боту /request, заявка
появляется здесь. Одобрить её, назначить роль, завести учётку для входа по
паролю — всё это права раздела «Доступ», а кому они доступны, решает роль.
Пользователи Telegram
| Telegram ID | Имя | Username | Роль | Заявка |
|---|
Учётки входа по паролю
Входят на странице входа во вкладке «По паролю», без Telegram
и без бота. Логин — строчные латинские буквы, цифры и . _ -;
пароль не короче 10 символов.
| Логин | Имя | Роль | Создана | Последний вход |
|---|
Новая учётка
Роли и права
Роль — это набор прав. Снимете право — у всех, кто в этой роли, раздел и кнопки пропадут при следующем запросе, перелогиниваться не нужно. Встроенные роли меняются по правам, но не удаляются.
| Роль | Ключ | Аккаунтов | Права |
|---|
Роль
Мой пароль
Активные сессии
| Токен | Кто | IP | Истекает |
|---|
Подписка и тарифы
Тариф — это то, что клиент купил: срок, объёмы и какие разделы ему вообще включены. Подписка надевает тариф на одну учётку на срок. Роль при этом остаётся своей: итоговые права — пересечение роли и тарифа.
Тарифы
| Тариф | Цена | Срок | Лимиты | Разделы | Роль | Подписок |
|---|
Новый тариф
Ноль в лимите — «без ограничения». Пустой список разделов — тариф ничего не срезает от роли; отмеченные разделы оставляют только их.
Выбранная роль выдаётся аккаунту, когда оформляете подписку этого тарифа, а при отмене или истечении возвращается прежняя. Роль — это права, которых у человека до оплаты не было, поэтому после отмены подписки они оставаться не должны.
Подписки
| Кому | Тариф | С | По | Статус | Кем оформлена | Заметка |
|---|
Подписка
Окончание подставляется само: начало плюс срок тарифа. Поправьте датой, если догоняете просрочку или делаете скидку днями.
Сообщения
Личная переписка между учёток панели: оператор с администратором, администратор с клиентом. Диалог виден только его двум участникам — ни роль, ни право «Доступ» чужой переписки не открывают.
С кем написать
0 — не удалять ничего. Любое другое значение убирает сообщения старше стольких суток вместе с картинками; удаление происходит сразу при сохранении и потом каждый час.
Справка по панели
Панель — интерфейс к одному Telegram-боту. Бот знает чаты, в которых состоит, отправляет в них сообщения по вашему списку адресатов и умеет запускать рассылку в назначенное время. Всё, что вы меняете здесь, влияет на реальные сообщения.
/login) пароля не передаёт.
1. Вход и кто что имеет право делать
- Открыть панель → «Получить код входа». На экране появится шестизначный код, живёт он 10 минут, привязан к вашему IP и одноразовый.
- Написать боту в личном чате
/login КОД. Бот проверит код — и панель сама пустит вас внутрь. - Если доступа нет:
/request→ заявка появится в консоли, на «Доступе». Одобрить её может тот, у кого есть право «Доступ → одобрять заявки»; после одобрения повторите/login.
Второй способ — вкладка «По паролю»: учётку для него заводит руками кто-то с тем же правом, в том же разделе «Доступ». Вход не связан с Telegram и нужен, когда бот недоступен или код получить нечем.
Что человек видит и может — это его роль. Роль представляет из себя набор прав, а право соответствует одному действию панели: «вкладка Чаты», «включать и выключать чат», «редактор определений показателей» и так далее. Права проверяет сервер, а не кнопки: спрятанная кнопка — удобство, а запрос без права всё равно получит отказ.
| Кто | Как появляется | Что может |
|---|---|---|
| Гость | написал боту, но не отправлял /request |
только смотреть на страницу входа |
| Заявка | /request | ничего — ждёт одобрения |
| Любая роль | её назначили при одобрении заявки или позже в списке | ровно то, что входит в набор прав этой роли |
| Супер-администратор | встроенная роль, выдаёт её только супер-администратор | все права, включая те, что появятся в следующих версиях панели |
Встроенные роли: «Супер-администратор», «Оператор» (вся работа с рассылками, но без «Доступа», «Наборов», чужих тарифов и срока хранения переписки) и «Наблюдатель» (только смотреть). Их можно менять, свои — создавать. Права, которые появились в новой версии, в уже заведённые роли сами не добавляются. См. раздел 12.
Сессия живёт 7 дней. «Выйти» в шапке закрывает её досрочно.
2. Свои вкладки: порядок, папки, тема
Разделы сверху — не фиксированный список. Каждый пользователь расставляет их сам, и раскладка хранится на сервере именно за вами: на другом компьютере или после очистки кэша вкладки останутся там, где вы их поставили.
- Порядок. Взять плитку раздела мышью и перетащить вдоль строки — до или после соседа. Синяя полоска показывает, куда он встанет; крайний справа участок строки — «в конец».
- Папки. «+ папка» создаёт пустую, дальше раздел перетаскиванием бросается внутрь неё. Папка сворачивается: клик по ней раскрывает вторую строку с её разделами, повторный клик сворачивает обратно. Так же перетаскивается и сама папка, а раздел из второй строки можно вернуть наверх.
- Тема. «◐ тема» в шапке — тёмная или светлая окраска.
- Сброс. «↺ порядок» возвращает заводской порядок. Данные это не трогает, только раскладку.
Подпись справа от кнопок говорит, что раскладка сохранена. Ограничения сервера: до 20 папок, до 60 разделов в строке и в папке, имя папки до 40 символов.
Ссылка «Консоль» в шапке появляется у того, у кого есть право на «Наборы» смайлов (раздел 10) или на «Доступ» (раздел 12). Это отдельная страница с теми же разделами: у остальных её не будет, а прямой адрес вернёт на главную.
3. Рассылка: шаг за шагом
- Сообщение. Набрать текст в редакторе (см. раздел 4). Можно сразу выбрать готовый шаблон в списке «Шаблон» — текст подставится в поле.
- Картинка — по желанию. Кнопка «Картинка» в панели инструментов или обычный Ctrl+V скриншота прямо в поле текста. С картинкой сообщение уходит как фото с подписью, а лимит подписи падает с 4096 до 1024 символов.
- Адресаты. Справа: клик по чипу аудитории добавляет её чаты к текущему выбору (повторный клик убирает ровно их, ручные отметки остаются), дальше состав можно поправить галочками вручную. Поиск ищет по названию чата, «Все» и «Никто» отмечают весь видимый список. Отмеченное переживает поиск, «Обновить» в «Чатах», переключение вкладок и правку состава аудитории. Автоматически ничего не выбирается: рассылка пойдёт только туда, где стоит галочка или где id стоит в поле.
- Если чата нет в списке — ниже есть поле для списка
chat_id: вставьте номера через пробел, запятую или с новой строки (узнать id —/idв нужном чате). Поле и галочки — два независимых списка адресатов, в рассылку уходит их объединение, а счётчик сверху показывает разбивку «галочками N, в поле M». Знакомый чат из поля отмечается галочкой в списке. Снять адресата можно с любой стороны: убрать id из поля — он снялся, если только отмечен галочкой; снять галочку — id вычёркивается и из поля. «Никто» убирает видимые чаты из обеих сторон, но id, которых нет в списке чатов, не трогает — такие адресаты остаются, и счётчик это показывает. Незнакомый панели id всё равно становится адресатом, а при отправке попадёт в «Ошибки» кампании, если бот в таком чате не состоит. За одну кампанию — не больше 5000 адресатов. - Запустить рассылку. Появится полоса прогресса и счётчик «отправлено / ошибок / пропущено». «Остановить» прерывает очередь, уже отправленное не отзывается.
Скорость ограничена Telegram: примерно 20 сообщений в секунду на бота и не чаще одного в секунду в один чат. Ошибки сети бот повторяет до 4 раз. Большая рассылка — это минуты, а не секунды: вкладку можно закрыть, отправка продолжится на сервере.
Чаты с пометкой «не админ» сообщение не получат, пока боту в группе не выдадут право публиковать.
Группы с темами. Если у чата включены темы (форум), под его строкой появляются чипы: «общая» и каждая тема, которую видел бот. Без отметок уходит в общую тему — как раньше; отметьте чипы — и на каждую тему пойдёт своё сообщение. Счётчик адресатов считает темы отдельно: чат с двумя темами — два адресата, и лимит тарифа тоже расходится по ним. Колонка «Тема» в деталях кампании говорит, куда именно лёг каждый адресат; у удалённой или закрытой темы — ошибка доставки с явной подписью.
4. Редактор: форматы, выход из формата, режим «теги»
Редактор показывает текст так, как его увидит читатель, а не теги.
Порядок кнопок сверху: / / (служебные теги), смайлы,
Жирный, Курсив, Подчёркнутый, Зачёркнутый, Спойлер, Код, Блок кода,
Ссылка, Цитата, Картинка, список вставок.
| Действие | Что произойдёт |
|---|---|
| Выделить текст и нажать кнопку формата | выделение обернётся в формат |
| Поставить курсор и нажать кнопку | появится серая подсказка формата; то, что вы напечатаете, станет форматированным. Второе нажатие на кнопку до начала ввода удаляет пустую подсказку |
| Нажать ту же кнопку второй раз, когда текст уже набран | выход из формата: набранное остаётся форматированным, а всё, что напечатано после клика, — обычным текстом |
| Enter внутри формата | выход из формата и новый абзац |
| Ctrl+V картинки / текста | картинка уходит на сервер как вложение, текст вставляется с сохранением разрывов строк |
Активная кнопка формата подсвечена — по ней видно, в каком режиме сейчас печатается курсор.
Что за кнопка / /. Переключает поле в режим разметки:
вместо «жирного» вы видите <b>жирного</b> (или
** для Markdown) и можете править теги руками. Возврат во
WYSIWYG разбирает разметку обратно; если тег битый или не поддерживается
Telegram, под полем появится предупреждение, а проблемное место останется
текстом — так сообщение не уйдёт обрезанным.
Формат рассылки (HTML или Markdown) выбирается один раз и действует во всех редакторах панели. Цитата доступна только в HTML.
5. Смайлы: мои, все, кастом-эмодзи
- Нажать 😊 в панели инструментов редактора — откроется пикер с тремя вкладками.
- «Мой набор» — то, что вы добавили себе. Клик по смайлу вставляет его в текст; чтобы положить сюда новый, вставьте его символ в поле внизу пикера и нажмите «+».
- «Все смайлы» — полный Юникод-набор по категориям.
- «Кастом-эмодзи» — авторские наборы картинками. В Telegram такой смайл может анимироваться; в панели он показан статичной картинкой, но в сообщении остаётся именно анимированным.
Смайл в тексте — плитка, но ведёт себя как один знак: выделяется мышью, копируется Ctrl+C, вырезается и удаляется Backspace как обычный символ. Клик по пикеру не уводит курсор: смайл встаёт туда, где он стоял, даже если перед этим ты кликнул по поиску наборов.
Картинки смайлов скачиваются с сервера по первому требованию и хранятся там, поэтому новый набор может открыться чуть дольше первого раза.
Внимание: кастом-эмодзи работает только в сообщении. Если формат рассылки «без форматирования», в текст уйдёт обычный смайл-фолбэк (или пусто, если фолбэка нет).
6. Планировщик: разовые и повторяющиеся задания
- Вкладка «Планировщик» → «Новое задание».
- Название — для вас, чтобы отличать задания в списке.
- «Когда» — дата и время. Кнопка 📅 открывает календарь в стиле панели: день кликом, часы и минуты — стрелками «−»/«+» или цифрами прямо в окошках времени: набрали две цифры — значение применилось и курсор сам перешёл в минуты, «↑»/«↓» шагают на единицу, Enter применяет и закрывает. То же поле можно набрать руками: «05.11.2026 15:08», «5.11 15:08», «2026-11-05T15:08» или просто «15:08» — тогда поправится только время, день останется тот же. Дата без времени тоже сохраняет время. Если не распознано — рамка краснеет и задание не сохранится, пока не исправишь. Быстрые кнопки над полем: +10 минут, +1 час, завтра 9:00. Время берётся с вашего компьютера, то есть задание в 9:00 придёт в 9:00 по вашему часовому поясу.
- «Повтор» — разово, каждый день, через день, по будням (Пн–Пт), по выходным (Сб, Вс), по выбранным дням недели, раз в месяц (в ту же дату). «Повторять до» — последняя дата, включая её.
- Адресаты и сообщение — так же, как в рассылке: аудитория целиком, либо список с поиском и кнопками «Все»/«Никто».
- «Сохранить задание». В календаре день отметится, а в списке дня появится строка со статусом.
Статусы: «В очереди», «Выполняется», «Завершено», «Отменено», «Ошибка», «Пропущено». Пропущенным задание становится, если панель была выключена больше часа на момент запуска — рассылка среди ночи «догоняющим» сообщением не отправляется. Пропущенное, отменённое и упавшее можно открыть, поправить и сохранить: оно снова встанет в очередь.
Повтор лежит одной записью, поэтому кнопки в списке дня спрашивают область: «Отменить», «Изменить» и «Удалить» у повторяющегося задания предлагают выбор — только это число или вся серия. «Только сегодня» отменяет ровно этот день: в календаре он останется серым и зачёркнутым, остальные повторы пойдут как шли, и день можно вернуть той же карточкой. «Удалить — только это число» убирает день из календаря совсем, но в списке дня остаётся строка «удалён из серии» с кнопкой «Вернуть в серию». Правка одного дня отцепляет его от серии: день становится разовым заданием, серия продолжается без него.
Задание, у которого вышел срок повтора, дальше не запланируется. Изменить расписание можно, открыв задание и сохранив его заново.
7. Чаты
Все чаты, где бот состоит, с поиском и кнопкой «Обновить». У строки видно: название, тип (группа/супергруппа/канал), количество адресатов в аудиториях и статус прав. «Без прав» — писать в этот чат нельзя, бот упирается в запрет публикации; решается выдачей прав в самой группе. Бота добавили в группу? Он появится здесь сам, без ручного обновления.
Статистика в шапке панели считает то же самое: «Чаты 12/15» — активные и всего, «Без прав» — сколько чатов отваливается.
«+ Чат через Telegram» — для тех, кому нужно работать со своими чатами, а не с общим списком. Кнопка даёт три ссылки самого Telegram: «группы, где разрешено добавлять участников», «группы, где вы администратор», «каналы, где вы администратор». Откроется нативное окно выбора чатов — панель не видит ваши чаты и не может их перечислить, вы отмечаете их руками. Бот вошёл в чат → панель записала его на вас, и в списке у чата пометка «мой».
- Галка «только мои» рядом с поиском оставляет чаты, которые привели вы.
- Кнопка есть и там, где выбирают адресатов для карточки «Итог по агентам».
- Первая ссылка вводит бота обычным участником — писать он не сможет, права на публикацию выдайте в самой группе. Ссылки «вы администратор» просят право публикации сразу.
- Нужен вход через Telegram (
/login КОД): у учётки, вошедшей по паролю, телеграм-аккаунта нет, поэтому и «своих» чатов у неё быть не может — кнопка ответит ошибкой с этим же советом. - Чаты, заведённые до этой функции, остаются общими: владельца у них нет. Если в чат бота привели два человека, владельцем числится первый — второй не перетягивает чат на себя, и обычное сообщение в группе владельца не меняет.
Почему нельзя «отправить просто от моего имени»: Bot API даёт боту писать только туда, куда его добавили, и не показывает список чатов человека. Такой список и право писать от имени аккаунта даёт MTProto-сессия — то есть сервер обязан хранить ваш личный вход в Telegram, которым можно читать вашу переписку и писать в любые ваши чаты. Мы такое не храним: утечка базы отдала бы не рассылку, а аккаунты людей. Официальный обход — deep-link с выбором чатов, он и стоит на кнопке.
Темы (форумы). У группы с темами в столбце названия — бейдж «🗂 тем N», у строки — кнопка «Темы». В панели видно id темы, её название (или «без названия»), закрыта ли она и когда бот видел её последний раз; название можно дописать руками — это право «Чаты». Кнопка «Обновить список» переспрашивает сервер.
Почему не все темы сразу: Bot API не умеет перечислять темы
группы — список тем и их названия отдаёт только MTProto. Поэтому бот запоминает
тему, когда видит в ней сообщение, а название приходит из служебных сообщений о
создании и переименовании темы. Темы, которых в списке нет, бот ещё не видел:
отправьте /topics внутри каждой такой темы — она появится. В
приватном режиме группы обычные сообщения боту не приходят, команды — приходят
всегда, поэтому /topics работает и там.
Загрузить сразу все темы. Если на сервере заданы MT_APP_ID и
MT_APP_HASH, в этом же окне появляется поле подключения аккаунта
(номер → код из Telegram → облачный пароль, если включён) и кнопка «Загрузить все
темы»: она приносит и названия, которых Bot API не отдаёт. Подключает и отключает
аккаунт только супер-администратор; пароль аккаунта на сервере не хранится, а
«Отключить аккаунт» выходит из него и стирает файл сессии. Аккаунт видит темы лишь
тех чатов, в которых состоит сам, — для чужого чата кнопка ответит, что его в нём
нет.
8. Аудитории
Аудитория — именованный список чатов, чтобы не отмечать их каждый раз руками. Например «Клиенты», «Партнёры», «Филиалы».
- Ввести название (и, если нужно, описание) → «Создать».
- «Состав» — открыть список чатов, отметить нужных галочками, «Добавить все»/«Убрать все» для массового действия, поиск по названию.
- «Переименовать» меняет только название; «Удалить» убирает аудиторию, сами чаты остаются в списке.
Один чат может входить в несколько аудиторий. В «Рассылке» чип аудитории выбирает её состав в список адресатов, в планировщике аудитория выбирается списком — и то и другое можно поправить вручную до отправки.
9. Шаблоны и вставки
| Тип | Зачем | Как использовать |
|---|---|---|
| Сообщение | полный текст рассылки целиком | выбрать в списке «Шаблон» на вкладке «Рассылка» — текст ляжет в редактор, приложится картинка шаблона; правьте и отправляйте |
| Вставка | короткий переиспользуемый кусок: подпись, ссылка на канал, дисклеймер | в редакторе выбрать его в списке «Вставить…» — кусок подставится в позицию курсора вместе с форматированием |
Быстрая запись шаблона: набрать текст в «Рассылке», ввести название в поле «Сохранить как…» и нажать «Сохранить шаблон».
Фильтр «все / сообщения / вставки» сверху помогает не путаться, когда шаблонов много. Удаление шаблона не трогает уже отправленные сообщения.
10. Наборы смайлов (нужно право «Наборы»)
- В Telegram открыть нужный набор кастом-эмодзи и скопировать ссылку
вида
https://t.me/addemoji/ИмяНабора. - Консоль → «Наборы» → вставить ссылку или просто имя → «Добавить набор». Без права «Наборы → загружать и удалять наборы» кнопки не будет.
- Панель спросит набор у бота, сохранит его состав и сразу добавит во вкладку «Кастом-эмодзи» пикера. Картинки подтянутся при первом открытии вкладки.
Подходят только наборы кастом-эмодзи. Обычные стикеры в текст сообщения не вставляются — панель это и не примет, а объяснит причину.
Ограничения: не больше 30 добавленных наборов и 200 смайлов в наборе (старшие — это сколько Telegram отдаст боту). «Удалить» убирает набор из пикера; сообщения, где смайл уже стоит, не меняются.
11. История
Каждая запущенная рассылка — кампания с номером, датой, началом текста, количеством отправленных и ошибочных адресатов и статусом: «В очереди», «Выполняется», «Завершено», «Остановлена», «С ошибками».
- «Открыть» у строки — пофайловый разбор: чат, статус, число попыток, текст ошибки.
- «Повторить неудачные» — отправляет заново только тем, у кого не вышло (в том числе тем, кого Telegram временно ограничил).
История заданий планировщика — на самой вкладке «Планировщик», в списке дня и в календаре.
12. Доступ, заявки, сессии, пароль
Раздел живёт в консоли — «Консоль» в шапке. Сюда пускает право видеть вкладку «Доступ»; вход по логину и паролю — один из способов туда попасть, но не единственный.
- Заявки. Вверху списка — «Заявка» у тех, кто написал
/request. Рядом с кнопкой «Одобрить» выбрана роль, которую вы даёте: «Одобрить» открывает доступ и сам уведомляет человека в Telegram; «Отклонить» убирает заявку. - Сменить роль. У человека, который уже входит в панель, роль выбирается прямо в его строке. Доступ при этом не прерывается: вкладки и кнопки перестроятся на следующем запросе, перелогиниваться не нужно. Роль «Супер-администратор» так выдаёт только супер-администратор.
- Закрыть доступ. «Отозвать» возвращает человека в состояние
«заявка» и одновременно сбрасывает все его активные сессии — войти он
сможет только после нового одобрения и
/login. «Удалить» убирает учётку из панели совсем (сессии тоже сбрасываются). Собственную роль снять, а доступ — отозвать нельзя: иначе последний, кто умеет выдавать доступ, отрезал бы себе вход. - Учётки входа по паролю. «Создать учётку» — логин, имя, роль и
пароль. Логин: 3–40 символов, строчные латинские буквы, цифры и
. _ -. Такой вход не связан с Telegram и нужен, когда бот недоступен. «Править» меняет имя, роль и пароль; сброс пароля рвёт все сессии этой учётки, включая вашу собственную, если правите себя. - Роли. «Новая роль» создаёт пустую, «Права» открывает список всех прав по разделам панели. У каждого раздела два уровня: право «вкладка» показывает сам раздел, а право «писать», «запускать» или «редактор» включает в нём действия. Снять права с встроенной роли можно, удалить её — нет; свою роль удалить нельзя, пока в ней числится хотя бы один аккаунт.
- Новые права после обновления панели. Каталог прав живёт в коде, а набор каждой роли — в базе, и заводится один раз. Поэтому раздел, который появился в новой версии, у «Оператора», «Наблюдателя» и у ваших ролей сначала закрыт: права на него нужно отметить заново в списке «Права». «Супер-администратор» получает новое право сам — у него стоит «все права, включая будущие».
- Права проверяет сервер. Интерфейс только прячет лишнее. Спрятанная кнопка — удобство, а не защита: запрос в обход панели получит отказ по той же таблице прав.
- Активные сессии. Кто вошёл, с какого IP и когда истекает. Токен сессии — это ключ доступа к панели: не пересылайте его и не оставляйте в чатах.
- Мой пароль. Поля «Текущий пароль / Новый / Повторите» (не короче 10 символов). После смены все сессии этой учётки сбрасываются — это защита на случай, когда пароль «утёк вместе со сессией».
- Перебор пароля. Не больше 8 неудачных попыток с одного IP за 15 минут, дальше вход по паролю приостанавливается.
13. Выгрузка аналитики и карточка «Итог по агентам»
Раздел считает показатели по реестру встреч и отдаёт результат в трёх видах: текст для чата, картинка с ровными процентами и XLSX с листом на каждый показатель. Права: «Выгрузка» — смотреть, «Загрузить реестр и собрать отчёт» — считать, «редактор определений показателей» — менять сами показатели.
- Реестр. «Загрузить реестр» — файл
.xlsxс листомреестр. Кладётся в закрытый каталог панели, в общий/uploadsон не попадает: в нём ФИО агентов. Загруженный файл остаётся на сервере, в Telegram из раздела уходит только то, что вы отправили сами. «Взять последний реестр» берёт уже лежащий на сервере файл — после перезагрузки страницы панель его «забыла», а пересылать 7 МБ заново не нужно; повторной копии книги при этом не появляется. - Разрез. ЦФО, период, необязательная «динамика» (сравнивает концы двух окон: «на 07.11 было → на 17.11 стало») и область. Чипами включаются показатели: без чипов таблица пустая.
- Показатели — не код, а строки таблицы: эмодзи, название, план, порог премии, знаменатель и числитель. Правятся кнопкой «Определения показателей» (нужно отдельное право). Условия — по строке на условие: строка попадает в знаменатель, если выполнили все его условия, значения в одной строке соединяются «ИЛИ». Колонки берутся из загруженного реестра, опечатку сервер не примет и назовёт колонку.
- Результат. Слева — «Текст для чата» с кнопкой «Скопировать», справа — карточка: проценты выровнены по разряду, картинка отдаётся в 2×. «Скачать PNG» сохраняет то, что видите вы, в текущей теме оформления.
«Итог по агентам» — отдельная карточка со списком агентов: поле «Проект», «Агентов на часть» (8, 10, 15, 20 или все) и перелистывание частями кнопками «← предыдущая» / «следующая →».
- «Скачать PNG» — текущая часть, «Все части» — по файлу на каждую страницу.
- «Отправить в чаты» — тем же ботом, в чаты из списка панели: поиск по названию, «выбрать все», страницы «текущая часть» или «все части по порядку», галка «приложить текстовый блок». У группы с темами под строкой — те же чипы, что в «Рассылке»: отмеченные темы получают каждую страницу отдельно. Отправка идёт по праву «Рассылка → отправлять сообщения». Свои чаты, которых ещё нет в списке, добавляется кнопкой «добавить чат через Telegram» — см. раздел 7.
- Каждая страница — своя кампания: её видно в «Истории», там же «Повторить неудачные», если доставка упала.
«Рейтинг по агентам» считается под таблицей: среднее арифметическое процентов по включённым показателям — по транзакциям, подписке премиум, анкете КК и страховке. Показатель, по которому у агента нет ни одной заявки в знаменателе, в деление не входит: рейтинг считается по остальным, а не обнуляется.
- По каждой области отдельно — три лучших (🥇🥈🥉) и три худших (⚠️). Если агентов в области три или меньше, худших не показываем: это те же люди.
- «Скачать PNG рейтинга» — одна картинка в текущей теме, «Отправить рейтинг в чаты» — тот же выбор адресатов, но подписью уходит текст рейтинга, а не текста отчёта.
- В окне отправки появился ряд аудиторий: нажатие на аудитию сразу выставляет её список чатов — общий список коллег больше не нужно отмечать галками каждый раз. Аудитории заводятся в разделе «Аудитории».
Картинка в чате совпадает с превью слева, включая тему: что видите на экране, то и уйдёт.
14. Подписка и тарифы
Нужно, чтобы один бот обслуживал нескольких клиентов и у каждого была своя плата и свои границы. Тариф — что куплено: цена, срок, лимиты и какие разделы вообще включены. Подписка — тариф, надетый на одну учётку на срок. Роль у человека остаётся своей, а работать он будет с пересечением роли и тарифа: чего нет в тарифе, тот не покажется, даже если роль разрешает.
- Тариф («Новый тариф», право создавать и менять): название, цена, срок в днях, порядок показа и три лимита — адресатов в одной рассылке, рассылок за календарный месяц, живых заданий планировщика. Ноль в лимите — «без ограничения». Список разделов: пустой — тариф ничего не срезает от роли, отмеченные разделы оставляют только их. Удалить тариф, по которому есть подписка, нельзя.
- Роль при оплате. В форме тарифа есть поле «Роль»: оформили подписку этого тарифа — аккаунт получает выбранную роль, а прежняя запоминается в самой подписке. Отменили, сняли дату в прошлое или срок вышел — роль возвращается прежняя, а сессия человека сброшена, чтобы права пересчитались сразу. Если роль в уже заведённом тарифе поменяли или убрали, пересчёт идёт по всем, кто на этот тариф подписан, — отдельно применять ничего не нужно. Роль не выдаётся, если у тарифа поле пустое, и несуществующую роль сервер не примет.
- Подписка («Оформить подписку», право оформлять/продлевать/отменять): аккаунт, тариф, начало и окончание. Окончание подставляется само по сроку тарифа — датой можно поправить, если догоняете просрочку или делаете скидку днями. Просроченная подписка перестает действовать в 00:00 по серверным часам.
- Что видит клиент. У него свой раздел «Подписка» со статусом, остатками лимитов и списком включённых разделов — прав на ведение тарифов для этого не нужно. Раздел лежит в консоли (ссылка «Консоль» в шапке), а не в общем ряду вкладок; сама ссылка появляется по праву на «Доступ», «Наборы» или «Подписку».
Режим ограничения включается на сервере переменной
SUBS_ENFORCE=1, а не кнопкой. По умолчанию он выключен: записи
о подписках ведутся, лимиты показываются, но работу не блокируют. Включать
его нужно, когда тарифы заведены и клиентов предупредили, иначе у людей
внезапно пропадут вкладки. Супер-администратор ограничениям не подчиняется.
15. Сообщения: личная переписка
Внутренний чат между учёток панели — оператор с администратором, администратор с клиентом. Это не Telegram: сообщения никуда наружу не уходят и видны только двум участникам диалога. Ни роль, ни право «Доступ» чужую переписку не открывают — сервер сверяет участников пары, а не список прав.
- «Новый чат» → список всех, кто входит в панель (по имени и логину, живой поиск) → выбрать человека. Дальше диалог остаётся в списке слева.
- Enter отправляет, Shift+Enter переносит строку. Картинка — кнопкой «Картинка» или Ctrl+V скриншота прямо в поле; тогда текст становится подписью. PNG, JPEG, WebP, GIF, тот же предел размера, что у рассылки.
- «Сообщения раньше» в шапке диалога подгружает историю по 50 сообщений, прокрутка остаётся на том же месте.
- Счётчик — сколько не прочитано вами. Открыли диалог — счётчик сбросился. Пока окно или вкладка на экране, новые сообщения приходят примерно за 4 секунды; когда человек в другом разделе — за 20 секунд, этого хватает, чтобы сигнал дошёл без лишнего трафика.
- Плавающая кнопка в правом нижнем углу видна на любом разделе: цифра сверху — сколько сообщений ждёт, мигание — что пришло, пока окно закрыто. Клик открывает окно переписки (тот же раздел, что и вкладка), Esc или «✕ закрыть» — сворачивает. Кнопка «🔔 звук» включает или выключает короткий сигнал при входящем; выбор запоминается для этого браузера. Звук может молчать до первого клика на странице: браузер разрешает звук только после действия человека.
Картинки переписки лежат в закрытом каталоге и отдаются
только участнику диалога: прямая ссылка чужого аккаунта или гостя вернёт
отказ, в общем /uploads их нет.
Срок хранения. «Срок хранения» (право менять срок) — сколько суток
держать историю: 0 — не удалять ничего, любое другое значение
убирает сообщения старше стольких суток вместе с картинками. Чистка
происходит сразу при сохранении и потом каждый час. Заводское значение —
CHAT_RETENTION_DAYS (90 суток).
Права раздела: «Вкладка „Сообщения“ и свои диалоги», «Отправлять сообщения и картинки», «Менять срок хранения переписки». Без права на отправку переписка читается, а кнопки ввода нет.
16. Шпаргалка
| Что | Значение |
|---|---|
| Клавиши формата | Ctrl+В жирный · Ctrl+И курсив · Ctrl+U подчёркнутый · Ctrl+K ссылка |
| Выход из формата | Enter или повторный клик по кнопке формата |
| Лимит текста | 4096 символов; с картинкой-подписью — 1024 |
| Картинка | PNG, JPEG, WebP, GIF до 8 МБ; можно Ctrl+V |
| Адресаты | галочки, чип аудитории и поле со списком
chat_id; незнакомый id тоже становится адресатом;
до 5000 за кампанию |
| Код входа | одноразовый, 10 минут, привязан к IP |
| Сессия | 7 дней |
| Свои вкладки | перетаскивание мышью, «+ папка», «↺ порядок»; раскладка на сервере и привязана к вам, а не к браузеру |
| Перебор пароля | 8 неудач за 15 минут с одного IP |
| Скорость рассылки | ~20 msg/s боту, 1 msg/s в чат, до 4 повторов |
| Просрочка задания | позже 1 часа после старта — «Пропущено» |
| Наборы | до 30 наборов, до 200 смайлов в наборе |
| Выгрузка | .xlsx с листом реестр; карточка
— PNG 2× в текущей теме; «Итог по агентам» листается частями и отправляется
в чаты каждой страницей как своя кампания |
| Подписка | права = роль ∩ тариф; лимиты считаются, но не
блокируют, пока на сервере не включён SUBS_ENFORCE |
| Сообщения | личные диалоги 1:1 между учёток панели; новые — ~за 4 секунды; срок хранения в сутках, 0 — не удалять |
| Команды бота | /request · /login КОД ·
/help · /id (узнать chat_id чата) ·
/topics (темы этой группы) ·
/groups · /status |
| Темы | тема — отдельный адресат: чат с 2 темами даёт 2 строки доставки; планировщик темы не выбирает — его задания уходят в общую тему |
17. Частые ситуации
| Ситуация | Что делать |
|---|---|
| «Сессия истекла» при действии | войти заново: код → /login, либо пароль |
| Код не подтверждается | код одноразовый и живёт 10 минут — нажать «Получить код входа» заново;
писать /login надо в личный чат боту, не в группу |
| Рассылка идёт, но часть чатов «ошибка» | открыть кампанию в «Истории», посмотреть текст ошибки и «Повторить неудачные». «bot is not a member» — бота вывели из чата, «sender forbidden» — права на публикацию, Flood — Telegram ограничил частоту, повторится само |
| Адресатов ноль | ничего не выбирается само: отметьте чаты или кликните чип аудитории |
| Кнопки формата «не слушаются» | повторный клик по активной кнопке выходит из режима — набранный текст остаётся форматированным; если формат не нужен вовсе, Enter |
| Смайл выглядит пустым квадратом | картинка ещё не скачалась на сервер — подождите секунду и обновите; если квадратов много, проверьте, что набор цел в консоли, на «Наборах» |
| «Telegram не отдаёт набор …» | имя набрано с ошибкой, набор обычный (не кастом-эмодзи) или бот его ещё не открывал — проверьте ссылку в Telegram |
| Задание не отправилось в срок | в этот момент панель была выключена дольше часа → статус «Пропущено»: откройте задание и сохраните заново |
| Нужно срочно остановить рассылку | «Остановить» под прогрессом; отозвать уже доставленные сообщения нельзя |
| В группе с темами список тем пуст | бот ещё не видел ни одной темы: отправьте /topics внутри
каждой темы — она появится в панели и в чипах выбора адресатов;
название допишите в панели, Telegram его не передаёт |
| Раздел пропал из верхней строки | скорее всего ушёл в папку — кликните по папке, он во второй строке; если не нашли, «↺ порядок» вернёт заводскую раскладку |
Здесь пусто
Ваша роль не даёт доступа ни к одному разделу этой страницы. На главной панели разделы могут быть — вернитесь туда. Если и там пусто, попросите администратора назначить роль с правами.