Подключение Telegram-бота · Документация AlgoAgent

Telegram-бот — это «лицо» вашего AI-консультанта в Telegram. Клиент пишет боту, а отвечает на его сообщения агент, которого вы настроили в платформе. Подключение занимает пару минут и состоит всего из двух шагов: получить токен у официального бота @BotFather и вставить этот токен в ваш кабинет.

В этой статье — весь путь по шагам, с проверкой в конце.

Что вам понадобится

Аккаунт в Telegram (с него вы создадите бота).
Уже созданный агент в платформе — именно он будет отвечать клиентам. Если агента ещё нет, сначала создайте его в разделе «Агенты», затем возвращайтесь сюда.
2–3 минуты времени.

Важно про бота. Один бот = один агент. Бот, которого вы создаёте у @BotFather, — это новый, отдельный бот (не ваш личный аккаунт). Клиенты будут писать именно ему.

Шаг 1. Создайте бота у @BotFather и получите токен

@BotFather — это официальный бот Telegram, который выдаёт и настраивает всех ботов. Создавать ботов можно только через него.

Откройте Telegram и найдите бота @BotFather (ссылка: https://t.me/BotFather). Убедитесь, что у него стоит синяя галочка — это официальный бот.
Нажмите Start (Запустить) или отправьте команду /start.
Отправьте команду /newbot.
@BotFather попросит имя бота (Name) — это видимое название, которое клиент увидит вверху чата. Например: Школа Звёздочка — консультант.
Затем он попросит username бота — уникальный логин, обязательно заканчивается на bot (например zvezdochka_school_bot). Если такой логин занят — придумайте другой.
После этого @BotFather пришлёт сообщение с токеном. Токен выглядит так:
```
123456789:AAFhk-DEFghIJKlmNoPQRstuVWxyz1234567
```
Это длинная строка из цифр, двоеточия и букв.

[скриншот: ответ @BotFather с токеном, сам токен замазан]

Берегите токен как пароль. Токен даёт полный доступ к боту. Никому его не пересылайте и не публикуйте. Если токен случайно «утёк» — отправьте @BotFather команду /revoke, он выдаст новый, а старый перестанет работать (тогда бота нужно будет переподключить в платформе с новым токеном).

Скопируйте токен целиком — он понадобится на следующем шаге.

Шаг 2. Подключите бота в кабинете AlgoAgent

В кабинете перейдите в раздел «Боты» (в боковом меню).
Вверху страницы выберите вкладку Telegram (рядом есть вкладка MAX — она для другого мессенджера).
Нажмите кнопку «Подключить бота» в правом верхнем углу.

[скриншот: страница «Боты», вкладка Telegram, кнопка «Подключить бота»]

Откроется форма с двумя полями:

Поле	Что вписать
Токен бота	Вставьте токен, который выдал @BotFather. Поле скрывает символы точками — это нормально, токен защищён.
Агент	Выберите из списка агента, который будет отвечать клиентам этого бота.

Вставьте токен в поле «Токен бота».
В выпадающем списке «Агент» выберите нужного агента.
Нажмите «Подключить».

[скриншот: форма подключения с полями «Токен бота» и «Агент»]

Что происходит в этот момент

Когда вы нажимаете «Подключить», платформа за пару секунд делает несколько вещей автоматически:

Проверяет токен — обращается к Telegram и убеждается, что токен настоящий и рабочий. Если токен неверный или с опечаткой — вы увидите ошибку, и бот не подключится.
Считывает данные бота — забирает у Telegram username бота (тот самый @..._bot) и его внутренний числовой идентификатор (см. ниже про bot_id).
Привязывает бота к выбранному агенту.
Настраивает webhook — «трубу», по которой Telegram будет мгновенно присылать платформе все сообщения клиентов (подробнее ниже).

Если всё прошло успешно — появится зелёное уведомление «Бот подключён!», и бот сразу появится в списке на этой же странице.

Что такое webhook (и почему его не надо настраивать вручную)

Webhook — это адрес, на который Telegram присылает каждое новое сообщение клиента. Грубо говоря, это «почтовый ящик»: как только клиент написал боту, Telegram моментально стучится по этому адресу, платформа получает сообщение, передаёт его агенту — и бот отвечает.

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

Иногда webhook нужно «обновить» — например, если бот перестал отвечать после технических работ или вы подключали бота очень давно. Для этого на странице есть кнопка «Обновить webhooks» (появляется, когда у вас есть хотя бы один бот). Нажмите её — платформа заново пропишет адреса для всех ваших активных Telegram-ботов и покажет, сколько обновлено (например, Webhooks обновлены: 2/2).

[скриншот: кнопка «Обновить webhooks» рядом с «Подключить бота»]

Что такое bot_id

В списке ботов вы видите @username (логин бота). Но внутри Telegram у каждого бота есть ещё и bot_id — постоянный числовой идентификатор (например, 123456789).

Чем bot_id отличается от username:

username (@..._bot) можно при желании поменять через @BotFather — клиенты видят именно его.
bot_id не меняется никогда. Это «паспортный номер» бота.

Платформа использует bot_id, чтобы надёжно узнавать вашего бота, даже если вы переименуете его логин, и чтобы не дать подключить одного и того же бота дважды. Если вы попробуете подключить токен бота, который уже добавлен (вашими руками или в другом кабинете), платформа покажет ошибку «Этот бот уже подключён» — это защита от дублей.

Вам не нужно нигде вводить bot_id вручную — платформа определяет его сама из токена.

Шаг 3. Проверьте, что бот работает

В списке ботов на странице найдите свежеподключённого бота. У него должен стоять зелёный бейдж «Активен».
Нажмите на иконку-стрелку (открыть в Telegram) рядом с ботом, либо просто найдите бота в Telegram по его @username.
Нажмите Start и напишите боту тестовое сообщение, например: «Здравствуйте, расскажите про курсы».
Бот должен ответить в течение нескольких секунд — текстом, который сгенерирует привязанный агент.

[скриншот: карточка бота со статусом «Активен», иконки «Настроить» и «открыть в Telegram»]

Если бот ответил — поздравляем, всё подключено правильно.

Дополнительные настройки бота

В карточке бота есть кнопка «Настроить» — она открывает отдельную страницу, где можно задать имя, описание, фото-аватар и приветственное сообщение бота. Эти настройки платформа применяет и на стороне Telegram (имя и описание подтянутся в профиль бота). Менять токен или агента там не нужно — для этого бота переподключают.

Если что-то пошло не так

Симптом	Что сделать
Ошибка «неверный токен» при подключении	Скопируйте токен у @BotFather заново — целиком, без лишних пробелов в начале/конце. Токен должен содержать двоеточие.
«Этот бот уже подключён»	Этот бот уже добавлен (в вашем или другом кабинете). Создайте у @BotFather нового бота командой `/newbot` и подключите его токен.
Бот подключился, но не отвечает	Нажмите «Обновить webhooks» на странице ботов. Если не помогло — проверьте, что у бота стоит статус «Активен» и что выбранный агент настроен и работоспособен.
Не удалось подключить бота / ошибка регистрации webhook	Попробуйте ещё раз через минуту (бывает временный сбой на стороне Telegram). Если повторяется — напишите в поддержку.
Достигнут лимит ботов	У каждого тарифа есть лимит на количество Telegram-ботов. Если он исчерпан — отключите ненужного бота (корзина в его карточке) или обратитесь к менеджеру для расширения лимита.

Как отключить бота

Если бот больше не нужен: в его карточке нажмите иконку корзины, подтвердите действие. Бот будет отключён, его webhook у Telegram снимется, и он перестанет отвечать клиентам. Сам бот в @BotFather при этом сохраняется — при желании вы сможете подключить его токен снова.

Коротко. Создаёте бота у @BotFather → копируете токен → вставляете в «Боты → Telegram → Подключить бота» → выбираете агента → проверяете в Telegram. Webhook и идентификаторы платформа настраивает за вас автоматически.