Создание Telegram-бота

Это руководство проведёт вас через создание Telegram-бота с помощью BotFather. Занимает около 2 минут.

Шаг 1: Откройте BotFather

1. Откройте Telegram (приложение или веб-версию)
2. Найдите @BotFather
3. Начните чат с BotFather

Важно: Убедитесь, что вы общаетесь с официальным @BotFather (с синей галочкой верификации).

Шаг 2: Создайте нового бота

1. Отправьте команду /newbot
2. BotFather попросит вас ввести имя для бота
3. Введите понятное имя, например “My Channel Tracker”

Шаг 3: Выберите имя пользователя

1. BotFather попросит ввести имя пользователя
2. Оно должно заканчиваться на “bot” (например, mychanneltracker_bot)
3. Должно быть уникальным в Telegram

Советы по выбору имени пользователя:

• Делайте его коротким и запоминающимся
• Используйте название вашего бренда + суффикс _bot
• Примеры: brandname_bot, mychannel_tracker_bot

Шаг 4: Скопируйте токен бота

После создания BotFather отправит вам сообщение с токеном бота. Он выглядит так:

1234567890:ABCdefGHIjklMNOpqrsTUVwxyz123456789

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

Шаг 5: Добавьте токен в AdTarget

1. Перейдите в панель управления AdTarget 
2. Откройте сайт, который хотите отслеживать
3. Перейдите в Settings и выберите вкладку Bots
4. Нажмите Add bot
5. Вставьте токен бота в поле ввода

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

Настройки бота (Необязательно)

Вы можете настроить бота через BotFather:

Установите фото профиля

1. Отправьте /setuserpic в BotFather
2. Выберите вашего бота
3. Загрузите изображение (желательно логотип вашего бренда)

Установите описание

1. Отправьте /setdescription в BotFather
2. Выберите вашего бота
3. Введите описание, которое пользователи увидят при запуске бота

О режиме конфиденциальности

Вам не нужно изменять режим конфиденциальности бота. AdTarget настраивает webhook для прослушивания событий chat_member и my_chat_member, которые Telegram доставляет независимо от настройки конфиденциальности. Настройка конфиденциальности контролирует только то, получает ли бот обычные текстовые сообщения в группах — она не влияет на отслеживание вступлений в каналы.

Лучшие практики безопасности

Защитите ваш токен:

• Никогда не публикуйте токен бота в открытом доступе
• Не сохраняйте его в системах контроля версий
• Перегенерируйте токен, если он был скомпрометирован

Для перегенерации токена:

1. Отправьте /revoke в BotFather
2. Выберите вашего бота
3. BotFather сгенерирует новый токен
4. Удалите старого бота в AdTarget и добавьте новый токен через Settings -> Bots -> Add bot

Устранение неполадок

BotFather не отвечает?

• Убедитесь, что вы пишете верифицированному @BotFather
• Попробуйте закрыть и снова открыть чат
• Проверьте подключение к интернету

Имя пользователя уже занято?

• Попробуйте более уникальный вариант
• Добавьте цифры или подчёркивания
• Используйте полное название бренда

Токен не работает в AdTarget?

• “This bot is already connected to another account” — Токены ботов эксклюзивны для каждого аккаунта AdTarget. Если вы ранее использовали этот токен в другом аккаунте, сначала удалите его там.
• “Maximum bots reached” — Каждый аккаунт AdTarget может иметь до 20 ботов. Удалите неиспользуемого бота перед добавлением нового.
• Нет реакции при вставке токена — Убедитесь, что скопировали полный токен, включая цифры перед двоеточием (например, 1234567890:ABC...), без лишних пробелов. Автоматическая валидация срабатывает только при соответствии формата.
• Если токен валиден, но всё равно не работает, попробуйте перегенерировать его командой /revoke в BotFather и вставьте новый.

Следующие шаги

Теперь, когда бот создан, подключите его к вашему Telegram-каналу.