Боты

Telegram-боты — это то, через что AlterCPA TOP приветствует подписчиков и следит за вашими чатами. Подключите бота один раз, затем используйте его в любом количестве кампаний.

Страница ботов — подключённые боты со значками статуса и полем для токена

Шаг 1 — создайте бота в BotFather

Откройте @BotFather в Telegram.
Отправьте /newbot.
BotFather попросит имя для отображения, затем имя пользователя (должно заканчиваться на bot).
Скопируйте API-токен из подтверждающего сообщения BotFather — он выглядит как 7123456789:AAH_abc123....

Храните токен в тайне. Любой, у кого он есть, может отправлять сообщения от имени вашего бота.

Шаг 2 — добавьте бота в AlterCPA TOP

Перейдите в раздел Боты в кабинете и нажмите Добавить бота.
Вставьте токен и подтвердите.

Мы вызываем getMe для проверки токена, затем автоматически регистрируем вебхук — Telegram начнёт передавать нам обновления. Если токен неверный, вы увидите ошибку token. Если другой аккаунт AlterCPA TOP уже использует этого бота, вы увидите exists.

Шаг 3 — сделайте бота администратором чата

Бот должен быть администратором каждого канала или группы, которую вы хотите отслеживать. Telegram отправляет события вступления/выхода только ботам, являющимся администраторами — без прав администратора чат просто не появится в выборе кампании, и вступления не будут отслеживаться.

В вашем канале/группе: Администраторы → Добавить администратора → найдите бота по имени пользователя → подтвердите с правами по умолчанию.

Почему чат не появляется сразу?
У Telegram нет API «список моих чатов». Мы узнаём о чате в момент добавления бота или повышения его до администратора (через событие my_chat_member). После повышения бота вернитесь в редактор кампании — чат должен появиться в течение нескольких секунд.

Статусы ботов

Статус	Значение
✅ Активен	Бот подключён, все его отслеживаемые чаты в порядке.
⚠️ Предупреждение	Бот потерял права администратора в одном или нескольких чатах. Затронутые кампании приостановлены, вы получите уведомление в сервисном боте. Повысьте бота снова, чтобы восстановить работу.
Отключён	Бот удалён из вашего аккаунта (мягкое удаление). История сохраняется; бота можно добавить снова.

Восстановление отключённого бота

Повторное добавление того же токена реактивирует исходную запись бота — дубликат не создаётся, история сохраняется.

Отключение бота

Нажмите Отключить на карточке бота. Вебхук снимается, бот мягко удаляется. Все кампании, использующие его, приостанавливаются, но не удаляются; лиды и статистика остаются нетронутыми.

Передать вместо отключения? Если вы хотите передать бота (и его кампании) другому аккаунту, используйте страницу Передача.

Частые ошибки

Ошибка	Причина	Решение
`token`	Токен недействителен или отозван.	Перепроверьте в BotFather; при необходимости перегенерируйте.
`exists`	Другой аккаунт уже подключил этого бота.	Попросите владельца отключить его, или используйте другого бота.
`webhook`	Не удалось зарегистрировать вебхук (Telegram недоступен).	Подождите минуту и повторите попытку.

Обзор кабинета Кампании