Как сделать бота в Telegram: от BotFather до первого ответа

1. Что такое Telegram-бот и зачем он нужен

Telegram-бот — это приложение, работающее внутри мессенджера. Пользователь пишет ему сообщение, нажимает кнопку или выбирает команду, а ваша логика формирует ответ. Для бизнеса бот может отвечать на частые вопросы, собрать имя и телефон, принять заявку, записать клиента на услугу или передать диалог сотруднику.

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

2. Определите первую задачу

До регистрации выберите одну первую задачу. Хороший стартовый сценарий выглядит так: пользователь пишет боту → бот задаёт несколько уточняющих вопросов → проверяет обязательные данные → показывает итог → отправляет заявку сотруднику или сохраняет её в согласованной системе.

Примеры:

• ответы на пять–десять часто задаваемых вопросов;
• приём заявки с именем, контактом и описанием задачи;
• запись на консультацию с последующей передачей менеджеру;
• уведомление о статусе заказа, если источник статуса уже доступен.

Не начинайте с формулировки «бот для всего». Запишите вход, обязательные поля, ожидаемый результат и случаи, когда нужен оператор. Это позволит проверить не только наличие ответа, но и пользу сценария.

3. Создайте бота через BotFather и защитите токен

1. Откройте в Telegram официальный аккаунт @BotFather.
2. Запустите диалог и выберите создание нового бота.
3. Следуйте подсказкам: задайте отображаемое имя и username. Username используется для поиска и ссылки на чат; Telegram указывает, что обычно в нём используется суффикс bot.
4. После завершения регистрации BotFather выдаст токен.
5. Сразу сохраните токен в защищённом хранилище: например, в переменной окружения или менеджере секретов.
6. Не вставляйте токен в публичный репозиторий, скриншот, общий чат или клиентский JavaScript.
7. Если токен стал известен постороннему, перевыпустите его через управление ботом в BotFather и обновите настройку приложения.

Токен фактически даёт контроль над ботом. Перед передачей разработчику или подрядчику ограничьте круг людей, имеющих к нему доступ, и договоритесь, где он хранится.

4. Настройте профиль, команды и первый сценарий

После регистрации настройте базовую информацию бота в BotFather: имя, описание, аватар и список основных команд. Для первого сценария достаточно начать с /start и /help; при необходимости добавьте /settings.

Пример минимального меню:

• /start — приветствие и объяснение, что умеет бот;
• /help — краткая инструкция;
• «Задать вопрос» — переход к свободному сообщению;
• «Оставить заявку» — сбор обязательных данных;
• «Связаться с сотрудником» — передача оператору.

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

5. Выберите способ запуска: код или конструктор

Есть два основных пути.

Код. Подходит, если нужны собственные правила, интеграция с CRM, база данных, обработка ошибок и полный контроль над токеном. Приложение получает сообщения через Telegram Bot API, обрабатывает их и отправляет ответы. Для первого прототипа реализуйте только /start, один вопрос и ответ на обычное сообщение. Затем добавьте проверку обязательных полей и передачу оператору.

Конструктор. Подходит для простого меню, FAQ, анкеты или заявки без сложной логики. Перед выбором проверьте, где хранится токен, можно ли выгрузить сценарий, как передаются заявки, какие права нужны и что происходит при сбое. Конкретные функции, тарифы и ограничения конструктора нужно проверять в документации выбранного сервиса.

Если вы не уверены, начните с прототипа без записи в рабочие системы. Сначала убедитесь, что пользователь проходит сценарий и получает ожидаемый ответ.

6. Проверьте ответы бота

Минимальная проверка состоит из нескольких шагов:

1. Откройте чат с ботом и нажмите Start или отправьте /start.
2. Убедитесь, что бот показывает понятное приветствие и объясняет следующий шаг.
3. Отправьте обычный вопрос и проверьте, что ответ соответствует сценарию.
4. Отправьте неполное сообщение: бот должен запросить недостающие данные, а не создать пустую заявку.
5. Введите неожиданный или неподдерживаемый запрос: бот должен объяснить ограничение или предложить оператора.
6. Повторите заявку и проверьте, не создаётся ли неконтролируемый дубль.
7. Если есть интеграция, проверьте запись, уведомление сотруднику и сохранение исходного контекста.

Зафиксируйте результат в таблице: входное сообщение, ожидаемый ответ, фактический ответ, созданная запись и необходимость участия человека.

7. Права, ограничения и безопасность

Перед подключением к бизнес-процессу учтите ограничения Telegram-ботов:

• бот не может первым начать личный разговор: пользователь должен открыть чат и отправить сообщение либо добавить бота в группу;
• в группе бот по умолчанию видит не все сообщения — на поведение влияет режим приватности и права;
• полученные команды нужно проверять на допустимость и авторизацию, даже если они не добавлены в меню;
• токен нельзя считать обычным паролем для пересылки в переписке;
• наличие Bot API не означает, что CRM, склад, почта или учётная система уже подключены;
• для финансовых, юридически значимых и чувствительных операций оставьте подтверждение сотрудника.

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

8. Как подготовить бота к бизнес-сценарию

Когда базовый сценарий стабильно проходит тесты, опишите будущую связку до её настройки:

• какое событие запускает передачу заявки;
• какие поля отправляются в CRM или таблицу;
• кто получает уведомление;
• что происходит при повторной отправке;
• какие ошибки видит пользователь, а какие разбирает сотрудник;
• какие действия бот может выполнить сам, а какие требуют подтверждения.

Paramiko предлагает начинать с одного процесса: согласовать входные данные и ожидаемый результат, определить доступы и участие человека, затем проверить ограниченный пилот на примерах заказчика. Это предложение подхода, а не утверждение о готовой интеграции, выполненном кейсе, сроках, цене или гарантированном результате.