Подключение агента к боту в Telegram

Подключение к боту в Telegram: ИИ-агент общается с вашими клиентами прямо в Telegram — клиент пишет боту, агент отвечает сам, круглосуточно.

Как получить токен бота Telegram

1. Откройте в Telegram официального бота @BotFather и нажмите «Запустить».
2. Отправьте команду /newbot.
3. Введите название бота — это имя клиенты увидят в чате. Можно использовать русские буквы.
4. Введите имя пользователя бота: латиницей, без пробелов и обязательно с окончанием bot — например Xcompany_support_bot. Если имя занято, BotFather попросит придумать другое.
5. BotFather пришлёт сообщение с токеном — длинную строку вида 1234567890:AAH…. Скопируйте её.

Как подключить ИИ-агента к боту в Telegram

1. Вкладка «Подключения» → в карточке «Telegram (бот)» нажмите «Подключить».
2. На странице подключения два поля:

1. Токен бота — вставьте токен, который скопировали в @BotFather по инструкции выше. Символы скрыты, как в поле пароля; глазок справа показывает введённое значение.
2. Приветственное сообщение — текст, который бот отправит клиенту автоматически при первом входе в чат-бот или по команде /start. По умолчанию подставлено «Добрый день! Чем могу вам помочь», но лучше написать своими словами, в стиле вашей компании. Максимум 1000 символов.

Нажмите «Подключить».

3. Платформа сама настраивает и подключает ИИ-агента к вашему боту, никаких дополнительных настроек делать не нужно.

При удачном подключении под заголовком страницы появляется зелёная галочка и подпись «Подключен к боту» со ссылкой на бота вида https://t.me/имя_бота — по ней можно сразу открыть чат-бота и проверить его работу.

В карточке «Telegram (бот)» на вкладке «Подключения» кнопка «Подключить» меняется на «Настройки», а статус — на «Подключен».

4. В боте нажмите кнопку «Запустить» — сначала придёт приветственное сообщение, которое вы задали в п. 2, а дальше на ваши вопросы будет отвечать ИИ-агент.

Как изменить приветственное сообщение в боте или заменить токен

Вкладка «Подключения» → в карточке «Telegram (бот)» нажмите «Настройки».

1. Токен бота показан в скрытом виде ***. Чтобы заменить бота, вставьте в поле новый токен целиком и нажмите «Сохранить»: платформа переключит агента на нового бота.
2. Приветственное сообщение можно переписать в любой момент и сохранить кнопкой «Сохранить». Новый текст увидят те клиенты, которые войдут в бота после сохранения.

Приём голосовых сообщений

Голосовые включаются на вкладке LLM-модели переключателем «Принимать голосовые сообщения»:

• переключатель включён — агент расшифрует голосовое клиента в текст и ответит на него текстом;
• переключатель выключен — вместо ответа агент отправит текст из поля «Текст ответа, когда голосовые отключены».

Где смотреть переписку

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

Отключение и пауза ИИ-агента

На странице «Подключение агента к чат-боту в Telegram» есть красная кнопка «Отключить». Она разрывает связь агента с ботом: бот перестаёт получать сообщения и переходит в состояние «Не подключен». Сам бот в Telegram при этом никуда не пропадает — он остаётся в @BotFather, и его можно подключить снова.

Если агент нужен просто «на паузе», не отключайте канал: выключите агента переключателем «Статус агента» на вкладке «Настройки» — подключение к боту и переписка останутся на месте:

Если агент не отвечает в Telegram

Проверьте по порядку:

1. Статус агента на вкладке «Настройки» — он должен быть «Включен».
2. LLM-модель на вкладке «LLM-модели» — она должна быть выбрана.
3. Баланс платформы — при нулевом или отрицательном балансе агент молча перестаёт отвечать. Баланс пополняется в личном кабинете.
4. Токен — не был ли он перевыпущен в боте @Botfather, не подключён ли этот же бот к другому агенту или другой платформе
5. Защита от спама на вкладке «Расширенное управление» — если клиент превысил лимит сообщений, агент отвечает заготовленным текстом, а не по промпту.