Повідомлення в Telegram

Надсилає повідомлення та вкладення через бота.

Призначення

Повідомляє користувачів або групи Telegram про результат потоку, погодження чи інші події. Текст і адресат можуть бути сталими або формуватися за полями таблиці.

Входи та виходи

Отримувач із in та success/failure; доставку виконує налаштований бот під час запису.

Параметри

Параметр	Налаштування та значення	Варіанти й межі
`role`	Роль блоку: джерело читає дані, отримувач записує результат.	Типово: `target`
`connection_id`	Збережене підключення, через яке блок звертається до системи.	Типово: `порожньо` До 64 символів
`recipient_type`	Тип адресата: private, group або auto для сумісної автоматичної інтерпретації.	Варіанти: `auto`, `private`, `group` Типово: `auto`
`chats`	Ідентифікатори чатів або шаблон, який формує адресата з даних.	Типово: `порожньо` До 4000 символів
`text`	Текст повідомлення; до 4096 символів у конфігурації.	Типово: `порожньо` До 4096 символів
`parse_mode`	none для звичайного тексту або html для підтримуваного форматування.	Варіанти: `none`, `html` Типово: `none`
`silent`	Надіслати без звукового сповіщення.	Типово: `вимкнено`
`attachments`	Вкладення з Менеджера файлів, папки або поля «Вкладений файл» параметрів запуску.	Кількість: 0–10
`time_zone`	Часовий пояс системних підстановок дати та часу.	Типово: `Europe/Kyiv` До 64 символів

Шаблони та кількість повідомлень

Підстановка {{Назва поля}} бере значення поточного рядка. Системні теги: {{$date}}, {{$time}}, {{$datetime}}, {{$flow}}, {{$rows}}, {{$row}}, {{$table}}.

Якщо хоча б один шаблон одержувача, теми або тексту містить поле рядка чи {{$row}}, формується окреме повідомлення для кожного рядка. Інакше — одне для всього входу.
{{$table}} доступний лише в тексті повідомлення. Включає до 1000 рядків та позначку про решту.
Усі поля в тегах мають існувати на вході; помилка TEMPLATE_FIELD_MISSING виявляється під час підготовки.
Дата й час використовують заданий time_zone. Значення даних екрануються для форматованого повідомлення.

Покрокове налаштування

Створіть підключення бота та перевірте доступ до потрібного адресата.
Оберіть тип адресата й чат у доступному інтерфейсі або задайте підтримуваний ідентифікатор.
Напишіть повідомлення й вставте теги. Перевірте, скільки повідомлень буде сформовано.
За потреби додайте вкладення й silent; задайте часовий пояс.
Перевірте форматування й підготовку, після чого запускайте доставку.

Правила та діагностика

Бот має бути доступний адресату та мати потрібні права в групі; сам блок не створює ці дозволи.
До 10 джерел вкладень. Дублікати джерел заборонені.
HTML має відповідати дозволеному піднабору Telegram; некоректні/незакриті теги дають TELEGRAM_MARKUP. Редактор допомагає формувати підтримуване оформлення.
Велика таблиця може створити багато частин повідомлення; для об’ємних даних зручніший файл-вкладення або короткий підсумок.
Після часткового надсилання перевіряйте журнал перед повтором, щоб уникнути дублювання.
Порожній активний вхід не формує повідомлення: EMPTY_STAGE. На один блок у запуску дозволено до 10000 повідомлень; для більшої кількості відфільтруйте або розділіть набір.
Втрата відповіді під час зовнішнього надсилання вважається невизначеним результатом: система не надсилає таке повідомлення повторно автоматично.
Текст після підстановок автоматично ділиться на частини до 4096 символів із підтримкою коректного HTML. Окремий файл — до 50 МБ; папкове вкладення додає до 20 файлів.

Приклад налаштування

Для одного сповіщення задайте сталий груповий чат і текст «Потік {{$flow}} завершено. Оброблено {{$rows}} рядків, {{$datetime}}». Полів рядка тут немає — формується один підсумок.