Telegram-бот для отчётов Яндекс Директ: BotFather, один бот на все чаты
Официальный BotFather, один бот во все клиентские чаты и админ-права на свои сообщения. Идентификаторы и токен в статью не попадают.
Получить предложение
Зачем бот, если можно переслать файл руками
Прослойка доставки, не «боты как мусорный трафик» в Директе.
Запрос «телеграм бот яндекс директ» путают с антиботом и с мусорными площадками. Здесь бот — курьер агентского PDF. Он не крутит ставки и не модерирует объявления. Ведение Яндекс Директ остаётся у директолога; бот только кладёт файл туда, где клиент уже читает переписку.
Ручная пересылка с личного аккаунта ломается на правах, отпусках и смене менеджера. Один технический отправитель переживает смену людей. Это кусок автоматизации рекламы как процесса, не «бот для Директа» в смысле автобиддера.
Как отличить настоящий BotFather и создать бота
Галочка, username на bot, токен сразу в закрытое место.
Открывают официальный BotFather с галочкой, жмут Start, создают бота: человекочитаемое имя и username с хвостом bot. Команды BotFather стандартные — этот текст не дублирует generic-гайд «как создать бота в телеграм». Нужен только кусок, без которого не уедет отчёт Директа.
Один бот на все клиентские чаты
Не плодить бота на каждый рекламный кабинет.
Одного бота добавляют во все чаты, куда должен падать отчёт. Кабинетов может быть десятки — отправитель один. Так проще отозвать доступ: убрали бота из чата, и контур этого клиента молчит. Новый бот на каждый логин плодит токены и дыры.
Связка с кабинетами живёт в файле окружения: токен Директа, логин, токен бота, идентификатор чата. Как получить API-токен — в инструкции про oauth и заявку. Когда вообще нужен авто вместо полуручного — в статье про режимы.
Права администратора в чате клиента
Удалять свои сообщения и закреплять файл.
Без админ-прав бот часто умеет только написать раз. Ошиблись в периоде — нельзя подчистить. Права администратора как раз для своих сообщений: удалил кривой PDF, прислал верный, закрепил. Чужие сообщения боту не нужны. Телефоны и имена групп с учебных слайдов в текст не переносим.
Как снять идентификатор чата без цифр в статье
Getmyid_bot показывает идентификатор. Публиковать его нельзя.
В чат, куда должен уходить отчёт, добавляют Getmyid_bot и смотрят идентификатор текущего чата. Значение сразу в секреты окружения. На слайде числа уже скрыты — так и оставляем. Слитый идентификатор плюс токен бота = чужой доступ к клиентскому чату.
- Проверить, что в чате именно официальный BotFather-бот агентства, не фейк.
- Выдать боту админ-права на свои сообщения.
- Снять идентификатор через Getmyid_bot внутри этого чата.
- Положить идентификатор в закрытый файл, не в переписку.
- Прогнать тестовый PDF в служебный чат, не в клиентский.
- Только после проверки включить расписание на боевой чат.
Куда класть токен и почему не MAX
Секреты не в git. MAX — оговорка «не надо».
Токен бота — такой же секрет, как токен Директа. Его не коммитят, не кладут в название репозитория и не шлют «на всякий случай» в общий чат. Расписание и промпт — статья про ИИ-отчёты и понедельник. Обзор всего контура — страница разбора.
MAX в эфире звучал дважды. Сначала как «технически можно через бизнес-контур». Потом Костя коротко: не занимайтесь этим. Для статьи достаточно одной фразы: приоритет Telegram, пошаговой схемы MAX нет.
Отдельно про команды BotFather: generic-статьи учат меню и аватарку. Для отчёта Директа аватарка не обязательна. Обязательны три вещи: галочка у BotFather, один токен в секретах, бот реально состоит в том чате, куда должен упасть файл. Если бота добавили, но идентификатор сняли из другого чата, PDF уедет не туда — это самая частая бытовая ошибка, не «telegram bot api send».
Тестовый прогон всегда в служебный чат команды. Клиентский чат видит только уже проверенный файл. Так вы не объясняете заказчику, почему в PDF чужая ниша или пустая Метрика. Когда контур стабилен, тот же бот начинает жить на расписании — это уже ИИ-отчёты и понедельник, не новая учётка BotFather.
Бот для Яндекс Директ в MAX в поиске почти не ищут — и не надо раздувать эту ветку. Если клиент сидит только в MAX, в эфире всё равно оставляют Telegram как рабочий канал отчёта. Переносить контур «потому что клиент так сказал» без юрлица и бизнес-доступа — путь к двум недоделанным ботам и нулю файлов.
Как создать бота в BotFather и как сделать бота в BotFather — один и тот же бытовой запрос. Ответ для отчётов Директа короче generic-статьи: галочка, username на bot, токен в секреты, бот в чат, админ на свои сообщения, идентификатор через Getmyid_bot. Всё, что про аватар, описание и «команды для пользователей», этому контуру не нужно: клиент не пишет боту, бот пишет клиенту файлом.
Ботфазер в телеграм ищут и школьники, и агентства. Разница не в меню, а в том, куда потом денется токен. Школьный бот живёт в чате разработчика. Агентский — в десяти клиентских чатах и в облачном секрете. Потерять токен школьного бота обидно. Потерять агентский — это доступ к переписке заказчиков. Поэтому один бот, один секрет, один человек, кто его ротирует.
Telegram api bot token в поисковой выдаче ведёт на общую документацию отправки сообщений. Её достаточно один раз прочитать команде, которая пишет код. Директологу достаточно знать: токен не светить, чат не путать, тестовый файл не слать заказчику. Боты в Яндекс Директ как мусорный трафик к этой задаче отношения не имеют — не ставьте минусацию ботов и доставку отчёта в один регламент.
Бот через BotFather и бот в BotFather — бытовые формулировки одной и той же кнопки Start. После Start не нужно городить меню «нажми 1, чтобы получить отчёт». Клиент не оператор бота. Отчёт приходит сам по расписанию или после полуручного запуска. Лишние команды только путают заказчика и плодят случайные нажатия.
Если в агентстве несколько директологов, бота всё равно оставляют одного. Права на секрет — у технического человека. Права на клиентский чат — у аккаунта, который ведёт переписку. Так проще отозвать доступ: уволили менеджера — убрали его из чата, бот остаётся и продолжает слать файл.
Ботфазер тг в выдаче часто ведёт на видео «создай бота за минуту». Минута правда нужна только на имя и токен. Час уходит на чаты, права, секреты и тестовый файл. Если продаёте клиенту «бот за минуту», вы продаёте только кнопку Start. Доставка отчёта Яндекс Директ начинается после кнопки, не на ней.
Создать бота в телеграм BotFather можно за минуту. Минута не равна готовому контуру. Готовый контур — это один бот, закрытый токен, верный чат и тестовый PDF, который команда уже прочитала. Пока этого нет, расписание включать рано: бот будет исправно слать сырьё. Лучше три тестовых файла в служебный чат, чем один сырой в клиентский.
| Действие | Можно | Нельзя |
|---|---|---|
| Создать бота | Официальный BotFather с галочкой | Фейк без галочки |
| Масштаб | Один бот на все чаты | Бот на каждый кабинет |
| Права | Админ на свои сообщения | Полный доступ «на всякий» |
| Секреты | Файл окружения и облачные секреты | git, подпись слайда, чат |
Частые вопросы
BotFather, один бот, права и секреты — без generic-гайда и без MAX.
Почему не отправлять файл «от своего имени»?
Личный User API Telegram в РФ сейчас получить трудно. Бот — прослойка: один технический отправитель, одни права, один токен в закрытом файле.
Как отличить настоящий BotFather?
Только аккаунт с галочкой. Фейки повторяют имя и просят токен «для проверки». Настоящий BotFather сам выдаёт токен после создания бота и не просит прислать его в ответ.
Зачем один бот на все чаты, а не бот на кабинет?
Проще крутить права, проще хранить один токен, проще не потерять десяток учёток. Лимита «без Premium сейчас нет» в эфире звучало как наблюдение, не как обещание навсегда.
Какие права выдавать боту в клиентском чате?
Администратор с правом удалять свои сообщения и закреплять. Иначе отчёт нельзя поправить, не оставляя хвост ошибочных файлов.
Как снять идентификатор чата, не публикуя цифры?
Через Getmyid_bot смотрят идентификатор текущего чата и кладут его в закрытый файл окружения. В статьи, подписи к картинкам и чаты команды цифры не копируют.
Куда класть токен бота?
В закрытый файл окружения и секреты облака. Не в git, не в название репозитория, не в переписку. Учебный кадр, где агент коммитит окружение, — антипример.
Стоит ли параллельно делать бота в MAX?
Костя отговаривает. Там нужен бизнес-контур и юрлицо. Для отчётов Директа приоритет — Telegram. Отдельная инструкция по MAX в этот текст не входит.
Нужна доставка отчёта в чат клиента, а не ещё один личный аккаунт менеджера?
Соберём одного бота на все чаты и закроем секреты так, чтобы токен не уехал в git и не светился в переписке.
