Боты в Telegram: Bot API и webhook в TG Lead Finder

Боты в TG Lead Finder — это панель своего уже существующего бота через Telegram Bot API. Раздел в сайдбаре: ИНСТРУМЕНТЫ → Боты, якорь #bots. Заголовок экрана: «Боты Telegram Bot API». Сюда несут токен от @BotFather: панель проверяет его через getMe и сразу вешает webhook на этот сервер. Смысл узкий и честный: человек пишет боту первым. Это входящий Bot API, не холодная личка и не фабрика новых ботов.

Экран тонкий: нет CRM, автоответов и воронки. Пусто — подсказка и + Добавить бота. Только документированный UI, без выдуманных лимитов. Соседей разводим сразу: Регистратор (вкладка «Боты» создаёт пачку), Парсер ботов (чужих), Ключи (токены модуля Боты туда не кладут).

Чем не путать

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

• Боты (#bots). Свой готовый токен от @BotFather → вставка → getMe → webhook на сервер панели. Люди пишут боту первыми. Это этот гайд.
• Регистратор → вкладка «Боты» (#registrator). Фабрика: имя, юзернейм с суффиксом bot, описание, пачка новых ботов. Создал здесь — если нужен webhook панели, токен несёшь в #bots. Не одним экраном. Гайд: фабрика объектов и чекер юзернеймов.
• Парсер ботов (#botparser, в сайдбаре «Боты-п.»). Поиск чужих ботов по ключам, чтение описания. /start не жмёт. Разведка ниши, не твой Bot API. Гайд: описание без /start.
• Ключи (#apikeys). api_id/api_hash и внешние ключи Smart Leads / TGStat. На вкладке Ключи прямо сказано: токены ботов модуля «Боты» тут не хранятся. Гайд: хеши и API.
• Бот уведомлений Smart Leads. Отдельный токен от @BotFather плюс chat_id — чтобы лиды падали тебе в канал/чат. Живёт на вкладке Ключи, не в #bots. Гайд: Smart Leads.
• Токен бота в Парсере 3.0. Своё поле модуля: live-лента заявок в твой канал. Это не список #bots и не webhook-панель. Гайд: мониторинг чатов в реальном времени.
• Спамер ЛС. Ты пишешь людям первым. Противоположность логике «человек пишет первым». Гайд: почему личка — не первый шаг.

Коротко в одной строке: создать пачку — Регистратор; подключить токен и webhook — #bots; найти чужих — Парсер ботов; api_id и Smart Leads — Ключи; холодная личка — ЛС.

Что на экране

UI модуля честно тонкий. Не дорисовывай то, чего нет на скрине.

• Сайдбар: блок ИНСТРУМЕНТЫ, пункт Боты, hash #bots.
• Заголовок: «Боты Telegram Bot API».
• Справа сверху кнопка + Добавить бота.
• Пустое состояние: «Ботов нет. Нажми «Добавить бота» — вставь токен от @BotFather.»

Нет таблицы «воронка», нет редактора сценариев, нет кнопки «открыть входящие из этого экрана». Список ботов появляется после добавления — до этого экран пустой и так и должен выглядеть. Если ждал конструктор диалогов, ты не в том разделе: здесь подключение Bot API и webhook, не CRM.

Версия в футере (например v1.1.22 · schema v16) — служебная отметка, не аргумент продажи. На неё не опираемся.

Откуда токен: только @BotFather

Токен для этого модуля берётся у @BotFather в Telegram. Это официальный способ получить Bot API-токен своего бота. Панель не выдаёт токен «из воздуха» и не подменяет BotFather.

Два пути до токена: бот уже был — берёшь токен у @BotFather и несёшь в #bots; бота ещё нет — создаёшь в Регистраторе (вкладка «Боты») или вручную у @BotFather, потом токен в #bots, если нужен webhook панели.

Три разных «токена от BotFather» в продукте не склеивать: #bots (getMe + webhook, люди пишут боту); бот уведомлений на Ключах (лиды Smart Leads себе + chat_id); поле бота в Парсере 3.0 (лента в твой канал). Один формат строки не делает экраны одним хранилищем.

Как добавить бота

Шаги ровно по модалке, без героизма.

1. Открой ИНСТРУМЕНТЫ → Боты (#bots).
2. Жми + Добавить бота.
3. Откроется модалка «Добавить бота».
4. Поле: «Токен от @BotFather». Плейсхолдер на экране: 123456:AA... (хранится шифрованно) — в description.txt написано «шифрованно», на скрине модалки та же идея может читаться как «шифровано» (обрезка/вариант написания). Смысл один: токен хранится в зашифрованном виде, не светится целиком как пароль в блокноте. Не выдумывай отдельную «систему ротации ключей» — на экране этого нет.
5. Под полем хелпер: «Проверим через getMe и сразу зарегистрируем webhook на этот сервер.»
6. Кнопки: Отмена / Добавить.

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

Добавить — единственный подтверждённый шаг. После него панель делает то, что написано в хелпере: getMe и webhook на этот сервер. Отдельной второй кнопки «зарегистрировать webhook позже» на экране нет — логика сразу в хелпере.

Аватар бота через Bot API с этого экрана не меняется. Документация модуля прямо: только @BotFather и команда /setuserpic. Не ищи кнопку аватара в #bots — её нет. Не путай с Регистратором, где при создании каналов/чатов есть ротация аватарок файлами: у подключения Bot API-токена другой контракт.

getMe и webhook на этот сервер

Хелпер модалки — вся «магия» модуля в одной фразе. Разберём без фантазии.

getMe. Стандартный метод Telegram Bot API: по токену панель спрашивает у Telegram, кто этот бот. Если токен битый, отозванный или с опечаткой — дальше смысла нет. Именно поэтому проверка заявлена до/вместе с webhook, а не «сохраним строку и разберёмся потом».

Webhook на этот сервер. Обновления Bot API (входящие сообщения человеку→боту и события бота) Telegram шлёт на сервер этой панели, не на твой домашний ngrok «на глаз» и не в Ключи. Фраза на экране буквальная: «на этот сервер». Отдельного поля «вставь URL webhook» в модалке нет — URL панели берёт сама. Не дописывай в гайд кастомный endpoint, секретный path и «свой nginx» — на UI модуля этого нет.

Следствия без фантазии: токен — от бота, который готов обслуживать через панель; если бот уже слушал чужой webhook, регистрация на сервер панели перебьёт его в пользу TGLF (один webhook на бота в Bot API) — это не баг; «положить токен на полку» без webhook — не сценарий #bots. Часовых/суточных лимитов на экране нет — не выдумывай капы. Форма одна, поле одно, две кнопки.

Человек пишет первым

В продуктовой логике TG Lead Finder у модуля Боты короткий тезис: «человек пишет первым». Это не слоган маркетинга, а направление диалога.

Человек открыл твоего бота в Telegram, нажал Start или написал сообщение — обновление пришло по Bot API на webhook панели. Ты не холодным текстом долбишь чужие лички от имени бота пачкой. Холодная личка с аккаунта — другой модуль и другой риск: рассылка в личку.

#bots сам по себе не открывает Входящие кнопкой «ответить из бота» (Входящие — про тех, кто написал аккаунту), не заменяет Пушинг/Комментатор/ЛС, не учит массовым непрошеным сообщениям из бота и не парсит чужих ботов — это Парсер ботов. Белый порядок: бот как точка входа, куда человек приходит сам; панель принимает Bot API-поток. «Воронки внутри #bots» на экране нет.

После подключения: куда не ходить

Токен добавили, getMe прошёл, webhook на сервере панели. Что делать дальше — и чего не делать.

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

Нельзя ждать с этого экрана: inbox/переписку как мессенджер; автоответы и CRM; смену аватара (только @BotFather /setuserpic); автоподхват токена Парсером 3 (у него своё поле); лиды Smart Leads «потому что бот в #bots» — уведомления настраиваются токеном+chat_id на Ключах.

Пачка из Регистратора: сначала готовность там, потом токен в #bots, если нужен webhook. Регистратор webhook не вешает.

Порядок без прыжка в холодный текст: прокси/аккаунты (user API, не Bot API) → при необходимости Регистратор → #bots (токен, getMe, webhook) → Ключи только для api_id/hash и внешних сервисов → трафик (комменты, входящие, личка) отдельными модулями. Личка не «первый шаг после webhook».

Где ломается

• Токен модуля Боты кладут в Ключи — вкладка это запрещает. Webhook — #bots.
• Вкладка «Боты» Регистратора ≠ #bots: фабрика создаёт, webhook — другой экран.
• Парсер ботов «для проверки своего» — нет; /start не жмёт. Свой токен — getMe в #bots.
• Ждут CRM, автоответы и кнопку входящих на #bots — на UI нет.
• Аватар «через Bot API из панели» — нельзя, только @BotFather /setuserpic.
• Токен Smart Leads (уведомления себе) ≠ токен #bots (люди пишут боту).
• Поле бота в Парсере 3 ≠ список #bots.
• «Человек пишет первым» ≠ спам из бота всем подряд.
• Часовых лимитов на форме нет — поднимать нечего.
• Отмена закрывает модалку без добавления — так и задумано.

Коротко

Боты — #bots, сайдбар ИНСТРУМЕНТЫ, заголовок «Боты Telegram Bot API». Кнопка + Добавить бота. Пусто: «Ботов нет… вставь токен от @BotFather.» Модалка: поле «Токен от @BotFather», плейсхолдер с пометкой хранения (шифрованно / на скрине та же идея «шифровано»), хелпер про getMe и webhook на этот сервер, кнопки Отмена / Добавить. Аватар — только @BotFather /setuserpic. Человек пишет первым. Не Регистратор (фабрика), не Парсер ботов (чужие), не Ключи (токены модуля Боты там не хранят), не бот уведомлений Smart Leads, не поле Парсера 3, не Спамер ЛС. Лимитов на экране нет — не выдумывать. Модуль в TG Lead Finder. Соседи: регистратор, парсер ботов, ключи, smart leads, парсер 3, личка, входящие. Все гайды: /guides.html.