Прокладка (турникет-бот)

Свой Telegram-бот на входе трафика — подключение токеном из BotFather, локализованное приветствие, сплит мусора в канал и авто-атрибуция каждого /start.

Прокладка — это ваш собственный Telegram-бот, стоящий между платным трафиком и вашей личкой. Вместо того чтобы вести рекламу напрямую в аккаунт менеджера, вы ведёте её на бота: он здоровается с каждым, кто нажал /start, отдаёт одну кнопку в личку — и по дороге делает две вещи, которые не умеет голая ссылка:

Атрибуция. Любая кнопка или редирект, ведущие на t.me/<ваш-бот>, автоматически получают персональный ?start= с click-id. Каждый /start привязывается к исходному клику (страна, домен, источник) — воронка «клик → подписчик → деньги» сходится без ручной разметки. Работает принцип «первый клик владеет юзером»: повторные /start ничего не перезаписывают.
Сплит трафика. Мусор (свежесозданные аккаунты — тролли, школьники, боты) можно автоматически отправлять в публичный канал, чтобы они даже не увидели ссылку на личку. Качественный трафик проходит в ЛС.

Подключение

Вкладка Дашборд → Telegram → Прокладка:

Создайте бота в @BotFather (/newbot) и скопируйте токен.
Вставьте токен в поле «Токен бота из @BotFather» → Подключить бота. Вебхук настроится автоматически; токен хранится шифрованно, в интерфейсе видна только маска.
Укажите «Куда ведёт кнопка» — обычно https://t.me/<ник-менеджера>.

Статус-карточка показывает здоровье вебхука («последний апдейт N минут назад») и кнопку «Обновить вебхук» на случай, если Telegram потерял подписку.

Ответ бота

Дефолтное приветствие локализовано на 16 языков и выбирается по языку юзера (из deep-link или из Telegram-профиля). Всё переопределяется:

Приветствие и текст кнопки — общий оверрайд для всех языков;
«Приветствия по языкам» — точечные оверрайды per-язык (текст и/или кнопка);
Задержка «печатает…» — бот показывает набор текста 0–4000 мс перед ответом.

Сплит трафика

Telegram-ID растут почти хронологически: аккаунт с очень высоким ID создан недавно. Порог свежести — главный фильтр:

Настройка	Смысл
Сплит включён	Выключен — все идут в ЛС (поведение без прокладки)
Канал для отсева	Куда едут свежереги; они не видят ссылку на ЛС
Порог свежести ID	Аккаунты с ID ≥ порога считаются свежерегами
Premium всегда в ЛС	Telegram Premium = платящий юзер — не отсеивается

Сплит применяется только к новым /start: юзер, уже прошедший в ЛС, при повторном /start не переразмечается. Решение записывается в статистику — калибруйте порог по реальной доле «ЛС vs Канал» на вкладке.

Продвинутый роутинг: направления и правила

Сплит ЛС/Канал выше — частный случай более общего движка: до 20 именованных направлений и до 30 упорядоченных правил, которые проверяются сверху вниз, срабатывает первое совпавшее. Условия можно комбинировать: Premium, «свежесть» аккаунта по ID, язык клиента, страна ИСХОДНОГО клика, наличие юзернейма, пришёл ли юзер с меткой (?start=) или органически. Например: одну страну — локальному менеджеру, свежие не-Premium аккаунты — в канал, всех остальных — в ЛС, одним списком.

Как только сохранено хотя бы одно правило, роутинг полностью переходит на него — старые поля сплита выше перестают читаться. Правила настраиваются в той же вкладке карточкой «Split rules» — бэкенд-контракт см. в английской документации по продукту, раздел Route different audiences with rules.

Синхронизация профиля

Публичная личность бота в Telegram — имя, био, короткое био, аватар — не редактируется как обычные текстовые поля на вкладке: она читается из Telegram и пишется обратно в Telegram. Синк подтягивает текущий профиль бота (устойчив к частичным сбоям — что удалось прочитать, то и сохраняется, даже если один из запросов упал), а правка профиля уходит В Telegram (setMyName/setMyDescription/setMyShortDescription) и сразу перечитывается заново — так карточка всегда показывает то, что Telegram реально принял, а не то, что было напечатано в поле. Саму аватарку можно сменить только в @BotFather — у Bot API нет метода её установки — и затем подтянуть Синком. Подробности — Sync or edit the bot's Telegram profile.

Статистика

На вкладке: /start всего / за 24 часа / за 7 дней, сплит ЛС против Канала, топ языков аудитории и доля Premium — всё по вашему боту, в разрезе вашего аккаунта.

Мультитенантность

Каждый аккаунт платформы подключает своего бота со своим токеном. Вебхук у всех один и тот же URL — арендатор определяется секретом, который Telegram присылает в заголовке X-Telegram-Bot-Api-Secret-Token; чужой /start физически не может записаться в ваш аккаунт.