Все ноды/Integrations/Telegram

Telegram: история чата

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

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

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

Берите эту ноду, когда сценарий должен знать, что вообще происходило в группе, — включая сообщения, которые не запускали ни одного хода. Это не диалог с ботом: История чата отдаёт переписку ассистента с одним собеседником, а здесь — многоголосая лента группы или канала. Если нужен не «последние N сообщений», а поиск по слову, берите Поиск сообщений. За сообщением, которое запустило сценарий, сюда ходить не нужно: оно — вместе с голосовым, фото или документом — приходит на выход «Сообщение» Входа.

Как это работает

Bot API не умеет отдавать прошлые сообщения — метода «покажи переписку за вчера» не существует. Поэтому нода читает собственную запись платформы и в Telegram не ходит вовсе. Запись включается в панели публикации: «История группы → Записывать историю группы», и она выключена по умолчанию. Второе условие — privacy mode у бота: пока он включён, Telegram показывает боту только команды, ответы и упоминания, поэтому писать будет почти нечего. Подробности — в разделе про Telegram-канал.

У ноды три выхода. Сообщения — готовый массив для LLM-ноды: каждая строка подписана автором, боты приходят ролью assistant, остальные — user. Записи — сырые записи с message_id, media_file_id, датой и автором. Расшифровка — тот же текст одной строкой.

Частые ошибки

• Пустой результат — не ошибка. Ран остаётся успешным. Причин обычно три: запись выключена, privacy mode включён, окно и фильтры отсекли всё. Начните с кнопки «Проверить бота» в панели публикации.
• Лимит считает от конца. При Начало окна = 7d и лимите 50 вернутся последние 50 сообщений недели, а не первые. В выходе они идут от старых к новым.
• Chat ID здесь только числовой. @имя_канала не принимается (в отличие от ноды отправки). Пустое поле означает чат текущего хода, поэтому запуск из веб-чата, по расписанию или из API с пустым полем остановится.
• В выходе «Сообщения» нет file_id. Чтобы скачать вложение, берите media_file_id с порта «Записи» и передавайте в Получить файл.
• Хранилище конечно. Это кольцевой буфер («Хранить сообщений на чат») плюс тарифный срок хранения — старое исчезает молча.
• Удалённое видно не всё. Сообщения, удалённые нодой Модерация, из выдачи пропадают. Удаления, сделанные человеком в самом Telegram, — нет: о них Bot API не сообщает.

Входы

—

Выходы

Настройки