Главная · Блог · ИИ-бот в Telegram за час: от токена до первого ответа нейросети
ИИ-бот в Telegram за час: от токена до первого ответа нейросети
Час — реальный срок, если база знаний уже лежит в текстовом файле, а карта под рукой: ИИ в ЧБТ доступен с тарифа «Базовый» (650 ₽ за бота в месяц), на «Бесплатном» блока «ИИ-агент» нет. Отвечать будет открытая модель через Replicate (например, Llama 3 70B), а не ChatGPT — это стоит знать до начала, а не после. Ниже — таймлайн по минутам: токен у @BotFather, подключение канала, создание агента, сценарий из трёх блоков, тест и запуск. В конце — таблица затыков, на которых час обычно превращается в вечер.
До старта: что подготовить и две честные оговорки
Час укладывается, если к началу на столе лежат:
- аккаунт в ЧБТ (регистрация — e-mail и пароль, минута);
- Telegram на телефоне и на компьютере — с телефона удобнее тестировать;
- текстовый файл с базой знаний: цены, условия, частые вопросы — компактно, без маркетинга. Если его нет — начните с него, это единственный этап, который не ускорить; как собрать — в статье про базу знаний для ИИ-агента;
- банковская карта: ИИ-агенты доступны с тарифа «Базовый» — 650 ₽ за бота в месяц. На «Бесплатном» Telegram-бот работает, но блока «ИИ-агент» в нём нет.
Вторая оговорка — про модель. Отвечать будет не ChatGPT: в ЧБТ подключены открытые модели через Replicate, например Llama 3 70B, три уровня на выбор — простая, средняя, сильная. Для базы с ценами и условиями этого достаточно; для сочинения текстов по настроению — нет. И ещё: ИИ-агент отвечает только текстом — без кнопок, фото и файлов; кнопки дают блоки сценария до и после узла. Картинки товаров агент не покажет: фото товаров показывают только карточки ИИ-продавца, который отвечает по каталогу, а не по базе знаний.
Дальше — таймлайн. Время указано с запасом на «где эта кнопка».
0:00–0:07 — токен у @BotFather
В Telegram откройте @BotFather, отправьте /newbot. Он спросит два имени: отображаемое (любое, можно по-русски) и username — латиницей, обязательно с окончанием bot, например svet_electro_bot. В ответ придёт токен вида 123456789:AAH.... Скопируйте его целиком — без пробелов в начале и конце, это частая причина «канал не подключается».
Токен — ключ к боту. Не пересылайте его в чаты и не публикуйте; если утёк — в @BotFather команда /revoke выдаст новый, а старый перестанет работать (и его придётся заменить в ЧБТ). Подробнее про BotFather, имя, аватар и описание — в справке про токен и в статье про создание Telegram-бота (ссылка внизу).
0:07–0:17 — подключаем канал и включаем тариф с ИИ
В кабинете ЧБТ: создайте бота (это проект — один бот работает во всех подключённых каналах), откройте раздел «Каналы» → «Подключить Telegram», вставьте токен, сохраните. ЧБТ сам установит вебхук с секретным токеном — вручную ничего настраивать не нужно. В карточке канала должен появиться статус подключения.
Если позже вы отзовёте токен в @BotFather и забудете обновить его в ЧБТ, вебхук начнёт возвращать 401 — ЧБТ пришлёт письмо владельцу. Пока сценария нет, бот на сообщения отвечать не будет — это нормально, к тесту вернёмся на 47-й минуте. Пошаговая справка по подключению есть в разделе «Помощь».
Следующие пять минут — раздел «Оплата», без него блок «ИИ-агент» в сценарии не появится. Два варианта:
- «Базовый», 650 ₽ — 150 ИИ-ответов в месяц, холст, рассылки, без лимита диалогов. Для старта и небольшого потока вопросов.
- Пробный период «Бизнеса» — 1 день, активируется там же. Подходит, чтобы собрать и проверить всё сегодня, а платить — когда решите. «Бизнес» — 1290 ₽, 500 ИИ-ответов в месяц.
Оплата картой через CloudPayments, автопродление включено по умолчанию — отключается в том же разделе; отмена не сжигает оплаченный период. На ввод карты и подтверждение заложено пять минут. Сравнение тарифов — на странице цен.
0:17–0:37 — создаём ИИ-агента
Самый длинный этап. Раздел «ИИ-агенты» → создать. В карточке пять полей, по порядку:
- Имя — как агент представится: «Консультант студии „Свет“».
- Модель — начните со средней. Сильную включайте, если в тесте агент путает похожие позиции.
- Температура — ниже среднего, 0,3–0,4: нам нужны цены из базы, а не творчество.
- Персона (роль) — 6–8 строк: кто он, на каком языке и как коротко отвечает, что отвечает только по базе, что делает, если ответа нет («скажи, что уточнишь, и предложи позвать оператора»), чего не обещает (скидки, сроки, результат) и чего не спрашивает (данные карты, паспорт).
- База знаний — вставьте подготовленный текст. База уходит модели целиком с каждым вопросом, поэтому длинную сначала сократите: режьте маркетинговые абзацы и повторы.
Двух вещей в карточке нет, и искать их не надо. Приветствие агент не пишет — первое сообщение с кнопками делается блоком «Сообщение» в сценарии, и оно бесплатное. Слов-триггеров для передачи человеку тоже нет: выход к оператору настраивается в сценарии — портом «не понял» блока «ИИ-агент» и отдельным сценарием на слово «оператор» (об этом на следующем шаге).
Сохраните и откройте тест-чат в карточке агента. Пять вопросов: два — прямо из базы, один — перефразированный с опечаткой, один — вне базы (должен честно отказаться и предложить оператора), один — просьба «позовите человека» (по роли агент должен согласиться и предложить оператора, а не спорить). Если что-то не так — правьте базу или персону сейчас: после запуска каждая ошибка будет стоить кредит и доверие клиента.
0:37–0:47 — сценарий из трёх блоков
Раздел «Сценарии» → новый сценарий. Режим «Холст» удобнее: видно ветки. Триггер — команда /start: с неё начинается любой диалог с Telegram-ботом, кнопка «Начать» в Telegram отправляет именно её. Дальше:
- «Сообщение» — приветствие с двумя кнопками: «Задать вопрос» и «Связаться с менеджером». Если планируете рассылки или собираете базу, сюда же — короткий текст согласия на обработку данных.
- По кнопке «Задать вопрос» — «ИИ-агент»: выберите созданного агента, режим «Остаться в диалоге с ИИ» и поставьте галочку «Отдельный порт «не понял»». Агент ведёт диалог, учитывая последние 10 сообщений, а когда не уверен в ответе или не находит его в базе — уходит по порту «не понял».
- После «ИИ-агента» — «Оператор»: диалог уходит в «Диалоги», бот замолкает. Сюда ведите порт «не понял», выход блока на случай исчерпания кредитов и кнопку «Связаться с менеджером».
Ещё две минуты — на второй сценарий: триггер «Ключевое слово» в режиме «содержит» — оператор, менеджер, человек — → «Сообщение» «Передаю» → «Оператор». Учтите, как он взаимодействует с агентом: в режиме «Остаться в диалоге с ИИ» текст клиента уходит агенту раньше проверки триггеров, и слово «оператор» внутри разговора увидит не сценарий, а сам агент. Выход из этого режима один — порт «не понял», и срабатывает он, когда ответ агента звучит как отказ или неуверенность: «не могу», «нет информации», «уточните у…», «к сожалению». Поэтому в персону добавьте строку: «если просят позвать человека — не отвечай на вопрос, а напиши: «К сожалению, сам не могу помочь — передаю оператору»». Такой ответ уводит диалог в порт «не понял», а из него — в «Оператор». Сценарий на ключевое слово при этом нужен для всех остальных случаев: когда человек пишет «оператор» из меню, посреди вопроса про телефон или после закрытия диалога.
Опционально, если есть минута: перед «ИИ-агентом» поставьте «Действие» → «Добавить тег» ии, а перед «Оператором» — тег эскалация. Через неделю в «Контактах» по этим тегам будет видно, сколько людей дошли до нейросети и сколько ушли к человеку — отдельных счётчиков по блокам в ЧБТ нет.
Альтернатива кнопочному входу — триггер «Любое сообщение»: сценарий стартует на любой текст, и человек попадает к агенту, не нажимая кнопок. Так естественнее для клиента, но дороже: каждое «привет» и «спасибо» — отдельный ответ агента, то есть кредит. Для первого запуска оставьте /start с кнопками; на «Любое сообщение» переходите, когда поймёте реальный поток и его стоимость.
Сценарий сохраняется автоматически; история версий позволит откатиться, если что-то сломаете при правках. Если по ходу захочется что-то поправить словами — в редакторе есть ИИ-правка текстом: «добавь после приветствия вопрос про город».
0:47–0:55 — тест с телефона
Сначала «Проверить сценарий» в редакторе — тест-чат прямо в ЧБТ, без Telegram: пройдите обе кнопки. Затем — настоящий Telegram с телефона: найдите бота по username, нажмите «Начать».
- Приветствие с кнопками пришло? Если нет — смотрите «Каналы»: подключён ли токен, и «Сценарии»: включён ли сценарий.
- «Задать вопрос» → вопрос из базы → ответ по фактам.
- Вопрос вне базы → отказ и предложение оператора, без выдуманной услуги.
- Просьба «позовите оператора» → агент отвечает фразой-отказом из персоны, и в кабинете, в «Диалогах», появился диалог со статусом «Оператор» (вкладка «Ждут ответа»), пришло уведомление (включите звук и браузерные уведомления значком колокольчика в инбоксе).
- Ответьте из «Диалогов» — сообщение должно прийти в Telegram.
Каждый ответ агента в реальном Telegram списывает кредит, поэтому тестируйте прицельно: формулировки и базу отлаживайте в тест-чате агента, а в Telegram — два-три контрольных вопроса. Если бот молчит на все сообщения — чеклист причин в статье «Почему Telegram-бот не отвечает» (ссылка внизу).
0:55–1:00 — запуск
- В @BotFather задайте описание бота (
/setdescription) и аватар — это видно до первого сообщения. - Ссылку
t.me/ваш_бот— в описание канала, в подпись на сайте, в профиль. Для разных источников используйте диплинкиt.me/ваш_бот?start=site: триггер «Диплинк» в сценарии ловит payload, и вы поймёте, откуда пришли люди. - В разделе «Доступ» пригласите операторов по e-mail с ролью «Оператор» — иначе переданные диалоги будут ждать вас одного.
- Web Push в «Аккаунт → Уведомления» — чтобы видеть эскалации при закрытой вкладке. Там же — письмо на e-mail о новом диалоге, если кабинет открывают не каждый день.
На этом час закончился: бот отвечает по базе, передаёт человеку и собирает контакты в «Контактах». Все возможности Telegram-канала в ЧБТ — на странице «Чат-бот Telegram без программирования».
Где обычно теряется час
| Затык | Причина | Что делать |
|---|---|---|
| База знаний «почти готова» | Её нет в текстовом виде | Начать с базы, а не с токена. Загрузить PDF или ссылку нельзя — только текст |
| Канал не подключается | Пробел в токене, токен от другого бота | Скопировать заново из @BotFather целиком |
| Нет блока «ИИ-агент» | Тариф «Бесплатный» | «Оплата» → «Базовый» или пробный день «Бизнеса» |
| Агент отвечает общими словами | База тонкая или маркетинговая | Заменить описания на строки «услуга — цена — срок» |
| Агент выдумывает услуги | Нет явных отказов | Раздел «Чего мы не делаем» в базе, «только по базе» в роли |
| Слово «оператор» не передаёт диалог | Нет сценария на ключевое слово; либо агент в режиме «Остаться в диалоге с ИИ», а порт «не понял» не ведёт в «Оператор» | Завести сценарий «Ключевое слово» → «Оператор»; порт «не понял» → «Оператор» |
| Бот замолчал через неделю | Закончились кредиты | Ветка fallback → «Оператор»; кнопки для типовых вопросов |
Ещё одна ловушка — ожидания. Агент отвечает ровно на то, что написано в базе, не больше. Если клиенты спрашивают о том, чего в базе нет, это не поломка, а сигнал дописать текст: «Диалоги» на вкладке «Ждут ответа» покажут, что именно.
Первая неделя: три правки, которые понадобятся
Бот, собранный за час, — черновик. Через неделю реальных диалогов почти всегда нужны три правки.
- Дописать базу. Откройте «Диалоги», вкладку «Ждут ответа», а то, на что оператор уже ответил и что закрыл, — на вкладке «Закрытые»: там диалоги, которые агент отдал человеку. Выпишите вопросы, на которые ответа в базе не было, и добавьте их парами «вопрос — ответ» в карточку агента.
- Расширить ключевые слова. Клиенты просят человека не словом «оператор», а «позовите менеджера», «можно с живым», «кто-нибудь есть?». Добавьте формулировки из реальных диалогов в триггер «Ключевое слово» сценария передачи — и той же строкой в персону агента, чтобы он распознавал просьбу внутри разговора.
- Снять с ИИ повторяющееся. Если один вопрос — «сколько стоит выезд?» — задают в каждом третьем диалоге, вынесите его кнопкой в приветствие с готовым сообщением. Это бесплатно и точнее, чем ответ модели, а кредиты останутся на редкие вопросы.
Расход кредитов оценивайте по тегам из шага «0:37–0:47»: в «Контактах» фильтр по тегу ии покажет, сколько людей дошли до агента, по тегу эскалация — сколько ушли к человеку. Если к концу второй недели видно, что 150 ответов «Базового» не хватит, переход на «Бизнес» с 500 кредитами делается в «Оплате» без пересборки бота.
Что дальше: MAX, сайт и поддержка
Сценарий не привязан к Telegram. Подключите в том же боте канал MAX или ВКонтакте — тот же агент и та же цепочка блоков заработают там без переноса. Для сайта есть отдельная сборка с триггером «Открытие виджета» и pre-chat формой — в статье про ИИ-консультанта на сайте. Если бот нужен для поддержки клиентов, а не для консультаций, границы «что доверять нейросети» разобраны в соседней статье про первую линию поддержки на ИИ-агенте.
Через неделю загляните в «Аналитику»: если на графике «Ответы оператора» растут вместе с входящими, база не справляется (ответы агента там входят в «Ответы бота»). А на вкладке «Ждут ответа» в «Диалогах» лежат вопросы, которых базе не хватает. Создать бота и уложиться в час →
Чат-бот Telegram в ЧБТКак создать Telegram-бота: BotFather, имя, аватарПочему Telegram-бот не отвечаетБаза знаний для ИИ-агентаПервая линия поддержки на ИИ-агенте