Панель рассылок

Бот проверит код и пустит в интерфейс, если вашу заявку одобрили и назначили роль.

——————

Откройте чат с ботом и отправьте:
/login ——

Ждём подтверждения…

Нет доступа? Напишите боту /request — заявку должен одобрить кто-то с правом «Доступ». Код живёт 10 минут, привязан к вашему IP и одноразовый.

Вход по учётке, которую завели в разделе «Доступ». Работает по HTTP: пока панель без TLS, пароль уходит открытым текстом.

📣Рассылки
Консоль ← Панель рассылок

Сообщение

фото с подписью-текстом: лимит подписи 1024 символа
0 / 4096

Адресаты

Клик по аудитории добавляет её чаты, повторный клик убирает ровно их. Галочки ниже служат для ручной донастройки. Адресаты — это галочки плюс список id в поле под чатами: рассылка уходит в объединение.

Чаты «не админ» не получат сообщение, пока боту не выдадут права. Добавленные в чат группы появляются здесь сами.

Календарь

запланировано выполняется готово ошибка отменено

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

Задания

Новое задание

Быстро: 0 / 4096

Адресаты выбрано 0

фото с подписью-текстом: лимит подписи 1024 символа

Чаты, где состоит бот

Чатchat_idБот-админВ рассылке АудиторииАктивность

Аудитории

НазваниеОписаниеЧатов

Состав:

Шаблоны

НазваниеТипФорматСимволовОбновлён

Шаблон — заготовка текста с разметкой: в «Рассылке» он подставляется целиком. Вставка — короткий кусок (набор @username, контакты, подпись): он добавляется в текст редактора через список «Вставить» в тулбаре.

Новый шаблон

0 / 4096
картинка сохраняется вместе с шаблоном

Наборы смайлов

Вставьте ссылку на набор из Telegram (https://t.me/addemoji/<имя>) или просто его имя — панель спросит набор у бота и добавит его во вкладку «Кастом-эмодзи» в пикере смайлов. Картинки скачиваются один раз и лежат на сервере; анимированные в панели показаны статичной картинкой, в Telegram они оживают.

НазваниеИмя в TelegramСмайлов АнимацияДобавлен

Заводской набор @tatyemoji вшит в панель и не удаляется.

История рассылок

#ДатаСообщениеОтправлено ОшибкиСтатус

Кампания

chat_idГруппаТемаСтатусПопыткиОшибка

Выгрузка аналитики

Реестр встреч (.xlsx, лист «реестр») → по каждому показателю план/факт и процент по области и по каждому агенту, текст для чата и картинка. Сам реестр остаётся на сервере панели; в Telegram уходит только то, что вы отправили кнопкой «Отправить в чаты».

реестр не загружен

Чипы включают показатели в выгрузку. «Динамика» необязательна: с ней каждая строка покажет «было → стало».

Показатели

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

Текст для чата


          

Карточка

проценты выровнены по разряду, картинка — 2×

Итог по агентам

картинка 2×, части листаются кнопками выше

Отчёт — картинкой и текстовым блоком

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

Рейтинг по агентам

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

Доступ к панели

Пользователь пишет боту /request, заявка появляется здесь. Одобрить её, назначить роль, завести учётку для входа по паролю — всё это права раздела «Доступ», а кому они доступны, решает роль.

Пользователи Telegram

Telegram IDИмяUsernameРольЗаявка

Учётки входа по паролю

Входят на странице входа во вкладке «По паролю», без Telegram и без бота. Логин — строчные латинские буквы, цифры и . _ -; пароль не короче 10 символов.

ЛогинИмяРольСозданаПоследний вход

Новая учётка

Роли и права

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

РольКлючАккаунтовПрава

Роль

Мой пароль

Пароль минимум 10 символов; после смены все сессии этой учётки сбрасываются.

Активные сессии

ТокенКтоIPИстекает

Подписка и тарифы

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

Тарифы

ТарифЦенаСрокЛимиты РазделыРольПодписок

Новый тариф

Ноль в лимите — «без ограничения». Пустой список разделов — тариф ничего не срезает от роли; отмеченные разделы оставляют только их.

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

Подписки

КомуТарифСПоСтатус Кем оформленаЗаметка

Подписка

Окончание подставляется само: начало плюс срок тарифа. Поправьте датой, если догоняете просрочку или делаете скидку днями.

Сообщения

Личная переписка между учёток панели: оператор с администратором, администратор с клиентом. Диалог виден только его двум участникам — ни роль, ни право «Доступ» чужой переписки не открывают.

С кем написать

0 — не удалять ничего. Любое другое значение убирает сообщения старше стольких суток вместе с картинками; удаление происходит сразу при сохранении и потом каждый час.

Выберите диалог слева или начните новый.

Справка по панели

Панель — интерфейс к одному Telegram-боту. Бот знает чаты, в которых состоит, отправляет в них сообщения по вашему списку адресатов и умеет запускать рассылку в назначенное время. Всё, что вы меняете здесь, влияет на реальные сообщения.

Панель открыта по HTTP без шифрования. Вход «по паролю» отправляет пароль в открытом виде — используйте его только из доверенной сети. Вход через Telegram (код → /login) пароля не передаёт.
1. Вход и кто что имеет право делать
  1. Открыть панель → «Получить код входа». На экране появится шестизначный код, живёт он 10 минут, привязан к вашему IP и одноразовый.
  2. Написать боту в личном чате /login КОД. Бот проверит код — и панель сама пустит вас внутрь.
  3. Если доступа нет: /request → заявка появится в консоли, на «Доступе». Одобрить её может тот, у кого есть право «Доступ → одобрять заявки»; после одобрения повторите /login.

Второй способ — вкладка «По паролю»: учётку для него заводит руками кто-то с тем же правом, в том же разделе «Доступ». Вход не связан с Telegram и нужен, когда бот недоступен или код получить нечем.

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

КтоКак появляетсяЧто может
Гостьнаписал боту, но не отправлял /request только смотреть на страницу входа
Заявка/requestничего — ждёт одобрения
Любая роль её назначили при одобрении заявки или позже в списке ровно то, что входит в набор прав этой роли
Супер-администраторвстроенная роль, выдаёт её только супер-администратор все права, включая те, что появятся в следующих версиях панели

Встроенные роли: «Супер-администратор», «Оператор» (вся работа с рассылками, но без «Доступа», «Наборов», чужих тарифов и срока хранения переписки) и «Наблюдатель» (только смотреть). Их можно менять, свои — создавать. Права, которые появились в новой версии, в уже заведённые роли сами не добавляются. См. раздел 12.

Сессия живёт 7 дней. «Выйти» в шапке закрывает её досрочно.

2. Свои вкладки: порядок, папки, тема

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

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

Подпись справа от кнопок говорит, что раскладка сохранена. Ограничения сервера: до 20 папок, до 60 разделов в строке и в папке, имя папки до 40 символов.

Ссылка «Консоль» в шапке появляется у того, у кого есть право на «Наборы» смайлов (раздел 10) или на «Доступ» (раздел 12). Это отдельная страница с теми же разделами: у остальных её не будет, а прямой адрес вернёт на главную.

3. Рассылка: шаг за шагом
  1. Сообщение. Набрать текст в редакторе (см. раздел 4). Можно сразу выбрать готовый шаблон в списке «Шаблон» — текст подставится в поле.
  2. Картинка — по желанию. Кнопка «Картинка» в панели инструментов или обычный Ctrl+V скриншота прямо в поле текста. С картинкой сообщение уходит как фото с подписью, а лимит подписи падает с 4096 до 1024 символов.
  3. Адресаты. Справа: клик по чипу аудитории добавляет её чаты к текущему выбору (повторный клик убирает ровно их, ручные отметки остаются), дальше состав можно поправить галочками вручную. Поиск ищет по названию чата, «Все» и «Никто» отмечают весь видимый список. Отмеченное переживает поиск, «Обновить» в «Чатах», переключение вкладок и правку состава аудитории. Автоматически ничего не выбирается: рассылка пойдёт только туда, где стоит галочка или где id стоит в поле.
  4. Если чата нет в списке — ниже есть поле для списка chat_id: вставьте номера через пробел, запятую или с новой строки (узнать id — /id в нужном чате). Поле и галочки — два независимых списка адресатов, в рассылку уходит их объединение, а счётчик сверху показывает разбивку «галочками N, в поле M». Знакомый чат из поля отмечается галочкой в списке. Снять адресата можно с любой стороны: убрать id из поля — он снялся, если только отмечен галочкой; снять галочку — id вычёркивается и из поля. «Никто» убирает видимые чаты из обеих сторон, но id, которых нет в списке чатов, не трогает — такие адресаты остаются, и счётчик это показывает. Незнакомый панели id всё равно становится адресатом, а при отправке попадёт в «Ошибки» кампании, если бот в таком чате не состоит. За одну кампанию — не больше 5000 адресатов.
  5. Запустить рассылку. Появится полоса прогресса и счётчик «отправлено / ошибок / пропущено». «Остановить» прерывает очередь, уже отправленное не отзывается.

Скорость ограничена Telegram: примерно 20 сообщений в секунду на бота и не чаще одного в секунду в один чат. Ошибки сети бот повторяет до 4 раз. Большая рассылка — это минуты, а не секунды: вкладку можно закрыть, отправка продолжится на сервере.

Чаты с пометкой «не админ» сообщение не получат, пока боту в группе не выдадут право публиковать.

Группы с темами. Если у чата включены темы (форум), под его строкой появляются чипы: «общая» и каждая тема, которую видел бот. Без отметок уходит в общую тему — как раньше; отметьте чипы — и на каждую тему пойдёт своё сообщение. Счётчик адресатов считает темы отдельно: чат с двумя темами — два адресата, и лимит тарифа тоже расходится по ним. Колонка «Тема» в деталях кампании говорит, куда именно лёг каждый адресат; у удалённой или закрытой темы — ошибка доставки с явной подписью.

4. Редактор: форматы, выход из формата, режим «теги»

Редактор показывает текст так, как его увидит читатель, а не теги. Порядок кнопок сверху: / / (служебные теги), смайлы, Жирный, Курсив, Подчёркнутый, Зачёркнутый, Спойлер, Код, Блок кода, Ссылка, Цитата, Картинка, список вставок.

ДействиеЧто произойдёт
Выделить текст и нажать кнопку формата выделение обернётся в формат
Поставить курсор и нажать кнопку появится серая подсказка формата; то, что вы напечатаете, станет форматированным. Второе нажатие на кнопку до начала ввода удаляет пустую подсказку
Нажать ту же кнопку второй раз, когда текст уже набран выход из формата: набранное остаётся форматированным, а всё, что напечатано после клика, — обычным текстом
Enter внутри форматавыход из формата и новый абзац
Ctrl+V картинки / текстакартинка уходит на сервер как вложение, текст вставляется с сохранением разрывов строк

Активная кнопка формата подсвечена — по ней видно, в каком режиме сейчас печатается курсор.

Что за кнопка / /. Переключает поле в режим разметки: вместо «жирного» вы видите <b>жирного</b> (или ** для Markdown) и можете править теги руками. Возврат во WYSIWYG разбирает разметку обратно; если тег битый или не поддерживается Telegram, под полем появится предупреждение, а проблемное место останется текстом — так сообщение не уйдёт обрезанным.

Формат рассылки (HTML или Markdown) выбирается один раз и действует во всех редакторах панели. Цитата доступна только в HTML.

5. Смайлы: мои, все, кастом-эмодзи
  1. Нажать 😊 в панели инструментов редактора — откроется пикер с тремя вкладками.
  2. «Мой набор» — то, что вы добавили себе. Клик по смайлу вставляет его в текст; чтобы положить сюда новый, вставьте его символ в поле внизу пикера и нажмите «+».
  3. «Все смайлы» — полный Юникод-набор по категориям.
  4. «Кастом-эмодзи» — авторские наборы картинками. В Telegram такой смайл может анимироваться; в панели он показан статичной картинкой, но в сообщении остаётся именно анимированным.

Смайл в тексте — плитка, но ведёт себя как один знак: выделяется мышью, копируется Ctrl+C, вырезается и удаляется Backspace как обычный символ. Клик по пикеру не уводит курсор: смайл встаёт туда, где он стоял, даже если перед этим ты кликнул по поиску наборов.

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

Внимание: кастом-эмодзи работает только в сообщении. Если формат рассылки «без форматирования», в текст уйдёт обычный смайл-фолбэк (или пусто, если фолбэка нет).

6. Планировщик: разовые и повторяющиеся задания
  1. Вкладка «Планировщик» → «Новое задание».
  2. Название — для вас, чтобы отличать задания в списке.
  3. «Когда» — дата и время. Кнопка 📅 открывает календарь в стиле панели: день кликом, часы и минуты — стрелками «−»/«+» или цифрами прямо в окошках времени: набрали две цифры — значение применилось и курсор сам перешёл в минуты, «↑»/«↓» шагают на единицу, Enter применяет и закрывает. То же поле можно набрать руками: «05.11.2026 15:08», «5.11 15:08», «2026-11-05T15:08» или просто «15:08» — тогда поправится только время, день останется тот же. Дата без времени тоже сохраняет время. Если не распознано — рамка краснеет и задание не сохранится, пока не исправишь. Быстрые кнопки над полем: +10 минут, +1 час, завтра 9:00. Время берётся с вашего компьютера, то есть задание в 9:00 придёт в 9:00 по вашему часовому поясу.
  4. «Повтор» — разово, каждый день, через день, по будням (Пн–Пт), по выходным (Сб, Вс), по выбранным дням недели, раз в месяц (в ту же дату). «Повторять до» — последняя дата, включая её.
  5. Адресаты и сообщение — так же, как в рассылке: аудитория целиком, либо список с поиском и кнопками «Все»/«Никто».
  6. «Сохранить задание». В календаре день отметится, а в списке дня появится строка со статусом.

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

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

Задание, у которого вышел срок повтора, дальше не запланируется. Изменить расписание можно, открыв задание и сохранив его заново.

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. Аудитории

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

  1. Ввести название (и, если нужно, описание) → «Создать».
  2. «Состав» — открыть список чатов, отметить нужных галочками, «Добавить все»/«Убрать все» для массового действия, поиск по названию.
  3. «Переименовать» меняет только название; «Удалить» убирает аудиторию, сами чаты остаются в списке.

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

9. Шаблоны и вставки
ТипЗачемКак использовать
Сообщениеполный текст рассылки целиком выбрать в списке «Шаблон» на вкладке «Рассылка» — текст ляжет в редактор, приложится картинка шаблона; правьте и отправляйте
Вставкакороткий переиспользуемый кусок: подпись, ссылка на канал, дисклеймер в редакторе выбрать его в списке «Вставить…» — кусок подставится в позицию курсора вместе с форматированием

Быстрая запись шаблона: набрать текст в «Рассылке», ввести название в поле «Сохранить как…» и нажать «Сохранить шаблон».

Фильтр «все / сообщения / вставки» сверху помогает не путаться, когда шаблонов много. Удаление шаблона не трогает уже отправленные сообщения.

10. Наборы смайлов (нужно право «Наборы»)
  1. В Telegram открыть нужный набор кастом-эмодзи и скопировать ссылку вида https://t.me/addemoji/ИмяНабора.
  2. Консоль → «Наборы» → вставить ссылку или просто имя → «Добавить набор». Без права «Наборы → загружать и удалять наборы» кнопки не будет.
  3. Панель спросит набор у бота, сохранит его состав и сразу добавит во вкладку «Кастом-эмодзи» пикера. Картинки подтянутся при первом открытии вкладки.

Подходят только наборы кастом-эмодзи. Обычные стикеры в текст сообщения не вставляются — панель это и не примет, а объяснит причину.

Ограничения: не больше 30 добавленных наборов и 200 смайлов в наборе (старшие — это сколько Telegram отдаст боту). «Удалить» убирает набор из пикера; сообщения, где смайл уже стоит, не меняются.

11. История

Каждая запущенная рассылка — кампания с номером, датой, началом текста, количеством отправленных и ошибочных адресатов и статусом: «В очереди», «Выполняется», «Завершено», «Остановлена», «С ошибками».

  1. «Открыть» у строки — пофайловый разбор: чат, статус, число попыток, текст ошибки.
  2. «Повторить неудачные» — отправляет заново только тем, у кого не вышло (в том числе тем, кого Telegram временно ограничил).

История заданий планировщика — на самой вкладке «Планировщик», в списке дня и в календаре.

12. Доступ, заявки, сессии, пароль

Раздел живёт в консоли — «Консоль» в шапке. Сюда пускает право видеть вкладку «Доступ»; вход по логину и паролю — один из способов туда попасть, но не единственный.

  • Заявки. Вверху списка — «Заявка» у тех, кто написал /request. Рядом с кнопкой «Одобрить» выбрана роль, которую вы даёте: «Одобрить» открывает доступ и сам уведомляет человека в Telegram; «Отклонить» убирает заявку.
  • Сменить роль. У человека, который уже входит в панель, роль выбирается прямо в его строке. Доступ при этом не прерывается: вкладки и кнопки перестроятся на следующем запросе, перелогиниваться не нужно. Роль «Супер-администратор» так выдаёт только супер-администратор.
  • Закрыть доступ. «Отозвать» возвращает человека в состояние «заявка» и одновременно сбрасывает все его активные сессии — войти он сможет только после нового одобрения и /login. «Удалить» убирает учётку из панели совсем (сессии тоже сбрасываются). Собственную роль снять, а доступ — отозвать нельзя: иначе последний, кто умеет выдавать доступ, отрезал бы себе вход.
  • Учётки входа по паролю. «Создать учётку» — логин, имя, роль и пароль. Логин: 3–40 символов, строчные латинские буквы, цифры и . _ -. Такой вход не связан с Telegram и нужен, когда бот недоступен. «Править» меняет имя, роль и пароль; сброс пароля рвёт все сессии этой учётки, включая вашу собственную, если правите себя.
  • Роли. «Новая роль» создаёт пустую, «Права» открывает список всех прав по разделам панели. У каждого раздела два уровня: право «вкладка» показывает сам раздел, а право «писать», «запускать» или «редактор» включает в нём действия. Снять права с встроенной роли можно, удалить её — нет; свою роль удалить нельзя, пока в ней числится хотя бы один аккаунт.
  • Новые права после обновления панели. Каталог прав живёт в коде, а набор каждой роли — в базе, и заводится один раз. Поэтому раздел, который появился в новой версии, у «Оператора», «Наблюдателя» и у ваших ролей сначала закрыт: права на него нужно отметить заново в списке «Права». «Супер-администратор» получает новое право сам — у него стоит «все права, включая будущие».
  • Права проверяет сервер. Интерфейс только прячет лишнее. Спрятанная кнопка — удобство, а не защита: запрос в обход панели получит отказ по той же таблице прав.
  • Активные сессии. Кто вошёл, с какого IP и когда истекает. Токен сессии — это ключ доступа к панели: не пересылайте его и не оставляйте в чатах.
  • Мой пароль. Поля «Текущий пароль / Новый / Повторите» (не короче 10 символов). После смены все сессии этой учётки сбрасываются — это защита на случай, когда пароль «утёк вместе со сессией».
  • Перебор пароля. Не больше 8 неудачных попыток с одного IP за 15 минут, дальше вход по паролю приостанавливается.
13. Выгрузка аналитики и карточка «Итог по агентам»

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

  1. Реестр. «Загрузить реестр» — файл .xlsx с листом реестр. Кладётся в закрытый каталог панели, в общий /uploads он не попадает: в нём ФИО агентов. Загруженный файл остаётся на сервере, в Telegram из раздела уходит только то, что вы отправили сами. «Взять последний реестр» берёт уже лежащий на сервере файл — после перезагрузки страницы панель его «забыла», а пересылать 7 МБ заново не нужно; повторной копии книги при этом не появляется.
  2. Разрез. ЦФО, период, необязательная «динамика» (сравнивает концы двух окон: «на 07.11 было → на 17.11 стало») и область. Чипами включаются показатели: без чипов таблица пустая.
  3. Показатели — не код, а строки таблицы: эмодзи, название, план, порог премии, знаменатель и числитель. Правятся кнопкой «Определения показателей» (нужно отдельное право). Условия — по строке на условие: строка попадает в знаменатель, если выполнили все его условия, значения в одной строке соединяются «ИЛИ». Колонки берутся из загруженного реестра, опечатку сервер не примет и назовёт колонку.
  4. Результат. Слева — «Текст для чата» с кнопкой «Скопировать», справа — карточка: проценты выровнены по разряду, картинка отдаётся в 2×. «Скачать PNG» сохраняет то, что видите вы, в текущей теме оформления.

«Итог по агентам» — отдельная карточка со списком агентов: поле «Проект», «Агентов на часть» (8, 10, 15, 20 или все) и перелистывание частями кнопками «← предыдущая» / «следующая →».

  • «Скачать PNG» — текущая часть, «Все части» — по файлу на каждую страницу.
  • «Отправить в чаты» — тем же ботом, в чаты из списка панели: поиск по названию, «выбрать все», страницы «текущая часть» или «все части по порядку», галка «приложить текстовый блок». У группы с темами под строкой — те же чипы, что в «Рассылке»: отмеченные темы получают каждую страницу отдельно. Отправка идёт по праву «Рассылка → отправлять сообщения». Свои чаты, которых ещё нет в списке, добавляется кнопкой «добавить чат через Telegram» — см. раздел 7.
  • Каждая страница — своя кампания: её видно в «Истории», там же «Повторить неудачные», если доставка упала.

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

  • По каждой области отдельно — три лучших (🥇🥈🥉) и три худших (⚠️). Если агентов в области три или меньше, худших не показываем: это те же люди.
  • «Скачать PNG рейтинга» — одна картинка в текущей теме, «Отправить рейтинг в чаты» — тот же выбор адресатов, но подписью уходит текст рейтинга, а не текста отчёта.
  • В окне отправки появился ряд аудиторий: нажатие на аудитию сразу выставляет её список чатов — общий список коллег больше не нужно отмечать галками каждый раз. Аудитории заводятся в разделе «Аудитории».

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

14. Подписка и тарифы

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

  • Тариф («Новый тариф», право создавать и менять): название, цена, срок в днях, порядок показа и три лимита — адресатов в одной рассылке, рассылок за календарный месяц, живых заданий планировщика. Ноль в лимите — «без ограничения». Список разделов: пустой — тариф ничего не срезает от роли, отмеченные разделы оставляют только их. Удалить тариф, по которому есть подписка, нельзя.
  • Роль при оплате. В форме тарифа есть поле «Роль»: оформили подписку этого тарифа — аккаунт получает выбранную роль, а прежняя запоминается в самой подписке. Отменили, сняли дату в прошлое или срок вышел — роль возвращается прежняя, а сессия человека сброшена, чтобы права пересчитались сразу. Если роль в уже заведённом тарифе поменяли или убрали, пересчёт идёт по всем, кто на этот тариф подписан, — отдельно применять ничего не нужно. Роль не выдаётся, если у тарифа поле пустое, и несуществующую роль сервер не примет.
  • Подписка («Оформить подписку», право оформлять/продлевать/отменять): аккаунт, тариф, начало и окончание. Окончание подставляется само по сроку тарифа — датой можно поправить, если догоняете просрочку или делаете скидку днями. Просроченная подписка перестает действовать в 00:00 по серверным часам.
  • Что видит клиент. У него свой раздел «Подписка» со статусом, остатками лимитов и списком включённых разделов — прав на ведение тарифов для этого не нужно. Раздел лежит в консоли (ссылка «Консоль» в шапке), а не в общем ряду вкладок; сама ссылка появляется по праву на «Доступ», «Наборы» или «Подписку».

Режим ограничения включается на сервере переменной SUBS_ENFORCE=1, а не кнопкой. По умолчанию он выключен: записи о подписках ведутся, лимиты показываются, но работу не блокируют. Включать его нужно, когда тарифы заведены и клиентов предупредили, иначе у людей внезапно пропадут вкладки. Супер-администратор ограничениям не подчиняется.

15. Сообщения: личная переписка

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

  1. «Новый чат» → список всех, кто входит в панель (по имени и логину, живой поиск) → выбрать человека. Дальше диалог остаётся в списке слева.
  2. Enter отправляет, Shift+Enter переносит строку. Картинка — кнопкой «Картинка» или Ctrl+V скриншота прямо в поле; тогда текст становится подписью. PNG, JPEG, WebP, GIF, тот же предел размера, что у рассылки.
  3. «Сообщения раньше» в шапке диалога подгружает историю по 50 сообщений, прокрутка остаётся на том же месте.
  4. Счётчик — сколько не прочитано вами. Открыли диалог — счётчик сбросился. Пока окно или вкладка на экране, новые сообщения приходят примерно за 4 секунды; когда человек в другом разделе — за 20 секунд, этого хватает, чтобы сигнал дошёл без лишнего трафика.
  5. Плавающая кнопка в правом нижнем углу видна на любом разделе: цифра сверху — сколько сообщений ждёт, мигание — что пришло, пока окно закрыто. Клик открывает окно переписки (тот же раздел, что и вкладка), 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 его не передаёт
Раздел пропал из верхней строки скорее всего ушёл в папку — кликните по папке, он во второй строке; если не нашли, «↺ порядок» вернёт заводскую раскладку

Здесь пусто

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

Сообщения