Telegram-бот
Платформа позволяет подключить Telegram-бота к вашим AI-сценариям. Пользователи смогут общаться с ботом в Telegram, а платформа будет обрабатывать сообщения через заданные воркфлоу.
Обзор
Раздел Интеграции > вкладка Telegram отображает все созданные боты в виде карточек. Каждая карточка содержит:
- Название бота и его юзернейм в Telegram
- Текущий статус (активен / остановлен)
- Режим авторизации и контекста
- Список привязанных команд
- Список разрешённых пользователей (для режима Whitelist)
Создание бота
- Нажмите карточку Добавить Telegram Bot.
- Заполните форму:
| Поле | Описание |
|---|---|
| Bot Name | Отображаемое имя бота в платформе |
| Bot Token | Токен бота, полученный у @BotFather в Telegram |
| Project | Проект, к которому привязан бот |
| Default Workflow | Сценарий по умолчанию (необязательно) |
- Нажмите Create.
Откройте Telegram, найдите @BotFather, отправьте команду /newbot, следуйте инструкциям. BotFather выдаст токен вида 123456789:AAxxxx....
Настройки бота
Режим авторизации (Auth Mode)
Определяет, кто может пользоваться ботом:
- Public — бот доступен всем пользователям Telegram.
- Whitelist — бот доступен только пользователям из списка разрешённых Telegram ID.
При выборе режима Whitelist необходимо указать Telegram User ID разрешённых пользователей. Их можно добавить при создании бота (через запятую или по одному на строку) или позже через кнопку + User на карточке бота.
Режим контекста (Context Mode)
Управляет сохранением истории диалога:
- Per workflow — для каждого привязанного сценария хранится отдельная история разговора.
- Shared — единая история для всех сценариев бота.
- Per workflow + summary — отдельная история для каждого сценария с периодическим суммированием.
Голосовые сообщения (Voice)
- Voice In — принимать голосовые сообщения (распознавание речи STT).
- Voice Out — отвечать голосовыми сообщениями (синтез речи TTS).
- Max Voice (sec) — максимальная длительность голосового сообщения (от 5 до 300 секунд).
Дополнительные настройки
| Настройка | Описание |
|---|---|
| Ask for Phone | Запрашивать номер телефона перед началом работы |
| Auto Greeting | LLM автоматически генерирует приветствие при команде /start |
| Debounce Delay (sec) | Задержка перед обработкой сообщения (0 = отключено). Позволяет объединять несколько последовательных сообщений в одно |
| Max Wait (sec) | Максимальное время ожидания после первого сообщения в серии (5-60 сек). Отображается только при Debounce Delay > 0 |
Функция Debounce полезна, если пользователи отправляют сообщения по частям. Бот подождёт заданное время и обработает все сообщения как одно.
Привязка сценариев
Каждый бот может быть связан с несколькими воркфлоу через команды Telegram.
- Нажмите + Command на карточке бота.
- Выберите проект и воркфлоу.
- Укажите команду — текст, по которому пользователь активирует сценарий (например,
help,start). - Добавьте описание (необязательно).
Привязанные команды отображаются на карточке бота в виде тегов с префиксом /.
Если задан Default Workflow, он будет использоваться для всех сообщений, которые не соответствуют ни одной привязанной команде.
Управление пользователями
В режиме Whitelist можно управлять списком разрешённых пользователей:
- Добавить — нажмите + User и укажите Telegram User ID и отображаемое имя (необязательно).
- Удалить — нажмите крестик рядом с тегом пользователя на карточке.
Запуск и остановка
Переключатель в правом верхнем углу карточки позволяет:
- Включить — бот начинает принимать и обрабатывать сообщения.
- Выключить — бот перестаёт реагировать на сообщения.
Редактирование и удаление
- Редактировать — кликните на карточку бота, откроется модальное окно с настройками.
- Удалить — нажмите кнопку удаления на карточке и подтвердите действие.
Удаление бота отвяжет все привязанные сценарии и удалит список разрешённых пользователей. Это действие нельзя отменить.
Для использования голосовых сообщений в Telegram-боте необходимо подключить аудио-провайдеры (STT и TTS).