Перейти к основному содержимому

Управление ботами: Полное руководство

Все, что нужно знать о создании и управлении Telegram-ботами в Novum

← Главная

Содержание​

Основы работы с ботами​

Что такое бот в Novum?​

Telegram-бот в платформе Novum - это:

  • Автоматизированный аккаунт в Telegram
  • Центральный элемент для воронок продаж и автоматизации
  • Инструмент для взаимодействия с клиентами
  • Канал для аналитики и отслеживания конверсий

Типы ботов​

Novum поддерживает два типа ботов:

ТипОписаниеИспользование
Обычный ботСоздается через @BotFatherСтандартные воронки, рассылки, автоматизация
User BotЛичный аккаунт пользователяРасширенные возможности, AI-интеграция

📌 В этом руководстве мы рассматриваем обычные боты. User Bots описаны в AI Features.

Создание бота​

Предварительные требования​

Перед созданием бота в Novum вам нужно:

  1. ✅ Иметь аккаунт в Telegram
  2. ✅ Создать проект в Novum
  3. ✅ Получить токен от @BotFather

Шаг 1: Получение токена​

В Telegram:​

  1. Откройте @BotFather
  2. Отправьте команду: /newbot
  3. Введите отображаемое имя (например: "Мой Магазин")
  4. Введите username (должен заканчиваться на bot, например: my_shop_bot)
  5. BotFather пришлет токен в формате: 
    123456789:ABCdefGHIjklMNOpqrsTUVwxyz-1234567890
  6. Скопируйте токен полностью

⚠️ Безопасность: Храните токен в секрете! Любой, у кого есть токен, может управлять вашим ботом.

Шаг 2: Добавление в Novum​

Путь навигации:​

Проект → Боты → Создать бота

Заполнение формы:​

ПолеОписаниеПример
ТокенТокен от BotFather123456:ABC...
НазваниеВнутреннее имя в системе"Бот интернет-магазина"
Auto-approve chat join requestsАвтоматически одобрять запросыВкл/Выкл

Опции создания:​

Auto-approve chat join requests - Автоматическое одобрение запросов на вступление

  • ✅ Включить, если:

    • Бот используется для открытого сообщества
    • Вы хотите максимальную автоматизацию
    • Нет необходимости в модерации пользователей

  • ❌ Выключить, если:

    • Бот для закрытого сообщества
    • Требуется ручная модерация
    • Важен контроль доступа

Шаг 3: Сохранение и запуск​

  1. Нажмите "Сохранить"
  2. Бот появится в списке
  3. Статус должен автоматически стать "Started"
  4. Если статус "Stopped", нажмите кнопку запуска

Настройки бота​

Основные настройки​

Путь:​

Боты → Выбрать бота → Настройки

Доступные параметры​

1. Общая информация​

  • Название бота - Имя в системе (можно изменить)
  • Токен - Можно обновить при необходимости
  • Username - Отображается из Telegram (только для чтения)

2. Параметры поведения​

  • Auto-approve chat join requests - Автоматическое одобрение
  • Другие настройки (зависят от версии)

3. Связанные сущности​

  • Количество воронок
  • Количество цепочек
  • Количество пользователей

Управление статусами​

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

СтатусЗначокОписаниеДействия
Started🟢Бот запущен и работаетМожно остановить
Stopped🔴Бот остановленНужно запустить
ActionRequired🟡Требуется действиеПроверить настройки
PollingConflict⚠️Конфликт подключенияОстановить другие экземпляры

Управление статусом​

Запуск бота​

Боты → Выбрать бота → Нажать "Start"
  • Бот начнет отвечать на сообщения
  • Воронки станут активны
  • Пользователи смогут взаимодействовать

Остановка бота​

Боты → Выбрать бота → Нажать "Stop"
  • Бот перестанет отвечать
  • Воронки приостановятся
  • Существующие пользователи сохранятся

Особые статусы​

PollingConflict (Конфликт подключения)​

Что это значит:

  • Бот уже запущен в другом месте
  • Telegram API разрешает только одно активное подключение

Как исправить:

  1. Найдите, где еще запущен бот:
    • Другая платформа
    • Локальный сервер
    • Другой аккаунт Novum
  2. Остановите другой экземпляр
  3. Novum автоматически попытается переподключиться
  4. Статус изменится на "Started"

Автоматический retry:

  • Система автоматически пытается переподключиться каждые N секунд
  • Как только конфликт разрешится, бот запустится

ActionRequired (Требуется действие)​

Возможные причины:

  • Токен стал недействительным
  • BotFather отозвал доступ
  • Проблемы с Telegram API

Как исправить:

  1. Проверьте токен в настройках
  2. Создайте нового бота у BotFather (если старый удален)
  3. Обновите токен в Novum
  4. Перезапустите бота

Просмотр пользователей бота​

Раздел Bot Users​

Путь:​

Боты → Выбрать бота → Bot Users

Что вы увидите​

Список всех пользователей, которые:

  • Написали боту хотя бы раз
  • Прошли через воронку
  • Взаимодействовали с кнопками

Информация о пользователе​

ПолеОписание
Username@username в Telegram
First NameИмя пользователя
Last NameФамилия
User IDTelegram ID
Дата первого взаимодействияКогда пользователь первый раз написал
Последняя активностьВремя последнего сообщения

Фильтрация и поиск​

  • Поиск по username
  • Поиск по имени
  • Сортировка по дате
  • Фильтр по активности

Взаимодействие с пользователями​

Личные сообщения​

Путь:​

Боты → Bot Users → Выбрать пользователя → Chat

Возможности​

1. Просмотр истории​

  • Все сообщения пользователя
  • Ответы бота
  • Нажатия на кнопки
  • Прохождение по воронкам

2. Отправка сообщений​

  • Написать пользователю напрямую
  • Отправить медиа (фото, видео, документы)
  • Использовать шаблоны сообщений

3. Теги и заметки​

  • Добавить теги к пользователю
  • Оставить внутренние заметки
  • Отметить как VIP или проблемного

Практические сценарии​

Сценарий 1: Поддержка клиента​

Пользователь → Написал вопрос
        ↓
Bot Users → Найти пользователя
        ↓
Chat → Ответить лично
        ↓
Решить проблему

Сценарий 2: Персональное предложение​

Аналитика → Определить активных пользователей
        ↓
Bot Users → Выбрать пользователя
        ↓
Chat → Отправить спецпредложение
        ↓
Отслеживать реакцию

Копирование бота​

Зачем копировать бота?​

  • 🔄 Создать тестовую версию
  • 🌍 Запустить бота для другой страны/языка
  • 📊 A/B тестирование разных воронок
  • 🚀 Быстро развернуть похожий проект

Как скопировать​

Путь:​

Боты → Выбрать бота → Действия → Копировать

Что копируется?​

ЭлементКопируется?
Настройки бота✅ Да
Воронки продаж✅ Да
Посты в воронках✅ Да
Кнопки✅ Да
Цепочки постов✅ Да
Шаблоны✅ Да
Токен❌ Нет (нужен новый)
Пользователи❌ Нет
История сообщений❌ Нет
Статистика❌ Нет

Процесс копирования​

  1. Выберите бота для копирования
  2. Нажмите "Копировать"
  3. Введите новое название
  4. Получите новый токен от BotFather для копии
  5. Вставьте новый токен
  6. Сохраните
  7. Запустите бота

💡 Совет: После копирования проверьте все воронки и обновите тексты, если нужна локализация.

Удаление бота​

Предупреждение​

⚠️ ВНИМАНИЕ: Удаление бота является необратимым действием!

Что будет удалено?​

При удалении бота удаляются:

  • ❌ Все воронки продаж
  • ❌ Все цепочки постов
  • ❌ Вся статистика
  • ❌ История взаимодействий с пользователями
  • ❌ Настройки Event Bindings
  • ❌ Связь с каналами (если есть)

Что НЕ удаляется?​

  • ✅ Сам бот в Telegram (остается у BotFather)
  • ✅ Чаты с пользователями в Telegram
  • ✅ Участники проекта
  • ✅ Шаблоны (если сохранены как Global/Personal)

Процесс удаления​

Путь:​

Боты → Выбрать бота → Действия → Удалить

Шаги:​

  1. Нажмите "Удалить"
  2. Подтвердите действие в модальном окне
  3. Введите название бота для подтверждения (если требуется)
  4. Нажмите "Да, удалить"
  5. Автоматический редирект на список ботов

После удаления​

Что делать с ботом в Telegram:

  1. Откройте @BotFather
  2. Отправьте /mybots
  3. Выберите удаленного бота
  4. Либо удалите его через "Delete Bot"
  5. Либо сохраните для использования в будущем

Решение проблем​

Проблема 1: Бот не отвечает​

Симптомы:

  • Пользователь пишет боту
  • Бот не отвечает
  • Нет реакции на команды

Решения:

  1. Проверьте статус:

    Боты → Проверить статус
    • Должен быть "Started"
    • Если "Stopped" → Запустите

  2. Проверьте токен:

    • Настройки → Токен
    • Проверьте, что токен полный
    • Попробуйте обновить токен

  3. Проверьте воронки:

    • Есть ли активные воронки?
    • Настроен ли Root Post?
    • Статус воронки "Enabled"?

  4. Проверьте лог ошибок:

    • Посмотрите в раздел с ошибками
    • Возможно, есть проблемы с API

Проблема 2: PollingConflict​

Симптомы:

  • Статус бота "PollingConflict"
  • Бот не работает
  • Постоянные попытки переподключения

Решения:

  1. Найдите конфликтующий экземпляр:

    • Проверьте другие платформы (n8n, Make, Zapier)
    • Проверьте локальные скрипты
    • Проверьте другие аккаунты Novum

  2. Остановите конфликт:

    • Остановите все другие экземпляры бота
    • Дождитесь автоматического retry (1-2 минуты)

  3. Если не помогает:

    • Пересоздайте токен у BotFather: 
      /mybots → Выбрать бота → API Token → Revoke current token
    • Обновите токен в Novum
    • Перезапустите бота

Проблема 3: Дублирование ботов​

Симптомы:

  • При создании появилось несколько копий
  • Одинаковые боты с одним токеном

Причина:

  • Быстрое многократное нажатие "Сохранить"

Решение:

  • Удалите дублирующих ботов
  • Оставьте только один
  • При создании дождитесь завершения (кнопка должна заблокироваться)

Профилактика:

  • Система добавила защиту от дублирования
  • Кнопка "Сохранить" блокируется после нажатия
  • Показывается индикатор загрузки

Проблема 4: Пользователи не появляются в Bot Users​

Симптомы:

  • Пользователь пишет боту
  • Он не отображается в списке

Решения:

  1. Обновите страницу:

    • Возможна задержка синхронизации

  2. Проверьте фильтры:

    • Возможно, активны фильтры
    • Сбросьте все фильтры

  3. Проверьте статус бота:

    • Если бот был Stopped, взаимодействия не сохранялись

Лучшие практики​

Именование ботов​

✅ Хорошие имена:

  • "Магазин одежды - Основной"
  • "Support Bot - RU"
  • "Промо-бот Акция 2026"

❌ Плохие имена:

  • "Bot 1"
  • "Test"
  • "asdfgh"

Организация​

Для нескольких ботов:

  1. Используйте префиксы:

    • [PROD] - Боты в продакшене
    • [TEST] - Тестовые боты
    • [DEV] - Разработка

  2. Добавляйте описания:

    • Цель бота
    • Целевая аудитория
    • Ответственный

Безопасность​

  1. Никогда не делитесь токенами
  2. Регулярно ротируйте токены (раз в 6-12 месяцев)
  3. Используйте разные боты для прода и теста
  4. Ограничьте доступ к боту для членов команды

Мониторинг​

Регулярно проверяйте:

  • ✅ Статус ботов (все ли Started?)
  • ✅ Количество пользователей (растет ли?)
  • ✅ Ошибки в логах
  • ✅ Конверсии в воронках

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

Теперь, когда вы освоили управление ботами:

  1. Создайте воронку продаж - Автоматизируйте продажи
  2. Настройте цепочки постов - Автоматические последовательности
  3. Подключите каналы - Управляйте контентом

Полезные ссылки​