Telegram-бот для Яндекс Директа: отчёты, тревоги и управление рекламой из мессенджера

Зачем нужен бот для Яндекс Директа

В кабинет Директа нужно заходить, чтобы узнать, жива ли реклама. Для владельца бизнеса это лишний шаг: логин, пароль, пара экранов, отчёт, который надо собрать. Бот переворачивает схему: цифры приходят туда, где вы и так сидите каждый день.

Чаще всего просят три вещи:

• Регулярный отчёт. Короткая сводка утром или раз в неделю: расход, клики, заявки, цена заявки.
• Тревоги. Сообщение только тогда, когда что-то пошло не так: расход резко вырос, показы упали, на счёте заканчиваются деньги, сайт перестал открываться.
• Команды. Ответ на вопрос «что сейчас идёт» и остановка кампании одной кнопкой, если вы увидели проблему с телефона.

Первая задача самая простая и самая популярная, мы разбирали её отдельно в статье про автоматические отчёты в Telegram. Здесь поговорим о двух других: тревогах и командах, потому что именно в них бот уже влияет на деньги.

Как бот работает через API Директа

Telegram-бот сам по себе ничего не знает про вашу рекламу. Это только окошко для переписки. Данные берёт программа, которая работает на сервере или на компьютере и ходит в Директ по API. Схема такая:

1. Вы создаёте бота в Telegram через служебного бота @BotFather и получаете его ключ.
2. Вы разрешаете программе доступ к кабинету Директа: она получает авторизационный токен.
3. Программа по расписанию запрашивает статистику и состояние кампаний.
4. Если условие сработало (например, расход выше нормы), она пишет вам сообщение.
5. Когда вы нажимаете кнопку «Остановить», программа отправляет команду в Директ.

Что говорит справка Директа про API. Подключение к API и его использование бесплатные. Запросы выполняются от имени пользователя, а доступ даёт OAuth-токен. Чтобы управлять своими кампаниями через API, нужно принять условия на странице API в кабинете, а разработчику приложения подать заявку на доступ. Формат запросов - HTTPS с передачей данных в JSON.

Для вас, как для владельца бизнеса, из этого следует два вывода. Первый: бот не может быть «просто ботом в Telegram», за ним всегда стоит программа с доступом к кабинету, и надо знать, кто её обслуживает и где она хранит токен. Второй: если программа остановилась, бот замолчит. Отсутствие тревог ещё не значит, что всё в порядке, поэтому полезно получать сообщение «бот жив» хотя бы раз в сутки.

Другой подход - не писать свою программу, а подключить готовый сервис. Тогда вы выдаёте доступ сервису, а он отвечает и за работу с API, и за бота. Так устроены и наша подписка, и многие сервисы из сравнения ИИ-сервисов для Яндекс Директа.

Отчёты из Директа в Telegram

Отчёт - самая безобидная задача: бот только читает данные. Поэтому с него и надо начинать, а остальное подключать позже. Чтобы отчёт не превратился в стену цифр, оставьте в нём то, на что вы реально реагируете: расход, число заявок, цену заявки, остаток на счёте и одну строку «что изменилось». Подробно о том, какие метрики брать, как выбрать периодичность и как проверить, что автоотчёт не врёт, мы писали в статье про автоматические отчёты. Если нужна гибкая выгрузка с группировками, пригодится Мастер отчётов Директа: он работает прямо в кабинете, а бот получает те же данные через сервис Reports в API и присылает цифры или ссылку на отчёт в кабинете.

Две ловушки, из-за которых отчёт в мессенджере вводит в заблуждение. Во-первых, свежие данные неполные: статистика в Директе обновляется с задержкой в несколько часов, поэтому «расход за сегодня» в десять утра - это не итог дня. Во-вторых, конверсии по долгим сделкам приходят позже, и цена заявки за вчера со временем меняется. Решения по площадкам и запросам лучше принимать по данным за дни и недели, а утреннюю сводку считать сигналом, а не приговором.

Тревоги: когда бот должен написать

Хорошая тревога короткая, редкая и говорит, что делать. Плохая - пишет по десять раз в день, и через неделю вы выключаете звук. Поэтому лучше начать с малого набора.

Тревоги про деньги

• Мало денег на счёте. Если деньги закончатся, показы встанут. Порог выбираете сами: например, остаток меньше расхода за два-три дня. Учтите, что у представителя с доступом «Только чтение» нет доступа к балансу и оплате: проверьте заранее, получит ли бот остаток, или оставьте эту тревогу встроенным уведомлениям Директа (письмо об остатке и SMS о том, что деньги закончились).
• Расход заметно выше обычного. Бот сравнивает текущий расход со средним за прошлые недели. Важно помнить, что в Директе бюджеты недельные, поэтому сравнивать нужно с похожими днями и по неделе, а не искать «дневной лимит».
• Расход есть, заявок нет. Самый полезный сигнал, но и самый шумный: конверсии приходят с задержкой, поэтому ждать стоит сутки-двое, а не часы.

Тревоги про показы и сайт

• Показы резко упали. Причин много: отклонили объявления на модерации, закончились деньги, изменили стратегию, сезонный провал. Бот лишь показывает факт, причину ищет человек или агент.
• Объявления отклонены модерацией. Модерация обычно занимает несколько часов, но отказ без реакции стоит вам показов.
• Сайт не открывается. Для этого у Директа есть встроенный мониторинг: если главная страница недоступна дольше 15 минут, показы приостанавливаются, а после восстановления возобновляются, и приходит сообщение на почту или в SMS. В кампаниях Мастера он включён всегда, в остальных его включают в настройках кампании. Проверяется только главная страница, заглушку хостинга мониторинг не заметит. Поэтому собственному боту полезнее следить за посадочными страницами и работой формы заявки.

Один принцип для всех тревог: в сообщении должно быть и число, и контекст. «Расход 4 200 ₽, обычно 2 500 ₽ за этот день недели, кампания такая-то» полезнее, чем «Внимание, расход!».

Остановка кампании из Telegram

Это главный повод для споров. С одной стороны, остановить рекламу с телефона в субботу вечером - удобно. С другой - любая команда, которую можно дать боту, может уйти не туда: случайное нажатие, чужой человек в чате, ошибка в названии кампании.

Практика, которую мы считаем разумным минимумом:

• бот не выполняет остановку сразу, а переспрашивает с названием кампании и кнопками «Да» и «Нет»;
• команды принимаются только от вашего аккаунта в Telegram, чужим бот не отвечает;
• каждое действие записывается в журнал с датой и именем кампании;
• остановку любят использовать как «красную кнопку», но не как способ регулярно управлять расходом.

Про остановки и автостратегии. Короткая пауза сама стратегию не перезапускает, а вот простой больше 7 дней перезапускает её, и после 28 дней статистика сбрасывается. Частая смена настроек мешает прогнозу. Главный риск в другом: смена недельного бюджета посреди недели перезапускает траты, и в этот день может уйти до 35% старого и до 35% нового бюджета. Менять бюджет лучше в начале недели. Если вам кажется, что стратегия тратит не туда, сначала посмотрите на причины, например в разборе автостратегий Директа, а остановку оставьте на случай настоящей аварии.

Это не теория. У нас в агентстве есть внутренний бот для работы с кабинетами клиентов: он отвечает на вопросы о расходе и кампаниях, а стоп и старт кампании, смену недельного бюджета (мы стараемся делать это в начале недели) и добавление минус-слов в поисковую кампанию выполняет только после нажатия «Да», с записью в журнал клиента. Включать кампании «просто так» и менять ставки, цели и тексты он не умеет: это делается в отдельном рабочем процессе.

Безопасность: что нужно знать про доступ

Любой бот или сервис, который ходит в API, получает токен. Это ключ, который внутри Директа даёт те же действия, что и аккаунт, на который он выдан. Логин, пароль и почту сервис при этом не видит. Что стоит сделать до подключения:

• Ограничить права. Для представителя в Директе можно выбрать уровень «Только чтение» или «Полный доступ». Если вам нужны только отчёты и тревоги, достаточно чтения: даже при утечке ключа никто не остановит и не изменит рекламу. Оговорка: у такого доступа нет баланса и оплаты, поэтому остаток на счёте бот может не увидеть.
• Хранить токен как пароль. Не вставлять его в чат, не отправлять в мессенджере подрядчику, не оставлять в открытой таблице.
• Ограничить круг получателей. Бот должен отвечать только вам и тем, кого вы назвали. Цифры расхода клиента не стоит слать в большой общий чат.
• Помнить про то, что Telegram - облачный. Обычная переписка с ботом не защищена сквозным шифрованием как секретные чаты. Для расходов и остатка это обычно приемлемо, а для договоров и паролей нет.
• Знать, как отключить. Доступ можно отозвать в настройках Яндекса. Кампании при этом останутся с теми настройками, которые успели выставиться, в том числе и от самого бота.

Отдельный риск - конфликт с автоприменением рекомендаций. Оно есть только в ЕПК, Мастере кампаний и товарных кампаниях. По умолчанию Яндекс сам меняет базовые настройки: заголовки, тексты, изображения, быстрые ссылки, время показа, тематические слова и счётчик Метрики, а корректировок не трогает. В расширенном режиме добавляются цели, таргетинги и недельный бюджет, который может расти до 4% в неделю. Если параллельно бот или агент делает то же самое, получится спор двух автоматов. Заранее решите, кто за что отвечает.

Как выбрать готового бота

Перед тем как давать доступ, задайте разработчику или службе поддержки несколько вопросов. Хороший ответ на каждый можно получить за пару минут.

1. Какой доступ нужен? Если бот только присылает отчёты, ему не нужен полный доступ. Просьба выдать «всё на всякий случай» - повод задуматься.
2. Где хранится токен и кто его видит? Ответ «на нашем сервере, доступ только у такого-то специалиста» лучше, чем молчание.
3. Какие тревоги и по каким порогам? Должна быть возможность менять пороги и отключать лишнее.
4. Как подтверждаются команды? Остановка без переспроса - плохой знак.
5. Есть ли журнал действий? Через месяц вы должны суметь узнать, кто и когда останавливал кампанию.
6. Что будет, если сервис закроется? Кампании останутся с последними настройками, и надо знать, что именно в них менялось.
7. Сколько стоит и за что? Плата за подписку отличается от процента с рекламного бюджета: проценту нужен отдельный разговор.

Если бота продают вместе с услугой по ведению рекламы, посмотрите, что сделано внутри самого кабинета, а не только в Telegram: красивая переписка не заменяет хорошей настройки.

Как сделать бота самому

Есть два пути. Первый - конструкторы без программирования. Они хороши для чат-ботов, которые отвечают клиентам, например про цены и запись; мы разбирали такие в статье про Telegram-бота без программиста. Для связки с Директом конструктора обычно мало: нужны запросы к API, хранение токена, расписание и логика сравнения цифр.

Второй путь - небольшая программа. Что понадобится: регистрация приложения и доступ к API Директа, бот в Telegram, сервер, который работает круглосуточно, расписание запросов и место для хранения токена. Для разработчика это задача на несколько дней, но дальше начинается обслуживание: следить за работой, обновлять токен, менять пороги, чинить после обновлений API. Есть и ограничения API: суточный лимит баллов, не более 5 одновременных запросов, а для отчётов до 20 запросов за 10 секунд, так что опрашивать кабинет каждую минуту не получится. Остаток на счёте в API версии 5 не отдаётся, он есть в Live 4 (сервис AccountManagement, поле Amount), и это стоит учесть при выборе схемы.

Если у вас нет программиста, самостоятельная разработка редко окупается: проще взять готовое решение или попросить агентство. Если программист есть, начните с чтения: отчёт и одна тревога про остаток. Команды управления добавляйте последними.

Как это устроено в нашей подписке

В нашем ИИ-агенте для Директа Telegram - канал, через который агент выходит на связь. Тариф «Старт» за 4 900 ₽ в месяц присылает отчёт раз в неделю. «Про» за 9 900 ₽ в месяц добавляет ежедневный отчёт, тревоги в Telegram и тесты объявлений. «Бизнес» обсуждается индивидуально. Процент от рекламного бюджета мы не берём.

Разница с «просто ботом» в том, что агент не ограничивается сообщением. Он смотрит запросы, площадки и объявления, а в отчёте пишет, что нашёл и что сделал. При этом права вы ограничиваете сами, а токен и пароль от кабинета мы не видим. Подробности и тарифы на странице ИИ-директолога ADVantage.

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

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

Есть ли официальный Telegram-бот Яндекс Директа?

У Директа есть официальный Telegram-бот поддержки @YandexDirectSupportBot, но он нужен для обращений, а не для управления кабинетом. Есть и официальное мобильное приложение Директа: в нём приходят пуш-уведомления, можно остановить и возобновить показы, смотреть статистику и бюджет, пополнять счёт. Это хорошая альтернатива боту. Боты с отчётами и тревогами делают сторонние сервисы и разработчики.

Платный ли API Директа?

По справке Директа, подключение к API и его использование бесплатные. Платить придётся за сервер, разработку или сервис, который эту работу делает.

Можно ли пополнять счёт из бота?

Мы не рекомендуем: платёжные действия лучше выполнять в кабинете, где видны все реквизиты. Бот пусть напоминает про остаток, а оплата остаётся за вами.

Подойдёт ли бот для Instagram Direct?

Нет, это разные вещи. Бот для личных сообщений в Instagram отвечает подписчикам, а бот для Яндекс Директа работает с рекламным кабинетом. Вокруг слова «бот директ» эти два смысла часто смешиваются.

Может ли бот заменить директолога?

Бот присылает цифры и выполняет простые команды, а анализ, гипотезы и стратегия остаются за человеком или за ИИ-агентом с ограничениями. Обычно бот дополняет специалиста: избавляет от ручных проверок и показывает проблему сразу.

Итог

Telegram-бот для Директа полезен, когда делает простые вещи надёжно: присылает короткий отчёт, пишет о настоящих проблемах и останавливает кампанию только после вашего подтверждения. Начинайте с доступа «Только чтение», добавляйте тревоги по одной, а команды управления включайте в последнюю очередь. Когда рутины становится много и нужен не только сигнал, но и разбор причин, на смену боту приходит ИИ-агент.

Если хотите посмотреть, как выглядят ежедневные отчёты и тревоги в Telegram на практике, начните со страницы ИИ-директолога ADVantage: тариф «Про» включает и то и другое, а оценить свой случай можно без обязательств.