Модуль Боты в TG Lead Finder — якорь #bots, заголовок экрана «Боты · Telegram Bot API». Как подключить токен от @BotFather, что делают getMe и webhook и почему здесь человек пишет первым — в обзорном гайде Боты: Bot API и webhook. Здесь — только поля UI после подключения: список и рейтинг, карточка бота, пять вкладок, приветствие. Только то, что видно в панели.
Соседи: Регистратор (создаёт новых ботов пачкой), форма Входящих (диалоги аккаунтов, не бота), форма Парсера ботов (ищет чужих ботов), форма Ключей, первый день в панели.
Чем экран не является
- Не Входящие (#inbox). Там переписка ваших аккаунтов; здесь — диалоги с вашим Bot API-ботом.
- Не Спамер ЛС. Рассылка бота уходит только тем, кто уже есть среди пользователей бота, а не по спарсенной базе юзернеймов.
- Не Регистратор. Регистратор создаёт ботов через @BotFather; Боты — панель уже существующего бота. Бот из Регистратора подключается сюда кнопкой «Подключить в модуль «Боты»», после этого там пометка «→ в Ботах».
- Не Парсер ботов. Тот ищет чужих ботов в выдаче; здесь только ваши.
Список ботов и кнопка «+ Добавить бота»
Вверху справа кнопка «+ Добавить бота». Она открывает модалку «Добавить бота» с одним полем «Токен от @BotFather» (скрытый ввод, плейсхолдер «123456:AA... (хранится шифрованно)») и подписью «Проверим через getMe и сразу зарегистрируем webhook на этот сервер». Кнопки Отмена и Добавить; пустое поле — ошибка «вставь токен».
Ниже — карточки ботов: имя или @username, метка (если задана) и индикатор 🟢 / ⚪. Пустой список: «Ботов нет. Нажми «Добавить бота» — вставь токен от @BotFather.» Клик по карточке открывает карточку бота.
Рейтинг ботов
Пока открыт список, под ним блок «Рейтинг ботов» — даже для одного бота (одной строкой).
- Период — вкладки День / Неделя / Месяц / Всё время (по умолчанию Неделя).
- Метрика сортировки — список: Новых пользователей (по умолчанию), Входящих сообщений, Активных пользователей, Заблокировали, Вступлений в чаты.
- Таблица: #, Бот, выбранная метрика с местом и дельтой ▲/▼ в процентах, затем колонки Новые, Входящие, Активные, Блок, Чаты и Σ юзеров.
- Нет данных — «Нет данных за период.» Клик по строке открывает бота.
Карточка бота: шапка и счётчики
Шапка: «← К списку», название (метка · @username, имя и замаскированный токен) и три кнопки справа:
- 🔗 Webhook — перепривязать webhook (подсказка: при смене домена);
- 👋 Приветствие — модалка приветственного сообщения (ниже);
- 🗑 — удалить бота. Подтверждение предупреждает: удалятся бот и все его данные (диалоги, пользователи, рассылки), webhook снимется.
Под вкладками ряд счётчиков: Пользователей, Активны 7д, Активны 30д, Новых 7д, Входящих, Заблокировали.
Вкладка «Диалоги»
Слева список тредов: имя, бейдж «заблок», если пользователь заблокировал бота, и превью последнего сообщения («вы: …», если последним писал бот). Пустой список: «Пока никто не писал боту.» Справа до выбора — «Выбери диалог слева»; после — шапка (имя, @username, «заблокировал»), лента сообщений и строка ответа с плейсхолдером «ответ юзеру…» и кнопкой Отправить. Ответ здесь текстовый; вложений, как во Входящих, в этой строке нет.
Вкладка «Рассылка»
Слева форма, справа История рассылок. Поля формы:
- Текст рассылки (HTML) * — обязателен; пусто → «текст обязателен»;
- Сегмент: Все / Активны за 7 дней / Активны за 30 дней;
- Отложить до (необязательно) — дата и время;
- Кнопка: текст и Кнопка: URL — кнопка уйдёт, только если заполнены оба поля;
- Баннер-картинка — необязательно, jpg/png/webp до 10 МБ, с превью и крестиком «Убрать баннер»;
- счётчик символов: 0 / 4096, с баннером — 1024; длиннее — предупреждение, что текст уйдёт вторым сообщением под картинкой;
- кнопка 📤 Запустить рассылку — сообщение «рассылка запущена» или «рассылка запланирована».
История: #, Сегмент (🖼 — с баннером), Статус, Отпр/Всего, Ошибок, Когда (⏰ — отложенная). Пусто — «Рассылок не было».
Вкладки «Пользователи» и «Чаты»
Пользователи — таблица Имя, Username, Сообщений, Был, Статус (активен / заблокировал) и кнопка 📥 Экспорт CSV справа.
Чаты — где бот администратор. Колонки: Чат, Тип, Участн., Приток/7д, Отток/7д, Чистый, Сообщ/7д и кнопка 📊. Пусто — «Бот пока не добавлен админом ни в один чат. Аналитика доступна только там, где бот — администратор.» Кнопка 📊 открывает карточку чата: 7 и 30 дней (вступления, выходы, сообщения), столбики вступлений и выходов за 14 дней, «Топ активных» и «Последние события».
Вкладка «Настройки» и модалка «Приветствие»
Настройки грузятся с Telegram («Загружаем настройки с Telegram…»). Поля:
- Метка — только в панели, в Telegram не уходит, до 64 символов; пустая → показывается имя/@username;
- Имя бота — до 64;
- Описание — до 512, показывается на пустом экране до /start;
- Краткое описание — до 120, в профиле бота;
- Команды — строчные латинские, цифры и _, без слэша; описание до 256; «+ Команда» и ✕ на строке;
- аватарку через Bot API не сменить — только в @BotFather командой /setuserpic;
- 💾 Сохранить настройки; без правок — «нет изменений».
Модалка «Приветственное сообщение»: чекбокс «Отправлять приветствие (на /start и первое сообщение)», Текст (HTML), баннер jpg/png/webp до 10 МБ (загружается сразу при выборе, 🗑 — удалить). С баннером текст до 1024 идёт подписью под фото, длиннее — вторым сообщением. Кнопки Отмена и Сохранить.
Порядок настройки и где ломается
- Добавьте бота токеном (или подключите из Регистратора) — дождитесь «webhook привязан».
- Настройки: метка, имя, описание до /start, краткое описание, команды → Сохранить.
- Приветствие: включите чекбокс, текст, при желании баннер → Сохранить.
- Ведите трафик так, чтобы человек написал первым; отвечайте во вкладке Диалоги.
- Рассылку — по сегменту активных, с кнопкой и, если нужно, отложкой.
- Динамику сравнивайте в Рейтинге по неделям, отток — по колонке Блок.
- Сменили домен панели, а webhook старый — жмите 🔗 Webhook.
- Кнопка в рассылке не появилась — заполнено только одно из двух полей.
- Длинный текст с баннером «развалился» на два сообщения — лимит подписи 1024.
- Вкладка Чаты пустая — бот не администратор в чате.
- Ищут аватарку в Настройках — её меняют только в @BotFather.
Коротко
Боты (#bots) — панель вашего Bot API-бота: список с рейтингом по периодам и метрикам; карточка с Webhook, Приветствием и удалением; счётчики; вкладки Диалоги (ответ текстом), Рассылка (HTML, сегмент, отложка, кнопка, баннер, 4096/1024), Пользователи (CSV), Чаты (аналитика там, где бот админ) и Настройки профиля. Обзор модуля — Боты: Bot API и webhook; создание ботов пачкой — Регистратор.
