База знаний › AI-агенты

Как подключить агента к Телеграм: пошагово и без кода

Как подключить агента к Телеграм: бот, токен, права и первые сообщения. Пошагово, без кода.

Короткий ответПодключение к Telegram — шесть шагов: создать бота у @BotFather, получить токен, настроить профиль, выбрать опрос или вебхук, разделить клиентского и служебного бота, проверить отказы. Это около двадцати минут.

Разбираемся, как подключить агента к телеграм за вечер. Нужно создать бота, взять токен, настроить вебхук и правила ответов.

Всё упирается в две вещи: токен и права доступа.

Телеграм — самый быстрый канал для агента. Понадобятся токен бота и адрес, куда приходят сообщения.

Шаг 1. Создайте бота

  1. Зайдите к @BotFather
  2. Отправьте /newbot
  3. Введите имя — его увидят клиенты
  4. Введите username, он заканчивается на bot
  5. Заберите токен

С токеном у вас полный доступ к боту. В чаты и открытые репозитории его не кладут.

Шаг 2. Настройте профиль

  1. /setdescription — текст, который клиент видит перед началом диалога
  2. /setabouttext — описание в профиле
  3. /setcommands — перечень команд
  4. /setjoingroups — разрешено ли боту работать в группах

Шаг 3. Подключите к агенту

Вариантов два.

Опрос. Бот сам спрашивает Телеграм про новые сообщения. Публичный адрес не нужен. Для теста хватает.

Вебхук. Сообщения отправляет вам сам Телеграм. Быстрее. Для постоянной работы понадобится домен с сертификатом.

Шаг 4. Сделайте два бота

Один бот обслуживает клиентов. Второй шлёт уведомления вам и команде.

Иначе агент влезет в чат, где вы разбираете внутренние задачи, и начнёт отвечать клиентам там.

Шаг 5. Проверьте отказы

  1. Клиент пишет не по теме — агент возвращает к задаче
  2. Клиент просит человека — передаёт без спора
  3. Клиент присылает файл — что происходит
  4. Модель недоступна — что видит клиент

Шаг 6. Читайте диалоги

В первые дни читайте переписку целиком, а не только ошибки.

Ответ бывает формально верным — и при этом против ваших правил.

Токен и права

Бота создают у официального BotFather. Токен работает как пароль: держите отдельно, не публикуйте.

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

Что писать в приветствии

Коротко: кто это, что умеет, куда идти дальше. Одна кнопка или один вопрос.

Длинные инструкции в первом сообщении никто не читает.

Ошибки подключения

Агент отвечает на всё подряд и мешает в чате. Передачи человеку нет. Логов нет — и неясно, почему он ответил именно так.

Лечится настройкой триггеров и хранением истории.

Как подключить агента к Телеграм: шаги

Подробнее: Как зарегистрировать AI-агента: пошагово и Виды AI-агентов: 10 агентов под конкретные бизнес-процессы.

AI-агент в Телеграме — это бот, которому выдан токен. Для бизнеса он ставится за вечер: старт у BotFather, финал — тест на своих вопросах.

Что с этим читают

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

Частые вопросы

Нужен ли сервер?

Для опроса не нужен. Для вебхука понадобится домен с сертификатом. На практике сервер берут, чтобы агент работал круглосуточно.

Что будет, если токен утечёт?

Чужой человек прочитает переписку и сможет писать клиентам. Отзовите токен через /revoke и выпустите новый.

Можно ли подключить WhatsApp?

Да, через официальный Business API. Дольше и дороже: понадобится верификация бизнеса и шаблоны сообщений.

Нужен ли сервер для бота?

Нет, если хватает вебхука и облачного сервиса. Свой сервер нужен для тяжёлых задач.

Можно ли подключить бота к группе?

Да — с правами администратора или после добавления в чат. Тогда настройте реакцию только на упоминания.

Сколько стоит Telegram-бот?

Мессенджер бесплатный. Платите за разработку и за используемую модель.

Сергей Езепенко
Сергей ЕзепенкоПодключение агента к Telegram

Подключу агента к Телеграму и проверю, что он отвечает клиентам. Бесплатная диагностика — 30 минут.

Написать в TelegramНаписать в MAX