Как создать ИИ-агента в Telegram: техническая инструкция

Клиент пишет в Telegram: «Хочу рассчитать стоимость». ИИ-агент отвечает, уточняет задачу, проверяет базу знаний, уточняет имя и номера телефона, передает заявку в CRM.

Telegram-бот сам по себе не является ИИ. Это входная точка. Чтобы он отвечал как ИИ-агент, его нужно связать с платформой, промптом, базой знаний и логикой передачи заявок. Как это сделать, разберем в статье.

Что можно и что нельзя сделать в Telegram-боте

Telegram-бот может:

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

ИИ-агент внутри Telegram может делать больше:

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

Но есть ограничения. Telegram-бот не может написать пользователю первым. Клиент должен сам начать диалог. 

Telegram-бот не заменяет CRM, если данные нигде не фиксируются. Он не должен отвечать на вопросы вне базы знаний, если в нише высокая цена ошибки.

Правильная схема такая: Telegram → бот → ИИ-агент → база знаний → CRM или менеджер.

Как получить токен через BotFather – 5 минут

BotFather – официальный бот Telegram для создания и управления ботами.

Порядок действий:

• Откройте Telegram.
  
• Найдите официального бота @BotFather.
  
• Отправьте команду /newbot.
  
• Введите название бота.
  
• Введите username бота.
  
• Получите токен.
  
• Скопируйте токен в no-code платформу или backend.
  

В официальной документации Telegram указано, что при создании нового бота BotFather просит имя и username, а затем генерирует authentication token. Username должен заканчиваться на bot, например company_support_bot или CompanySupportBot. Токен нужен для авторизации запросов к Bot API, поэтому его нельзя публиковать или отправлять посторонним.

Что проверить сразу:

• username читаемый;
  
• в названии понятно, чья это поддержка или консультация;
  
• токен сохранен в безопасном месте;
  
• бот открывается по ссылке t.me/username_bot;
  
• команда /start запускает диалог.
  

Если токен случайно попал в открытый доступ, его нужно перевыпустить через BotFather и заменить в платформе.

Как подключить ИИ к боту через no-code платформу

После получения токена Telegram-бот еще не умеет отвечать как ИИ-агент. Для этого его нужно связать с сервисом, который будет обрабатывать сообщения. Например, NextBot – российская платформа для создания ИИ-агентов без кода. Вы описываете задачу агента текстовой инструкцией, загружаете базу знаний, подключаете Telegram через токен и настраиваете, что агент должен делать.

Базовый порядок:

• Создайте агента в NextBot.
  
• Опишите его роль, напишите промпт.
  
• Загрузите базу знаний.
  
• Откройте подключение Telegram.
  
• Вставьте токен из BotFather.
  
• Проверьте тестовый диалог.
  
• Настройте передачу заявки менеджеру или в CRM.
  

Промпт должен отвечать на вопросы:

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

Пример задачи: «ИИ-агент принимает заявки в Telegram, уточняет услугу, город, бюджет и телефон, отвечает на частые вопросы по базе знаний и передает целевые обращения менеджеру».

На техническом уровне Telegram Bot API получает входящие события двумя способами: через getUpdates или webhook. В no-code платформе обычно не нужно настраивать это вручную. Она сама принимает обновления от Telegram и передает сообщения ИИ-агенту.

В NextBot можно собрать и протестировать такого агента бесплатно – каждый новый пользователь получает 7 дней тестового доступа.

Как настроить работу в группе и в приватном чате

Telegram-бот может работать в двух режимах – личный чат и группа.

Приватный чат

Приватный чат подходит для общения с клиентом один на один. 

Сценарии:

• клиентская поддержка;
  
• прием заявок;
  
• запись;
  
• консультация;
  
• подбор услуги;
  
• квалификация лида;
  
• передача в CRM.
  

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

Что проверить:

• пользователь может нажать /start;
  
• бот отвечает на первое сообщение;
  
• агент понимает свободный текст;
  
• заявка передается менеджеру;
  
• к сложным вопросам подключается сотрудник.
  

Группа

Группа нужна, если вы хотите:

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

В Telegram у ботов в группах по умолчанию включен Privacy Mode. В этом режиме он видит не все сообщения, а только релевантные – команды, ответы на его сообщения, inline-сообщения и часть служебных событий. Если нужно, чтобы бот реагировал на все в группе, дайте ему права администратора или отключите privacy mode.

Для группы с менеджерами логика обычно такая:

• клиент пишет в личный чат бота;
  
• ИИ-агент собирает данные;
  
• отчет о заявке уходит в группу менеджеров;
  
• менеджер берет заявку в работу.
  

Если бот добавлен в группу и отвечает, когда не должен этого делать, проверьте:

• включен ли privacy mode;
  
• является ли бот администратором;
  
• должен ли агент отвечать в группе;
  
• настроено ли обращение к агенту по username;
  
• не отправили ли вы в группу тестовый пароль или команду подключения.
  

Как связать бота с CRM

Есть 3 уровня передачи данных.

Уровень 1. Отчет менеджеру

Самый простой вариант – отправлять заявку в Telegram-группу.

В отчете могут быть имя, телефон, суть запроса, источник, ответы клиента, статус лида, ссылка на диалог.

Подходит для малого бизнеса без CRM.

Уровень 2. Сделка в CRM-систему

Лучше передавать заявку в CRM. ИИ-агент может создать сделку, заполнить поля в карточке (имя, телефон, город, бюджет, срок, комментарий и т.д.) и двигать карточку по этапам воронки.

Для такой схемы можно использовать ИИ для amoCRM или ИИ для Битрикс24.

Уровень 3. Сценарии и автоматические действия

Более сложная схема:

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

Что проверить после подключения CRM:

• сделка создается;
  
• источник указан как Telegram;
  
• телефон попадает в нужное поле;
  
• комментарий понятен менеджеру;
  
• ответственный назначается правильно;
  
• дублей не создается;
  
• тестовая заявка проходит весь путь.
  

Что делать, если бот не отвечает

Если Telegram-бот молчит, проверьте цепочку по шагам:

• Бот создан и токен верный. Откройте BotFather и проверьте, что токен скопирован полностью. Частые ошибки – лишний пробел, старый токен, токен от другого бота, токен был перевыпущен, бот подключен к другой системе.
  
• Бот запущен пользователем, В приватном чате пользователь должен открыть бота и нажать /start. Если пользователь не начинал диалог, бот не сможет первым отправить ему сообщение.
  
• Канал подключен в платформе. Проверьте в NextBot, подключен ли Telegram, выбран ли нужный агент, активен ли ИИ-бот, нет ли паузы, не закончились ли лимиты, работает ли база знаний, не выключены ли ответы в канале.
  
• Группа настроена правильно. Если бот должен работать в группе, проверьте, что он добавлен в нее, у него есть права администратора (если они нужны), отключен privacy mode (если бот должен видеть все сообщения), отвечает ли он только по username, не настроена ли группа только для отчетов.
  
• Webhook или обработка обновлений не конфликтуют. Один Telegram-бот не должен одновременно обслуживаться двумя разными системами. Если токен добавлен в два сервиса, ИИ-агент не будет работать корректно.
  
• Превышены лимиты отправки. В обычных сценариях лимиты Telegram редко становятся проблемой. Но если бот делает массовую рассылку или активно пишет в группу, ограничения нужно учитывать. В FAQ Telegram указаны ориентиры – в одном чате лучше не отправлять больше одного сообщения в секунду, в группе бот не может отправлять больше 20 сообщений в минуту, а для массовых уведомлений обычный лимит составляет около 30 сообщений в секунду. При превышении могут появляться ошибки 429.
  

Если бот не работает после рассылки, проверьте ошибки, паузы и повторные отправки.

Запустите ИИ-агента для своего бизнеса в Telegram

Проверьте, как ИИ-агент может усилить ваш бизнес. В NextBot у вас будет 7 дней бесплатного доступа – этого хватит, чтобы создать Telegram-бота, подключить его к ИИ-агенту и проверить обработку реальных заявок. Регистрация по ссылке.

FAQ