Отправить статью в Telegram

Действие блок-схемы «Отправить статью в Telegram» отправляет пользователю сообщение с богатым оформлением: заголовками, списками, таблицами, цитатами, сворачиваемыми блоками, картинками и видео прямо в тексте, коллажами, каруселями, кнопками и формулами. Обычное сообщение Telegram так не умеет. Такие сообщения Telegram добавил для ботов в 2026 году.

Действие находится в каталоге действий блок-схемы, в группе «Чат», и работает только с ботами Telegram.

Когда использовать
Редактор статьи
Шпаргалка по разметке
Картинки, видео, коллажи и карусели
Кнопки
Отправка ответа ИИ
Опции
Ограничения
Результат и ошибки
Что делать, если…

Когда использовать

Прайс-лист, расписание, сравнение тарифов — таблицей.
Инструкция или памятка с заголовками, нумерованными шагами и сворачиваемыми блоками «Подробнее».
Карточка товара или анонс: карусель фотографий, описание, кнопка «Купить».
Ответ ИИ-ассистента: нейросети пишут ответы в разметке Markdown, и это действие показывает их красиво, а не со звёздочками и решётками.

Для коротких ответов и сообщений, которые должны работать во всех мессенджерах, используйте обычное действие «Отправить сообщение».

Редактор статьи

В панели блока показывается только предпросмотр статьи и счётчики. Чтобы написать или изменить статью, нажмите «Открыть редактор» или кликните по предпросмотру. Редактор откроется на весь экран.

Слева — текст статьи в разметке, справа — предпросмотр. Кнопка «Скрыть предпросмотр» отдаёт всю ширину под текст.
Markdown / HTML — формат разметки. По умолчанию Markdown, он проще. Текст при смене формата не преобразуется: если статья уже написана, после смены её придётся поправить вручную.
Панель вставки — кнопки «Заголовок», «Список», «Таблица», «Цитата», «Сворачиваемый блок», «Картинка», «Коллаж», «Карусель (слайдшоу)», «Кнопка-ссылка». В меню «Ещё» — «Нумерованный список», «Список задач», «Блок кода», «Разделитель», «Скрытый текст», «Видео», «Формула». Кнопка вставляет готовый образец в место курсора, останется заменить в нём текст и ссылки.
Вставка переменной — кнопка с иконкой кода. Переменные работают как в обычном сообщении, например {user:first_name}.
Счётчики внизу — сколько символов текста и медиафайлов в статье. Красным подсвечивается превышение лимита.
Изменения попадают в блок-схему только по кнопке «Сохранить». Если закрыть редактор с несохранёнными изменениями, он переспросит.

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

Ошибки разметки видно по предпросмотру. Полная справка по разметке — по ссылке «Справка по разметке» внизу редактора (на английском, сайт Telegram).

Шпаргалка по разметке

Что нужно	Markdown	HTML
Жирный	`текст`	`<b>текст</b>`
Курсив	`текст`	`<i>текст</i>`
Зачёркнутый	`~~текст~~`	`<s>текст</s>`
Подчёркнутый	`<u>текст</u>`	`<u>текст</u>`
Выделение маркером	`==текст==`	`<mark>текст</mark>`
Скрытый текст (спойлер)	`\|\|текст\|\|`	`<tg-spoiler>текст</tg-spoiler>`
Ссылка	`[текст](https://site.ru)`	`<a href="https://site.ru">текст</a>`
Заголовок (уровни 1–6)	`## Заголовок`	`<h2>Заголовок</h2>`
Список	`- пункт`	`<ul><li>пункт</li></ul>`
Нумерованный список	`1. пункт`	`<ol><li>пункт</li></ol>`
Список задач	`- [x] готово`, `- [ ] сделать`	`<li><input type="checkbox" checked>готово</li>`
Цитата	`> текст`	`<blockquote>текст</blockquote>`
Сворачиваемый блок	`<details><summary>Подробнее</summary>Скрытый текст</details>` (одинаково в обоих форматах)
Разделитель	`---`	`<hr/>`
Код	`код`, блок — между строками ```	`<code>код</code>`, `<pre>блок</pre>`
Формула	$x^2$ , блоком `$$E = mc^2$$`	`<tg-math-block>E = mc^2</tg-math-block>`

Таблица в Markdown — строки через вертикальную черту, вторая строка задаёт выравнивание колонок (:--- — влево, ---: — вправо, :---: — по центру):

| Тариф    | Цена      |
|:---------|----------:|
| Базовый  | 990 ₽     |
| Про      | 2 990 ₽   |

В ячейках таблицы можно использовать только оформление текста (жирный, ссылки и т. п.), без списков и картинок. В HTML-режиме у таблицы есть дополнительные настройки: рамки, полосы, объединение ячеек, подпись. Они описаны в справке Telegram.

Картинки, видео, коллажи и карусели

Картинка, видео, GIF, аудио или документ вставляются отдельной строкой: ![](https://site.ru/photo.jpg "Подпись"). Подпись в кавычках необязательна. Тип файла Telegram определяет сам по ссылке.
Ссылка должна быть публичной и начинаться с http:// или https://: Telegram сам скачивает файл. Удобно загрузить файл в раздел «Файловое хранилище» и взять ссылку оттуда.
Коллаж — несколько фото и видео сеткой. Карусель — листаемая лента. В Markdown картинки перечисляются между тегами, каждая с новой строки:

<tg-slideshow>
![](https://site.ru/1.jpg)
![](https://site.ru/2.jpg)
![](https://site.ru/3.jpg)
</tg-slideshow>

Для коллажа вместо tg-slideshow напишите tg-collage. Ссылки на картинки можно подставлять переменными.

Кнопки

Кнопки можно добавить двумя способами.

Клавиатура бота — включите в «Опциях» галочку «Включить клавиатуру бота» и добавьте кнопки как в обычном сообщении. Только такие кнопки можно соединить с другими блоками блок-схемы: нажатие запускает продолжение схемы.
Кнопки внутри статьи — «Кнопка-ссылка» в редакторе. Их можно поставить в любое место текста, но в блок-схеме у них нет выходов. Используйте их для ссылок: <tg-button type="url" url="https://site.ru">Открыть</tg-button>. Цвет кнопки задаётся атрибутом style: success — зелёная, danger — красная, primary — синяя.

Отправка ответа ИИ

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

В ИИ-действии включите сохранение результата в переменную.
Добавьте после него действие «Отправить статью в Telegram».
В редакторе оставьте формат Markdown и вставьте в текст переменную с ответом ИИ. Можно добавить свой текст до и после неё.

Если ответ ИИ может оказаться пустым, включите в «Опциях» «Пустое сообщение - НЕ ошибка», чтобы блок-схема не останавливалась.

Опции

Кнопка «Опции» под предпросмотром открывает дополнительные настройки.

Поле	Зачем
«Включить клавиатуру бота»	Добавляет кнопки под статьёй. Кнопки соединяются с блоками блок-схемы, как в обычном сообщении.
«Создать массив клавиатуры из переменных»	Клавиатура задаётся JSON-массивом, например из переменной.
«Не распознавать ссылки, хэштеги и упоминания»	По умолчанию Telegram сам превращает в ссылки адреса сайтов, почту, @username, #хэштеги и телефоны. Галочка это отключает.
«Пустое сообщение - НЕ ошибка»	Если статья состоит из переменных и они оказались пустыми, блок-схема пропустит отправку и продолжит работу вместо остановки с ошибкой. Включено по умолчанию.
«Ответить на сообщение»	Статья придёт ответом на сообщение с указанным ID, по умолчанию `{var:object.id}` — сообщение, которое запустило схему.
«Отвечать внутри ветки форума»	Отправка в ветку (топик) группы. ID ветки — в поле «ID ветки форума», для текущей ветки `{var:object.topic.id}`.
«Запретить пересылку и скачивание»	Статью нельзя будет переслать или сохранить.
«Отправить без звука»	Уведомление придёт без звука.

Ограничения

До 32 768 символов текста. Это в 8 раз больше, чем у обычного сообщения.
До 50 медиафайлов, до 500 блоков (абзацы, пункты списков, строки таблиц и т. д.), до 20 колонок в таблице, до 16 уровней вложенности.
Только Telegram. Если контакт пришёл из ВКонтакте, Max или другого мессенджера, действие завершится ошибкой. Разделите ветки блок-схемы по мессенджеру или используйте «Отправить сообщение».
Значения переменных вставляются в разметку как есть. Если в значении есть символы разметки (например < в режиме HTML или * в Markdown), оформление может сбиться. Для текстов из переменных лучше выбирать Markdown.
В разделе «Диалоги» статья пока показывается исходным текстом с разметкой, а не так, как её видит клиент.
Изменить отправленную статью действием «Редактировать сообщение» пока нельзя.

Результат и ошибки

ID отправленного сообщения сохраняется в {var:effect.message.id}. Его можно использовать, например, чтобы потом удалить или закрепить статью другими действиями.

Ошибки (текст доступен в {var:error.message}):

Message content is empty — статья пустая (например, переменные оказались пустыми). Без галочки «Пустое сообщение - НЕ ошибка» схема останавливается.
Chat ID is empty — не удалось определить, кому отправлять: у контакта нет Telegram.
Integration with type [...] does not support this effect — контакт не из Telegram.
Ошибки с текстом от Telegram (начинаются с Bad Request) — Telegram не принял статью: ошибка в разметке, недоступная ссылка на файл, превышен лимит.

Что делать, если…

Симптом	Причина и что сделать
Клиент видит звёздочки, решётки и вертикальные черты	Выбран не тот формат: Markdown-текст отправлен как HTML. Переключите формат в редакторе на «Markdown».
Ошибка `Bad Request` с упоминанием разметки (parse, tag, entity)	В тексте незакрытый тег или лишний символ. Проверьте предпросмотр и последние изменения. Частая причина — символ `<` или `&` в режиме HTML: замените на `<` и `&`.
Картинка не пришла или ошибка про файл	Ссылка закрыта, ведёт на страницу, а не на сам файл, или файл слишком большой. Откройте ссылку в режиме инкогнито — должен открыться сам файл. Надёжнее всего брать ссылку из «Файлового хранилища».
Кнопку внутри статьи нельзя соединить с блоком	Так и задумано: соединяются только кнопки клавиатуры бота. Включите «Включить клавиатуру бота» в «Опциях».
Действие падает с ошибкой у части пользователей	Эти пользователи пришли не из Telegram. Добавьте перед действием условие по мессенджеру.
В Telegram статья выглядит не так, как в предпросмотре	Предпросмотр приблизительный. Ориентируйтесь на то, что приходит в Telegram: отправьте статью себе и проверьте.