Как сделать Rich Post в PuzzleBot

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

Содержание:

Что такое Rich Post

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

Как сделать Rich Post: 10 шагов

Важно: файлы хранятся 60 дней

Если пост не пришёл

Полезные ссылки

Rich Post — это одно сообщение в Telegram-боте, которое выглядит как маленькая статья.

Обычное сообщение похоже на записку: текст, картинка, пара кнопок. Rich Post похож на страницу журнала: заголовки, фото, видео, списки и кнопки собраны в одном месте.

В документации Telegram этот формат называется Rich Message. Он появился в июне 2026 года. Rich Post то же самое, просто так проще говорить о готовой публикации.

Что можно собрать в одном посте

• заголовки и подзаголовки
• обычный текст, жирный и курсив
• списки и цитаты
• фото и видео
• карусели и коллажи
• таблицы и разделители
• кнопки

Где это пригодится

Rich Post особенно выручает, когда информации много, а дробить её на кучу сообщений не хочется.

• Урок: заголовок, объяснение, картинка, видео, пример и вывод.
• Инструкция: шаг, скриншот, следующий шаг, видео и важное примечание.
• Кейс: задача, решение, скриншоты и результат.
• Презентация продукта: описание, преимущества, фото, тарифы и кнопка.
• Выдача материалов: после оплаты человек получает не голую ссылку, а понятный материал прямо в боте.
• Знакомство с ботом: как им пользоваться, куда нажимать и что делать дальше.
• Экспертная статья: часть материала можно оставить в Telegram и не уводить читателя на другую страницу.

Что это даёт

• В цепочке становится меньше сообщений.
• Длинный материал легче читать.
• Текст, фото и видео идут одним цельным блоком.
• Несколько картинок можно показать каруселью.
• Главное проще выделить.

А вот для коротких фраз вроде «Оплата прошла, спасибо!» Rich Post не нужен. Здесь проще и быстрее обычное сообщение.

Rich Post не заменяет вашего бота. Это просто другой формат сообщения, который встраивается в уже готовую воронку PuzzleBot.

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

По шагам это выглядит так:

1. Пользователь нажимает кнопку в боте.
2. PuzzleBot запускает нужное действие.
3. Действие отправляет в Telegram заявку: что показать и кому.
4. Telegram показывает человеку готовый Rich Post.

Четыре слова, которые встретятся дальше

• API-запрос — та самая заявка. С её помощью один сервис просит другой что-то сделать.
• Токен — ключ от вашего бота. Его выдаёт @BotFather, и хранить его нужно как пароль: у кого токен, тот и управляет ботом.
• chat_id — адрес получателя, то есть ID пользователя в Telegram.
• JSON — форма заявки, в которой записано содержимое поста. Писать её самим не придётся.

Как работает бот-помощник

Чтобы собрать Rich Post вручную, пришлось бы изучать API Telegram и переделывать код под каждый материал. Поэтому я сделала бота-помощника: он берёт эту техническую часть на себя.

Вы присылаете готовую статью, а бот разбирает её на заголовки, текст и медиа. Затем он собирает код запроса в нужном формате и сразу подставляет ссылки на ваши файлы. Вам остаётся скопировать результат и вставить его в PuzzleBot.

Бот сделан только для подготовки таких статей. Рассылок и спама от него не будет.

Открыть видео в Kinescope

Шаг 1. Подготовьте статью

Соберите статью целиком: текст, картинки, гифки и видео, если они нужны. Она может быть опубликована в канале, в группе или в личных сообщениях.

Шаг 2. Запустите бота-помощника

Откройте бота @rich_post_lab_bot и запустите его. Личные данные и токены ему отправлять не нужно.

Шаг 3. Отправьте материал

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

Бот сообщит, что пост распознан, и покажет его структуру и количество блоков.

Шаг 4. Выберите PuzzleBot

Бот выдаст всё, что нужно для настройки:

• ссылку
• заголовки
• тело запроса в формате JSON, оно придёт отдельным файлом

Шаг 5. Создайте команду в PuzzleBot

У вас уже должен быть проект с подключённым Telegram-ботом.

1. Откройте проект и нажмите на плюс
2. Выберите обычную команду.
3. Придумайте название, например «Статья»

Шаг 6. Добавьте запрос и вставьте ссылку

1. Нажмите Добавить действие и в самом низу выберите Отправить запрос.
2. Укажите тип запроса POST.
3. Скопируйте ссылку из бота-помощника и вставьте её в настройки.
4. Вместо <TELEGRAM_BOT_TOKEN> поставьте токен из @BotFather. Это тот же токен, который вы указывали при подключении бота к проекту.

Слово bot перед токеном удалять нельзя. Ссылка должна выглядеть так:

https://api.telegram.org/bot123456:ABC-DEF/sendRichMessage

Шаг 7. Добавьте заголовок

1. Выберите вид запроса Произвольный.
2. Нажмите на галочку Добавить заголовок.
3. Скопируйте из бота-помощника ключ и вставьте его в настройки.
4. Так же скопируйте и вставьте значение.

Шаг 8. Вставьте тело запроса

Откройте файл от бота-помощника, скопируйте всё содержимое (Ctrl+A, затем Ctrl+C) и вставьте его в поле тела запроса (Ctrl+V).

Дальше всё зависит от того, куда должна прийти статья:

• Пользователю в бота: ничего менять не нужно, переменная пользователя уже подставлена.
• В подключённый канал или группу: вместо переменной вставьте ID этого канала или группы.

ID выглядит примерно так:

"chat_id": "-1001234567890"

Чтобы публиковать в канале или группе, бот должен быть туда добавлен и иметь право отправлять сообщения.

Шаг 9. Опубликуйте изменения

1. Нажмите на пустое поле, чтобы закрыть настройки.
2. Нажмите на стрелку слева.
3. Выберите Применить изменения.

Шаг 10. Запустите и проверьте

Скопируйте ссылку на команду и откройте её в Telegram. Статья должна прийти в том же виде, в каком вы отправили её боту-помощнику.

Проверьте, что:

• текст совпадает с исходным
• заголовки и выделения стоят на месте
• картинки перелистываются
• фото, гифки и видео открываются
• кнопки ведут куда нужно

Сначала проверьте всё на себе и только потом запускайте статью на подписчиков.

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

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

• Для рассылки этого обычно достаточно.
• Для статьи, которая должна приходить постоянно, нужно заменить ссылки. Например, если она стоит в воронке или выдаётся после оплаты.

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

Сначала посмотрите, что Telegram ответил на запрос. Для этого откройте в PuzzleBot раздел Модерация, выберите нужного пользователя и перейдите в События. В ответе на запрос будет указана причина ошибки.

Дальше проверяйте по порядку:

• Ошибка Unauthorized. Неверный токен или случайно удалено слово bot в ссылке.
• Ошибка chat not found. Неверная переменная или ID в chat_id, человек ещё не запускал бота, или бот не добавлен в канал или группу.
• Ошибка в тексте запроса. Скорее всего, что-то не докопировалось или случайно удалилась кавычка либо скобка. Заново скопируйте всё содержимое файла от бота-помощника и вставьте его в настройки.
• Не показывается фото или видео. Возможно, прошло больше 60 дней и файл удалён из хранилища. Если ссылка ваша, проверьте, что она открыта и ведёт на сам файл, а не на страницу.
• Пост выглядит не так, как ожидали. Обновите Telegram: такие сообщения отображаются в поддерживаемых версиях приложения.

• Что такое Rich Messages: обзор от Telegram
• Метод sendRichMessage в документации Telegram
• Демо-бот с примерами Rich Message
• Бот-помощник для настроек публикации Rich постов

Связаться со мной:
Telegram: @mahagonchar

Канал - портфолио: @mahagonchar_portfolio

Канал ПРО ЧАТ-БОТЫ https://t.me/maha_gonchar - полезные статьи, кейсы, разборы, всё о чат-ботах

Канал в МАХ https://max.ru/channel_mahagon