Назначение
Уведомляет пользователей или группы Telegram о результатах потоков, согласованиях и других событиях. Текст и получатель могут быть постоянными или формироваться из полей таблицы.
Входы и выходы
Получатель с in и success/failure; настроенный бот доставляет сообщения во время записи.
Параметры
| Параметр | Настройки и значения | Варианты и ограничения |
|---|---|---|
role | Роль блока: источник читает данные; получатель записывает результат. | По умолчанию: target |
connection_id | Сохранённое подключение, через которое блок обращается к системе. | По умолчанию: emptyДо 64 символов |
recipient_type | Тип получателя: private, group или auto для совместимого автоматического определения. | Варианты: auto, private, groupПо умолчанию: auto |
chats | Идентификаторы чатов или шаблон, определяющий получателя из данных. | По умолчанию: emptyДо 4000 символов |
text | Текст сообщения; до 4096 символов в настройке. | По умолчанию: emptyДо 4096 символов |
parse_mode | none для обычного текста или html для поддерживаемого форматирования. | Варианты: none, htmlПо умолчанию: none |
silent | Отправлять без звукового уведомления. | По умолчанию: disabled |
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}}». Здесь нет полей строки, поэтому создаётся одна сводка.