Все ноды/Integrations/Telegram

История группы Telegram

Читает записанную историю Telegram-чата: сообщения, которые бот наблюдал в группе/канале, включая те, что не запускали воркфлоу. Требует включённой галки «Записывать историю группы» в деплое И отключённого privacy mode у бота (или прав администратора) — иначе бот просто не видит сообщений. Chat ID пустой = чат текущего запуска. Выходы: Messages (для LLM), Records (сырые записи с message_id/file_id) и Transcript (текст).

История группы Telegram
Messages
Records
Transcript
Error

Тип в графе: telegram_history

Exec

Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.

Как попробовать

Минимальный рабочий воркфлоу

Вход
История группы Telegram
Выход
  • Исполнение
  • Исполнение + данные
Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Запускается сразу

Как применять

Берите эту ноду, когда воркфлоу должен знать, что вообще происходило в группе, — включая сообщения, которые не запускали ни одного хода. Это не диалог с ботом: История чата отдаёт переписку ассистента с одним собеседником, а здесь — многоголосая лента группы или канала. Если нужен не «последние 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_datamessages
RecordsrowsДанныеdataarray
TranscripttranscriptДанныеdatastring
Erroron_errorИсполнение + данныеexecute_data

показывается, когда expose_error_output = true

Настройки

ПолеТипПо умолчаниюОписание
Chat IDchat_idstring""

Telegram chat_id. Пусто — чат текущего запуска (для Telegram-триггера). Шаблоны поддерживаются.

поддерживает шаблоны

Лимитlimitinteger50

Сколько последних сообщений вернуть (хронологически, старые сверху).

Начало окнаsincestring""

Граница окна: ISO-дата (2026-07-01T00:00:00Z) или относительное окно от «сейчас» (30m, 24h, 7d). Пусто — без ограничения.

поддерживает шаблоны

ID темыthread_idstring""

Только сообщения этой темы форума (message_thread_id). Пусто — все.

поддерживает шаблоны

Конец окнаuntilstring""

Граница окна: ISO-дата (2026-07-01T00:00:00Z) или относительное окно от «сейчас» (30m, 24h, 7d). Пусто — без ограничения.

поддерживает шаблоны

Авторuser_idstring""

Только сообщения этого автора. Telegram user_id (число). Шаблоны поддерживаются.

поддерживает шаблоны

Дополнительно
Включать ботовinclude_botsbooleantrue

Включать сообщения ботов.

Включать служебные событияinclude_servicebooleanfalse

Включать служебные события (вход/выход участников, смена названия).

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

  • expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.