Все ноды/Integrations/Telegram

Telegram: отправить сообщение

Отправляет сообщение в Telegram-чат. Использует бота, в которого задеплоен этот сценарий; поставьте «Источник подключения» = «Внешнее подключение», чтобы выбрать другого бота через порт «Подключение Telegram». Chat ID и текст задаются в конфиге (шаблоны поддерживаются); пустой Chat ID означает чат текущего Telegram-хода. Файлы, поданные на порт 'files', уходят после текста, каждый отдельным сообщением (документ/фото/аудио). Не отправить ни текста, ни файлов — ошибка, а не молчаливый no-op.

Telegram: отправить сообщение▶

Подключение TelegramИтог действия

ФайлыОшибка

Тип в графе: send_telegram_message

Exec

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

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

Минимальный рабочий сценарий

Вход

Telegram: отправить сообщение▶

Выход▶

Исполнение
Исполнение + данные

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

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

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

Берите эту ноду, когда сообщение должно уйти туда, куда не уходит собственный ответ запуска: в другой чат или канал, уведомлением из запуска по расписанию или по вебхуку, либо отдельным сообщением в дополнение к ответу.

В ходе, начатом из Telegram, ответ сценария и так возвращается в тот же чат: платформа показывает текст из ноды Выход по мере генерации и отправляет файлы, приложенные к нему. Если поставить сюда ещё и отправку того же текста, бот ответит дважды.

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

Chat ID и Сообщение — шаблонные поля, в них можно подставлять данные графа ({{ nodes.entry.output }}, {{ variables.chat }}). Пустой Chat ID означает чат текущего Telegram-хода; запуск из веб-чата, API или по расписанию с пустым полем останавливается — чат неоткуда вывести. Кроме числового id принимается @имя_канала, если бот там администратор.

Пустой «ID темы» означает ту же тему форума, из которой пришло сообщение. Если в Chat ID явно указан другой чат, сообщение уходит в корень того чата, а не в тему.

Файлы с порта files отправляются после текста, каждый отдельным сообщением; тип сообщения (фото, аудио или документ) выбирается по типу файла.

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

Длинный текст обрезается. Больше 4096 символов Telegram не принимает, поэтому лишнее отсекается и в конец добавляется многоточие. На несколько сообщений текст не разбивается — делите его сами.
Разметка не применяется. Нода отправляет простой текст. Настройка формата у Telegram-канала сценария относится к собственному ответу бота, а не к этой ноде, так что Markdown от модели приедет со звёздочками.
Пустая отправка — это ошибка. Ни текста, ни файлов — нода останавливается, а не «ничего не делает». Шаблон, отрендерившийся в пустую строку, уронит шаг.
Файлы доставляются best-effort. Файл, который не удалось прочитать или который отверг Telegram, пропускается с записью в журнал, а нода остаётся успешной. Отказ на отправке текста (бота выгнали из чата, заблокировали, не хватает прав) наоборот останавливает ноду.
Не тот бот. По умолчанию используется бот, в котором опубликован сценарий. Для другого бота переключите «Источник подключения» на «Внешнее подключение» и подключите Telegram-конфигурацию.

Входы

Порт	Провод	Данные	Примечания
Подключение Telegram`telegram_config`	Данные`data`	—	показывается, когда connection_source ≠ "auto"
Файлы`files`	Данные`data`	`file`	Вложения, которые уходят после текста — каждое отдельным сообщением.

Выходы

Порт	Провод	Данные	Примечания
Итог действия`output`	Исполнение + данные`execute_data`	`object`
Ошибка`on_error`	Исполнение + данные`execute_data`	—	показывается, когда expose_error_output = true

Настройки

Поле	Тип	По умолчанию	Описание
Источник подключения`connection_source`	`string`	`auto`	Откуда нода берёт подключение. «Из текущего запуска» использует то, что платформа уже знает (Telegram-бот, на который опубликован сценарий / собственное файловое хранилище этого пространства), и связей не требует. «Внешнее подключение» показывает ресурсный порт, чтобы в него можно было подключить конфиг-ноду. Варианты: `auto` — Из текущего запуска, `external` — Внешнее подключение (подключить конфиг-ноду)
Чат`chat_id`	`string`	`""`	Целевой чат: числовой chat_id или @channelusername. Поддерживаются шаблоны, напр. {{ nodes.entry.data.telegram.chat_id }}. Пусто = чат текущего Telegram-хода (запуск откуда-либо ещё тогда падает: чат неоткуда вывести). поддерживает шаблоны
Сообщение`text`	`string`	`""`	Текст сообщения (plain text, до 4096 символов; шаблоны поддерживаются). Необязателен, если на порт 'files' поданы вложения, — но одно из двух ноде нужно: не отправить вообще ничего это ошибка, а не no-op. поддерживает шаблоны
Дополнительно
ID темы`message_thread_id`	`string`	`""`	ID темы форума (message_thread_id): сообщение уйдёт в эту тему. Пусто — авто: та же тема, из которой пришёл вопрос (или корень чата). поддерживает шаблоны

Общие поля

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

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