Telegram
Как подключить Telegram-бота к агенту llmagent — токен BotFather, приветствие на /start, что поддерживается и какие есть ограничения.
Telegram — самый быстрый способ вывести агента к клиентам: нужен только токен бота от BotFather. Бот отвечает текстом на текст, показывает «печатает…», пока агент готовит ответ, и знает имя собеседника из его профиля Telegram.
Как это работает
Заголовок раздела «Как это работает»Вы создаёте бота в Telegram и отдаёте кабинету его токен. Дальше всё настраивается само: с этого момента каждое текстовое сообщение уходит агенту, а его ответ возвращается в тот же чат. Списки и выделения из ответа Telegram показывает как обычное форматирование.
Вместе с сообщением бот получает данные из профиля отправителя: имя, фамилию и @username. Если в профиле Telegram есть имя, бот не станет переспрашивать его у клиента. Эти же данные видны в разделе «Диалоги»: беседа подписывается именем клиента.
Живой очереди операторов в Telegram нет — сам позвать человека бот здесь не может. Но подключиться к разговору сотрудник всё равно может: в ленте диалога в разделе «Диалоги» есть поле ответа оператора, и написанное уходит собеседнику прямо в Telegram. Первая же реплика человека останавливает бота. Подробнее — «Диалоги и оператор».
Если нужна именно живая очередь с распределением, подключите открытую линию Битрикс24; Telegram при этом можно завести в неё средствами самого Битрикс24 — тогда обращения из Telegram пойдут через линию со всеми её возможностями.
Как подключить
Заголовок раздела «Как подключить»- В Telegram откройте @BotFather, создайте бота командой
/newbotи скопируйте выданный токен. - В кабинете откройте «Каналы» и в блоке «Добавить канал» нажмите «Подключить» у Telegram.
- Вставьте токен в поле «Токен бота» — кабинет сразу проверит его у Telegram; с опечаткой канал не подключится.
- При желании заполните «Приветствие» — оно уходит в ответ на команду
/start. Пустое поле — приветствия не будет: на/startответит сам агент. - Нажмите «Подключить». Канал появится среди подключённых под @именем бота; кнопка «Открыть» ведёт на страницу бота — напишите ему и проверьте ответ.
Ботов может быть несколько — каждый подключается отдельным каналом к одному и тому же агенту. Отключите канал в кабинете — и бот перестанет получать сообщения; сам бот в Telegram остаётся, его можно удалить у BotFather.
Ограничения
Заголовок раздела «Ограничения»- Только текст. Голосовые, видео, документы и стикеры не обрабатываются — клиент не получит на них никакого ответа. Предупредите об этом в описании бота или в приветствии.
- Бот сам не зовёт оператора. Живой очереди в Telegram нет; человек подключается к диалогу из кабинета.
- Файлы бот не готовит. Подготовка документов — внутренний сценарий, он работает в кабинете и в чатах сотрудников Битрикс24.
- Ответ не мгновенный. Пока бот ищет по базе знаний и формулирует ответ, клиент видит статус «печатает…».
- Если запросы на тарифе закончились или оплаченный период истёк, бот предлагает обратиться позже — следите за остатком в разделе «Тариф и оплата».