Блог / Telegram

Telegram

Как подключить Telegram-бота: пошаговая инструкция через @BotFather

Сергей Полухин · CTO и сооснователь PapAI · 25 мая 2026

Чтобы получить своего Telegram-бота, нужен один обязательный шаг — создать его через официального @BotFather и получить токен. Дальше с этим токеном можно делать что угодно: писать код самому или подключить к готовому сервису, который сразу начнёт отвечать. Разберём оба пути по порядку.

Карточка подключённого Telegram-бота в личном кабинете PapAI Constructor

Способ 1. Вручную через @BotFather

Это стандартный путь для любого Telegram-бота, независимо от того, на чём он потом будет работать.

  1. Откройте Telegram и найдите @BotFather — официального бота Telegram для управления ботами (у него синяя галочка подтверждённого аккаунта). Нажмите «Start».Диалог с @BotFather в Telegram: приветственное сообщение и кнопка Start
  2. Отправьте команду /newbot. @BotFather спросит отображаемое имя бота (можно кириллицей, потом можно сменить) и username — техническое имя, обязательно заканчивающееся на «bot», например my_shop_bot.Диалог с @BotFather: команда /newbot, запрос имени бота и username, оканчивающегося на bot
  3. @BotFather пришлёт токен — длинную строку вида 123456789:AAH.... Это единственный ключ доступа к боту: у кого токен, тот им и управляет.Диалог с @BotFather: полученный токен доступа к Telegram Bot API
Токен — это пароль от бота, а не просто идентификатор. Никогда не публикуйте его, не коммитьте в открытый репозиторий и не пересылайте в незашифрованном виде. Если токен всё же утёк — в @BotFather есть команда /revoke, которая сразу выпускает новый токен взамен старого.

Дальше токен сам по себе ничего не делает — боту нужен код или сервис, который читает входящие сообщения и отвечает на них через Telegram Bot API. Это и есть основная работа: логика ответов, сервер, который должен быть постоянно поднят, обработка ошибок и обновлений API. Для простого FAQ-бота это можно написать за вечер; для бота, который должен понимать свободный текст и вести диалог, — куда больше.

Способ 2. Без ручной настройки токена и сервера

Если нужен не «свой код, который дёргает Telegram API», а готовый бот, который уже отвечает клиентам, — вторую половину способа 1 (сервер, обработка API, логика ответов) можно пропустить целиком. При создании бота в конструкторе указывается только имя и то, что бот должен делать словами («отвечаю на вопросы по прайсу», «записываю на консультацию») — Telegram подключается автоматически и мгновенно, без отдельного похода к @BotFather.

Технически: как только вы первый раз сохраняете описание для нового бота, конструктор создаёт для него реальную «компанию» на движке (robot-core) и для Telegram-канала сам обращается к @BotFather, получает токен и регистрирует его в шлюзе, который принимает сообщения. С этого момента бот получает username в Telegram и отвечает по Kafka-шине на движке — в течение той же операции, а не позже.

После сохранения описания у Telegram-коннектора появляется статус «активен» и username — он показан в карточке бота. Откройте Telegram, найдите бота по этому username и напишите первое сообщение. Если бот не ответил за несколько секунд — проверьте статус коннектора: «ошибка» значит, что провизионирование можно повторить повторным сохранением описания, либо стоит написать в поддержку с именем бота.

Username бота конструктор генерирует сам — обычно часть названия бота плюс случайный суффикс, и заканчивается на «bot», как того требует Telegram. Красивое короткое имя нужно будет менять вручную через @BotFather отдельно, если оно важно для вас.

Как забрать бота себе (если создавали через конструктор)

Изначально такой бот в BotFather принадлежит служебному аккаунту конструктора — это нормально и не влияет на его работу: токен, которым пользуется шлюз, при передаче владения не меняется и не отзывается. Но если важно самостоятельно управлять ботом в @BotFather (менять аватар, описание, команды), в конструкторе есть отдельное действие — «передать владение» с указанием вашего Telegram-логина.

  • Перед передачей нужно самому написать боту хотя бы одно сообщение — Telegram требует этого для смены владельца и не даёт обойти это правило.
  • Если на служебном аккаунте не настроен пароль двухфакторной аутентификации, передача вернёт ошибку «не настроено» — в этом случае нужно написать в поддержку, это разовая техническая настройка на нашей стороне.

Что бот пока не умеет сам

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

Коротко

  1. Вручную: @BotFather → /newbot → токен → свой код или сервис для Telegram Bot API.
  2. Без кода: название бота → выбрать Telegram → описать задачу текстом — токен и подключение конструктор делает сам.
  3. Username появляется у бота автоматически — ищите бота в Telegram по нему.
  4. Владение ботом в @BotFather можно передать себе отдельным действием в любой момент.

Готовы собрать первого бота?

Начать бесплатно