Telegram

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

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

Как это работает

Вы создаёте бота в Telegram и отдаёте кабинету его токен. Платформа сама привязывает бота к своему серверу (регистрирует вебхук) — с этого момента каждое текстовое сообщение боту уходит агенту, а ответ агента возвращается в тот же чат. Ответы отправляются с разметкой Markdown, так что списки и выделения из ответа агента отображаются как форматирование Telegram.

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

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

Как подключить

В Telegram откройте @BotFather, создайте бота командой /newbot и скопируйте выданный токен.
В кабинете откройте «Каналы», в списке доступных каналов у Telegram нажмите «Создать».
Вставьте токен в поле «Токен бота» — кабинет сразу проверит его у Telegram; с опечаткой канал не создастся.
При желании заполните «Приветственное сообщение» — оно отправляется в ответ на команду /start. Пустое поле — приветствия не будет: на /start ответит сам агент.
Нажмите «Создать». Канал появится в списке подключённых под @именем бота; кнопка «Открыть» ведёт на t.me/… — напишите боту и проверьте ответ.

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

Ограничения

Только текст. Голосовые, фото, видео, документы и стикеры не обрабатываются — клиент не получит на них никакого ответа. Предупредите об этом в описании бота или в приветствии.
Нет передачи оператору. Агент не может позвать человека в диалог; сообщения операторам из раздела «Диалоги» в Telegram не доставляются.
Нет ссылки «Источник». Ответы приходят без ссылки на документ-источник независимо от настройки «Показывать источники ответов».
Ответ не мгновенный. Пока агент ищет по базе знаний и формулирует ответ, клиент видит статус «печатает…».
Если квота запросов исчерпана или подписка истекла, бот отвечает «Попробуйте обратиться чуть позже» — следите за остатком в разделе «Тарифы и оплата».

Telegram

Как это работает

Как подключить

Ограничения

Смежные статьи