Как пользоваться Pulse

Панель раздела и активный проект

Бот держит несколько моделей одновременно. Активный проект — тот, к которому применяются кнопки «🚀 Пинг», «🧪 Тест», «👥 Загрузить id», «📊 Статистика» внутри этого раздела.

• Открыть карточку проекта — он автоматически становится активным. В карточке помечен 📌 активный.
• 📁 Все проекты — список. ✅ — канал привязан, ⚠️ — ещё нет.
• Карточка проекта — операционный экран: пинг, тест, статистика, опросы со сбором id, загрузка id, исключения. Канал, настройки, админы и удаление проекта — в «👑 Администрирование».
• ⬅️ В меню — назад к выбору раздела (раздел 3).

Канал

Кнопка 🔗 Канал в карточке проекта.

1. Добавьте @N0t1f1cator_bot в канал администратором. Права: публикация сообщений и удаление сообщений.
2. В боте: 🔗 Канал → перешлите любой пост из этого канала. Можно вместо форварда прислать @username канала.
3. Бот проверит свои права и привяжет канал. Если у канала есть обсуждалка (комментарии) — подцепит и её, чтобы собирать id комментаторов.

База подписчиков

Готовый список подписчиков Telegram боту не даёт — это ограничение платформы, не баг. Поэтому базу id бот набирает сам, по мере активности:

• кто-то вступил в канал — id в базу;
• кто-то поставил реакцию на пост — id в базу;
• комментарий под постом, заявка на вступление, буст канала;
• переход по ссылке t.me/N0t1f1cator_bot?start=p_<id проекта> (её можно положить в описание канала);
• вы переслали боту сообщение подписчика.

🗳 Создать опрос со сбором id

Самый быстрый способ. Мастер из 6 шагов: вопрос → фото (необязательно, можно несколько или альбомом) → варианты ответа (добавляются по одному, как в обычном опросе Telegram) → один ответ или можно выбрать несколько → результаты видно всем сразу или только тому, кто уже проголосовал → публикация. Бот постит в канал фото (если были) и вопрос с кнопкой на каждый вариант — кто голосует, попадает в базу. Удалить опрос можно только как обычное сообщение канала — стандартными средствами Telegram.

👥 Загрузить id

Разовый импорт — если у вас уже есть выгрузка тех, кто подписан. Файл .txt (id построчно) или .csv (user_id,first_name,username), либо просто вставьте список id сообщением. Импортируется пачками, дубли отсеиваются.

🧪 Тест на себя

Бот отправляет в канал одну служебную волну, упомянув только вас. Проверьте:

• пришёл ли пуш (замьютьте канал на телефоне и повторите — эффект нагляднее);
• в самом сообщении не видно списка упоминаний — только текст.

Служебное сообщение само удалится через ~12 секунд, либо жмите «🗑 Удалить из канала сейчас».

🚀 Запуск пинга

Мастер из 4 шагов. Ничего не публикуется в канал, пока вы не нажмёте «🚀 Старт».

Шаг 1 — что за пост

• 📝 Прислать пост боту — отправьте текст / фото / видео. Бот опубликует его в канал при старте.
• 🔗 Пост уже опубликован в канале — перешлите этот пост или пришлите ссылку.

Шаг 2 — текст уведомления

Это 1–2 строки, которые человек увидит в пуше и на пару секунд в ленте. Должно цеплять и звать открыть канал. Ссылку на пост бот добавит сам. Можно написать свой текст или оставить пример (🔔 new drop in the channel 👇).

Шаг 3 — кому

подписчики (активные)

основной вариант: те, кто, по данным бота, в канале

все известные id

вообще все, кого бот знает, включая вышедших

замечены за 7 / 30 дней

кто недавно как-то проявлялся

только вышедшие

для проверки «жив ли пинг»

только я / явный список id

тест на себя или на конкретные id

Шаг 4 — проверка и старт

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

Ход кампании

После старта кампания идёт в фоне. Отчёты — старт, прогресс, финиш, ошибки — приходят в штаб-чат. Запустившему — короткая копия в личку.

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

⚙️ Настройки

Кнопка ⚙️ Настройки в карточке проекта.

• Удаление служебного сообщения. Пуш уходит в момент отправки, поэтому сообщение можно убирать почти сразу. По умолчанию 3 секунды. «Не убирать» — оставлять в ленте (обычно не нужно).
• Кулдаун. Минимальный интервал между двумя пингами одного человека. По умолчанию 24 часа.

🚫 Кого не пинговать

Список id, которые никогда не получат пинг, даже если попадут в базу. Нужно для самой модели, менеджеров, знакомых, конкурентов.

Кнопка 🚫 Кого не пинговать → «➕ Добавить id в исключения» → пришлите id через пробел. Убрать — так же через «➖».

📸 Instagram-алерты

Кнопка 📸 Instagram-алерты в карточке проекта.

1. ➕ Добавить IG-аккаунт → пришлите ник (например, imsamira). Если авто-режим уже включён, бот сразу проверит в Instagram, что такой аккаунт есть, и покажет имя и число подписчиков — убедитесь, что это правда та модель, прежде чем продолжать.
2. 🎯 пороги → отметьте значения просмотров галочками (10k / 30k / 100k / …) или задайте свои числа кнопкой «✍️ Свои числа».
3. Когда просмотры рилса пересекают порог — бот пишет в штаб-чат. Один рилс × один порог = один раз. Растёт дальше — следующий порог.

Что нужно для авто-режима

Бот сам смотрит Reels только при наличии логина Instagram. Это разовая настройка на сервере (не в этом мануале — см. .env.example и DEPLOY.md в репозитории), в двух словах:

1. Завести отдельный аккаунт Instagram под бота (не основной аккаунт модели).
2. Залогинить его на сервере, пересобрать: WITH_IG=1 docker compose up -d --build.

Один аккаунт-наблюдатель тянет все хэндлы всех моделей. В карточке Instagram-алертов будет 🟢 Авто-режим включён. Проверки идут не строго по расписанию, а в среднем раз в IG_POLL_INTERVAL_MIN со случайным разбросом (IG_POLL_JITTER_PCT, по умолчанию ±35%) — заход ровно каждые 30 минут секунда в секунду сам по себе похож на бота, разброс это немного маскирует. Если аккаунтов несколько — между ними тоже случайная пауза, а не все разом.

🔍 Проверить аккаунт

Кнопка рядом с ником в списке Instagram-аккаунтов (нужен авто-режим). В любой момент показывает, кто реально привязан — имя, число подписчиков, закрытый ли аккаунт. Полезно, если добавили ник по памяти или с опечаткой: не ждать первого алерта, а сверить сразу.

📊 Просмотры последних Reels

Кнопка в карточке (только в авто-режиме). Админ жмёт — бот показывает текущие просмотры 6 последних рилсов по каждому аккаунту, отсортированные по просмотрам.

🎬 Автопост из очереди

Отдельная, необязательная функция: цель по просмотрам для конкретного Instagram-аккаунта (кнопка 🎬 автопост на карточке аккаунта). Когда очередной ролик набирает эту цель — бот сам публикует в канал проекта следующий пост из очереди.

1. 📦 Очередь постов в разделе Instagram-алертов → «➕ Добавить пост» → пришлите готовый пост (текст/фото/видео) боту. Он встаёт в конец очереди; порядок можно менять стрелками ⬆️⬇️.
2. На карточке нужного IG-аккаунта → 🎬 автопост → задайте цель по просмотрам (например 50000) или 0, чтобы выключить.
3. Как только любой ролик этого аккаунта наберёт цель — бот публикует верхний пост из очереди и пишет в штаб, сколько осталось. Если очередь пуста — придёт предупреждение вместо публикации.

Источники трафика

☰ Меню → 📊 Статистика (или карточка проекта → 🔗 Источники трафика). Источник — это отдельная ссылка на конкретный канал, модуль GramGPT (нейрокомментинг / нейрочаттинг / массреакции / масслукинг) или партию аккаунтов. Бот запоминает, через какую именно ссылку пришёл человек — так видно, какой источник реально приводит подписчиков, а какой только гоняет пустые переходы.

1. ➕ Добавить источник → название для себя (например «Нейрокомментинг / крипто-каналы») → тип источника кнопками.
2. Бот выдаёт готовую ссылку вида t.me/<бот>?start=p_<id проекта>_src_<id источника>. Вставьте её в описание/био того канала, аккаунта или inline-поста, который относится к этому источнику.
3. Каждый источник можно временно выключить (🚫) и включить обратно — ссылка при этом не меняется, просто клики по ней перестают/начинают считаться помеченными.

Ссылка на площадку и что видит подписчик

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

1. В разделе «📊 Статистика» → 🔁 Ссылка на площадку → пришлите ссылку с плейсхолдером {click_id}, например: https://platform.com/?ref=XXX&sub_id={click_id}.
2. С этого момента переход по ссылке любого источника этого проекта подставляет в {click_id} уникальную метку клика и показывает подписчику кнопку «🔗 Перейти» вместо обычного приветствия.
3. Пришлите -, чтобы убрать ссылку — вернётся обычное приветствие без кнопки.

Отчёт, оплаты и возврат тех, кто не купил

📊 Отчёт по источникам

В разделе «📊 Статистика» — таблица: источник, сколько кликов, сколько конверсий, на какую сумму. Появляется, как только есть хотя бы один источник.

Как узнают об оплате

Два способа, можно оба сразу:

• Постбек. Если площадка умеет присылать уведомление о событии — ей дают технический адрес вида .../postback?token=…&sub_id=<click_id>&event=reg|deposit|sale&amount=…. Настраивается один раз на сервере — не через это меню, спросите у того, кто разворачивал бота.
• 📥 Импорт оплат (CSV). Если площадка постбек не умеет — кнопка в разделе «📊 Статистика», принимает файл с колонками sub_id,event,amount,date (event: reg/deposit/sale). Загружайте выгрузку из личного кабинета площадки время от времени — цифры в отчёте обновятся.

Возврат тех, кто кликнул, но не купил

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

👤 Админы и супер-админы

Всё это — только для супер-админа.

Админ проекта

Карточка проекта → 👤 Админы проекта.

• ➕ Добавить админа (этот проект) → перешлите боту любое сообщение этого человека (или пришлите его числовой user_id — подскажет @userinfobot, если у форварда скрыт автор). Человек должен хотя бы раз нажать /start у бота.
• ➕➕ Добавить сразу в несколько проектов → тот же форвард/id, а потом галочками отмечаете нужные проекты (или «Выбрать все») и жмёте «Добавить в N». Не нужно заходить в каждый проект по отдельности.
• Снять — кнопкой ➖ напротив имени.

Что может админ проекта: импорт, запуск пингов, статистика, настройки, Instagram, исключения — в рамках проектов, куда его добавили. Не может: создавать и удалять проекты, назначать админов, трогать стоп-кран.

Супер-админ

«📁 Все проекты» → 👑 Супер-админы (кнопка видна только супер-админам).

• Супер-админ может всё: создавать/удалять проекты, назначать админов, стоп-кран /kill, и добавлять других супер-админов.
• ➕ Добавить супер-админа → форвард сообщения этого человека или его user_id. Давайте только тем, кому полностью доверяете.
• Супер-админы из файла .env (первичная настройка на сервере) в списке помечены и снять их можно только на сервере — это «корень доверия», чтобы нельзя было случайно отобрать доступ у всех. Добавленных в боте — можно снять кнопкой ➖.

Наблюдатель статистики

Тоже только для супер-админа.

Более узкая роль, чем обычный админ проекта: видит только раздел «📊 Статистика» — источники трафика, ссылку на площадку, отчёт, импорт оплат. Кампании, подписчиков, настройки и Instagram этого проекта ему не показывают вообще. Удобно для человека, который занимается конкретно аналитикой трафика и не должен трогать остальное.

1. Карточка проекта → 👤 Админы проекта → 📊 Добавить наблюдателя статистики → перешлите сообщение этого человека или пришлите его user_id (как с обычным админом).
2. Роль привязана к конкретному проекту, как и обычное админство — чтобы дать доступ к нескольким проектам, повторите в каждом.
3. Снять — кнопкой ➖ 📊 напротив имени в том же списке.

🗑 Удаление проекта

Удаляет проект со всеми кампаниями, IG-аккаунтами и настройками. Канал и сам бот не трогаются.

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

Штаб-чат и стоп-кран

• Штаб-чат — куда бот шлёт отчёты по кампаниям, ошибки, IG-алерты, предупреждения о потере прав. Задаётся один раз в .env.
• /kill (супер-админ) — немедленно останавливает все кампании и не берёт новые в работу. /unlock — снять блокировку. На случай, если что-то пошло вразнос.

Частые вопросы

Почему бот не видит всех подписчиков сразу?

Telegram не отдаёт ботам список подписчиков канала. Совсем. Это защита платформы. Обойти можно только сторонним «юзерботом» на реальном аккаунте — а это против правил Telegram и грозит баном аккаунта. Pulse собирает id честно, по мере активности.

Почему в ленте канала чисто, если бот шлёт кучу сообщений?

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

Подписчики увидят, что их упомянули?

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

Что если запустить пинг дважды подряд?

Второй раз почти всех отсеет кулдаун (их пинговали только что). Плюс бот не даст стартовать вторую кампанию, пока идёт первая.

Это безопасно для канала?

Относительно. Массовые скрытые упоминания — серый приём. Редко и по делу (оффер, стрим, PPV) — обычно ок. Каждый день — жалобы, ограничения бота и канала. Стоп-кран /kill на случай проблем есть.

Может ли чужая команда «увести» себе наш проект или канал?

Нет. Любой доступ выдаёт только супер-админ, вручную. Первый супер-админ задаётся один раз в файле .env на сервере (SUPERADMIN_IDS) — его нельзя снять из бота. Дальше супер-админ может добавлять админов проектов и других супер-админов только явно, форвардом сообщения человека или по его user_id. Привязать канал к проекту можно только в личной переписке с ботом, никогда — командой прямо в канале. Знать слаг проекта — не значит иметь к нему доступ.

Чем «наблюдатель статистики» отличается от обычного админа?

Обычный админ проекта видит все три раздела: Нотификатор, Instagram, Статистика. Наблюдатель статистики — только раздел «📊 Статистика» этого проекта, и ничего больше. Удобно для человека, который считает трафик, но не должен запускать пинги или трогать Instagram. Подробнее — раздел 17.

Подписчик как-то поймёт, что за ним следят через ссылку с меткой?

Нет отличий от обычного перехода в канал/бота. Метка источника и click_id — служебные данные внутри бота, человеку виден только обычный текст приветствия и, если задана ссылка на площадку, одна кнопка «Перейти».

Термины

Проект

одна модель: свой канал, аудитория, настройки, IG-аккаунты, админы

Активный проект

тот, к которому сейчас применяются кнопки раздела «🔔 Нотификатор»

Канонический пост

ваш пост, который бот публикует в канал один раз

Служебное сообщение / ghost-волна

короткое сообщение со скрытыми упоминаниями, которое создаёт пуш и удаляется

Текст уведомления

1–2 строки, которые человек видит в пуше и мельком в ленте

Сегмент

кого пинговать в этой кампании

Кулдаун

минимальный интервал между двумя пингами одного человека

Штаб-чат

чат, куда бот шлёт отчёты и алерты

Порог (Instagram)

число просмотров рилса, при пересечении которого приходит алерт

Источник трафика

отдельная ссылка на канал/модуль/партию аккаунтов — раздел 13

click_id

уникальная метка одного клика по трекнутой ссылке, передаётся площадке как sub_id

Конверсия

оплата/регистрация, о которой площадка сообщила — постбеком или CSV

Постбек

уведомление о конверсии, которое площадка сама присылает боту

Наблюдатель статистики

роль с доступом только к разделу «📊 Статистика» одного проекта — раздел 17