Все ноды/Integrations/Telegram

Поиск сообщений Telegram

Ищет по записанным сообщениям Telegram-чатов (полнотекстовый поиск на PostgreSQL, подстрока на SQLite). Ищет ТОЛЬКО по тому, что бот наблюдал — у Bot API нет поиска по истории. Chat ID пустой = поиск по всем наблюдаемым чатам workspace. Возвращает совпадения с message_id, автором и датой (самые свежие первыми).

Поиск сообщений Telegram
Matches
Transcript
Error

Тип в графе: telegram_search

Exec

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

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

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

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

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

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

Эта нода отвечает на вопрос «где у нас говорили про X». Если вопрос звучит как «что было в чате за последний час», берите Историю группы — там окно и фильтры, здесь ключевое слово. Обе читают одну и ту же запись платформы, поэтому условия одинаковые: включённая запись истории в панели публикации и отключённый privacy mode у бота (см. Telegram-канал).

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

Поиска по переписке у Bot API нет вообще, поэтому нода ищет по сообщениям, которые бот успел записать. На PostgreSQL это полнотекстовый поиск с конфигурацией simple — она намеренно без морфологии, потому что корпус смешанный, русский и английский. На SQLite (локальная разработка) поиск вырождается в подстроку.

«Область поиска» решает, где искать: только текущий чат (или тот, что указан в Chat ID) либо все чаты рабочего пространства, которые наблюдал бот. Второй режим игнорирует Chat ID и выбирается осознанно — это чтение поперёк чатов. Совпадения возвращаются от новых к старым на выходе Matches, а рядом есть готовый Transcript.

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

  • Словоформы не совпадают. Без морфологии «заказы» не найдут «заказ», а «работал» — «работать». Ищите по основе слова или по точной форме, которая встречается в переписке.
  • Пустой запрос — это ноль совпадений, а не ошибка. Шаблон, отрендерившийся в пустую строку, тихо вернёт пустой список: ран останется зелёным.
  • Ищется только записанное. Сообщения до включения записи, сообщения из чатов, где бота нет, и всё, что вытеснил кольцевой буфер, не найдутся никогда.
  • Chat ID только числовой и учитывается лишь в режиме «Только этот чат». Пустое поле в этом режиме означает чат текущего хода, поэтому запуск из веб-чата или по расписанию остановится.
  • Основной выход Matches — массив записей, а не Messages. Подключать его напрямую во вход LLM-ноды не стоит: для модели удобнее Transcript.
  • Удалённые сообщения исключаются. Речь про удаления, о которых платформа знает: те, что сделала нода Модерация.

Входы

Выходы

ПортПроводДанныеПримечания
MatchesoutputИсполнение + данныеexecute_dataarray
TranscripttranscriptДанныеdatastring
Erroron_errorИсполнение + данныеexecute_data

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

Настройки

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

Ограничить поиск одним чатом. Пусто — по всем наблюдаемым чатам workspace.

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

показывается при chat_scope = current

Область поискаchat_scopestringcurrent

current — искать в одном чате: в указанном ниже Chat ID, а если он пуст — в чате текущего Telegram-хода. workspace — искать по всем чатам, которые наблюдал этот воркспейс, игнорируя Chat ID.

Варианты: current — Только этот чат, workspace — Все наблюдаемые чаты воркспейса

Лимитlimitinteger50

Максимум совпадений.

Запросquerystring""

Поисковый запрос по тексту сообщений. На PostgreSQL — полнотекстовый поиск (конфигурация 'simple', без стемминга — корпус смешанный RU/EN); на SQLite — подстрока.

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

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

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

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

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

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

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

Авторuser_idstring""

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

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

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

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

Общие поля

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

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