Перейти к содержимому
llmagentLLM-Агент Документация

Telegram

Как подключить Telegram-бота к агенту llmagent — токен BotFather, приветствие на /start, что поддерживается и какие есть ограничения.

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

Вы создаёте бота в Telegram и отдаёте кабинету его токен. Дальше всё настраивается само: с этого момента каждое текстовое сообщение уходит агенту, а его ответ возвращается в тот же чат. Списки и выделения из ответа Telegram показывает как обычное форматирование.

Вместе с сообщением бот получает данные из профиля отправителя: имя, фамилию и @username. Если в профиле Telegram есть имя, бот не станет переспрашивать его у клиента. Эти же данные видны в разделе «Диалоги»: беседа подписывается именем клиента.

Живой очереди операторов в Telegram нет — сам позвать человека бот здесь не может. Но подключиться к разговору сотрудник всё равно может: в ленте диалога в разделе «Диалоги» есть поле ответа оператора, и написанное уходит собеседнику прямо в Telegram. Первая же реплика человека останавливает бота. Подробнее — «Диалоги и оператор».

Если нужна именно живая очередь с распределением, подключите открытую линию Битрикс24; Telegram при этом можно завести в неё средствами самого Битрикс24 — тогда обращения из Telegram пойдут через линию со всеми её возможностями.

  1. В Telegram откройте @BotFather, создайте бота командой /newbot и скопируйте выданный токен.
  2. В кабинете откройте «Каналы» и в блоке «Добавить канал» нажмите «Подключить» у Telegram.
  3. Вставьте токен в поле «Токен бота» — кабинет сразу проверит его у Telegram; с опечаткой канал не подключится.
  4. При желании заполните «Приветствие» — оно уходит в ответ на команду /start. Пустое поле — приветствия не будет: на /start ответит сам агент.
  5. Нажмите «Подключить». Канал появится среди подключённых под @именем бота; кнопка «Открыть» ведёт на страницу бота — напишите ему и проверьте ответ.

Ботов может быть несколько — каждый подключается отдельным каналом к одному и тому же агенту. Отключите канал в кабинете — и бот перестанет получать сообщения; сам бот в Telegram остаётся, его можно удалить у BotFather.

  • Только текст. Голосовые, видео, документы и стикеры не обрабатываются — клиент не получит на них никакого ответа. Предупредите об этом в описании бота или в приветствии.
  • Бот сам не зовёт оператора. Живой очереди в Telegram нет; человек подключается к диалогу из кабинета.
  • Файлы бот не готовит. Подготовка документов — внутренний сценарий, он работает в кабинете и в чатах сотрудников Битрикс24.
  • Ответ не мгновенный. Пока бот ищет по базе знаний и формулирует ответ, клиент видит статус «печатает…».
  • Если запросы на тарифе закончились или оплаченный период истёк, бот предлагает обратиться позже — следите за остатком в разделе «Тариф и оплата».