Все ноды/Integrations/Telegram
История группы Telegram
Читает записанную историю Telegram-чата: сообщения, которые бот наблюдал в группе/канале, включая те, что не запускали воркфлоу. Требует включённой галки «Записывать историю группы» в деплое И отключённого privacy mode у бота (или прав администратора) — иначе бот просто не видит сообщений. Chat ID пустой = чат текущего запуска. Выходы: Messages (для LLM), Records (сырые записи с message_id/file_id) и Transcript (текст).
Тип в графе: telegram_history
Exec
Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.
Как попробовать
Минимальный рабочий воркфлоу
- Исполнение
- Исполнение + данные
Запускается сразу
Как применять
Берите эту ноду, когда воркфлоу должен знать, что вообще происходило в группе, — включая сообщения, которые не запускали ни одного хода. Это не диалог с ботом: История чата отдаёт переписку ассистента с одним собеседником, а здесь — многоголосая лента группы или канала. Если нужен не «последние N сообщений», а поиск по слову, берите Поиск сообщений.
Как это работает
Bot API не умеет отдавать прошлые сообщения — метода «покажи переписку за вчера» не существует. Поэтому нода читает собственную запись платформы и в Telegram не ходит вовсе. Запись включается в панели публикации: «История группы → Записывать историю группы», и она выключена по умолчанию. Второе условие — privacy mode у бота: пока он включён, Telegram показывает боту только команды, ответы и упоминания, поэтому писать будет почти нечего. Подробности — в разделе про Telegram-канал.
У ноды три выхода. Messages — готовый массив для LLM-ноды: каждая строка подписана
автором, боты приходят ролью assistant, остальные — user. Records — сырые записи с
message_id, media_file_id, датой и автором. Transcript — тот же текст одной строкой.
Частые ошибки
- Пустой результат — не ошибка. Ран остаётся успешным. Причин обычно три: запись выключена, privacy mode включён, окно и фильтры отсекли всё. Начните с кнопки «Проверить бота» в панели публикации.
- Лимит считает от конца. При
Начало окна = 7dи лимите 50 вернутся последние 50 сообщений недели, а не первые. В выходе они идут от старых к новым. - Chat ID здесь только числовой.
@имя_каналане принимается (в отличие от ноды отправки). Пустое поле означает чат текущего хода, поэтому запуск из веб-чата, по расписанию или из API с пустым полем остановится. - В выходе Messages нет
file_id. Чтобы скачать вложение, беритеmedia_file_idс порта Records и передавайте в Получить файл. - Хранилище конечно. Это кольцевой буфер («Хранить сообщений на чат») плюс тарифный срок хранения — старое исчезает молча.
- Удалённое видно не всё. Сообщения, удалённые нодой Модерация, из выдачи пропадают. Удаления, сделанные человеком в самом Telegram, — нет: о них Bot API не сообщает.
Входы
—
Выходы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Messagesoutput | Исполнение + данныеexecute_data | messages | |
Recordsrows | Данныеdata | array | |
Transcripttranscript | Данныеdata | string | |
Erroron_error | Исполнение + данныеexecute_data | — | показывается, когда expose_error_output = true |
Настройки
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
Chat IDchat_id | string | "" | Telegram chat_id. Пусто — чат текущего запуска (для Telegram-триггера). Шаблоны поддерживаются. поддерживает шаблоны |
Лимитlimit | integer | 50 | Сколько последних сообщений вернуть (хронологически, старые сверху). |
Начало окнаsince | string | "" | Граница окна: ISO-дата (2026-07-01T00:00:00Z) или относительное окно от «сейчас» (30m, 24h, 7d). Пусто — без ограничения. поддерживает шаблоны |
ID темыthread_id | string | "" | Только сообщения этой темы форума (message_thread_id). Пусто — все. поддерживает шаблоны |
Конец окнаuntil | string | "" | Граница окна: ISO-дата (2026-07-01T00:00:00Z) или относительное окно от «сейчас» (30m, 24h, 7d). Пусто — без ограничения. поддерживает шаблоны |
Авторuser_id | string | "" | Только сообщения этого автора. Telegram user_id (число). Шаблоны поддерживаются. поддерживает шаблоны |
| Дополнительно | |||
Включать ботовinclude_bots | boolean | true | Включать сообщения ботов. |
Включать служебные событияinclude_service | boolean | false | Включать служебные события (вход/выход участников, смена названия). |
Общие поля
Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.
expose_error_output— Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.