استارد / وبلاگ
وبلاگ

پیام‌های غنی (Rich Messages) در ربات‌های تلگرام: جدول، لیست و بلوک

ربات‌های تلگرام تا خرداد ۱۴۰۵ فقط متن قالب‌بندی‌شده‌ی ساده می‌فرستادند؛ حالا می‌توانند جدول، لیست، تیتر و دکمه را داخل خود پیام بفرستند. نمونه‌اش ربات گروه استارد است که قیمت لحظه‌ای استارز را به شکل جدول جواب می‌دهد و از آنجا مستقیم به خرید استارز تلگرام می‌رسی. این راهنما می‌گوید پیام غنی چیست و چطور ساخته می‌شود.

پاسخ کوتاه

پیام غنی (Rich Message) نوع تازه‌ای از پیام ربات است که در Bot API ۱۰.۱ (۱۱ ژوئن ۲۰۲۶) با متد sendRichMessage آمد. محتوا را با Markdown، HTML یا فهرستی از بلوک‌ها (blocks) می‌سازی و تلگرام آن را با تیتر، لیست، جدول، نقل‌قول، بخش جمع‌شونده، فرمول و رسانه نشان می‌دهد. در نسخه‌ی ۱۰.۲ بلوک‌ها و در ۱۰.۳ دکمه‌ی داخل پیام و جدول فشرده اضافه شدند. هر پیام غنی تا ۳۲٬۷۶۸ کاراکتر و ۵۰۰ بلوک دارد و هر جدول تا ۲۰ ستون.

آخرین به‌روزرسانی:

۰۱پیام غنی (Rich Message) در تلگرام چیست؟

پیام غنی پیامی است که ساختار دارد، نه فقط متن. طبق مستندات Bot API، پیام غنی از قالب‌های پیشرفته‌ای مثل تیتر، لیست، جدول، رسانه، نقل‌قول، بخش‌های جمع‌شونده، پانویس و فرمول پشتیبانی می‌کند و اپ‌های تلگرام آن را با همین ساختار نشان می‌دهند.

ربات پیام غنی را با متد sendRichMessage و یک شیء InputRichMessage می‌فرستد. در این شیء دقیقاً یکی از سه فیلد html، markdown یا blocks پر می‌شود. یعنی می‌توانی همان جدول Markdown آشنا (| ستون | ستون |) را بفرستی، یا هر بلوک را دقیق و جدا به شکل JSON بسازی.

تلگرام در وبلاگ رسمی ۱۱ ژوئن ۲۰۲۶ هم از «متن غنی برای ربات‌ها» گفت: جدول، نقل‌قول تودرتو، چک‌لیست، فرمول و پیام‌هایی تا ۳۲٬۷۶۸ کاراکتر که بعد از حدود ۸ هزار کاراکتر دکمه‌ی «نمایش بیشتر» می‌گیرند.

۰۲از Bot API ۱۰.۱ تا ۱۰.۳ چه چیزهایی اضافه شد؟

نسخه و تاریختغییر مهم در پیام غنی
۱۰.۱ — ۱۱ ژوئن ۲۰۲۶ (۲۱ خرداد ۱۴۰۵)معرفی RichMessage، متدهای sendRichMessage و sendRichMessageDraft، پارامتر rich_message در editMessageText و امکان استفاده در نتیجه‌های inline و مینی‌اپ
۱۰.۲ — ۱۴ ژوئیه ۲۰۲۶ (۲۳ تیر ۱۴۰۵)فیلد blocks و ده‌ها نوع InputRichBlock (پاراگراف، تیتر، جدول، نقشه، اسلایدشو و …)، و فیلد media برای رسانه‌های داخل Markdown و HTML
۱۰.۳ — ۲۴ اوت ۲۰۲۶ (۲ شهریور ۱۴۰۵)دکمه داخل پیام (RichBlockButtons و RichMessageButton)، فیلد is_compact برای جدول فشرده، نقل‌قول جمع‌شونده، بلوک فایل و ارسال پیام غنی به شکل ephemeral

۰۳جدول در پیام ربات تلگرام چطور ساخته می‌شود؟

بلوک جدول (InputRichBlockTable) یک فیلد اصلی دارد: cells، آرایه‌ای از ردیف‌ها که هر ردیف آرایه‌ای از سلول‌هاست. گزینه‌های اختیاری هم این‌ها هستند:

هر سلول می‌تواند is_header (سلول عنوان)، colspan و rowspan (ادغام ستون و ردیف) و تراز افقی align (left، center، right) و عمودی valign (top، middle، bottom) داشته باشد. نمونه‌ی یک جدول کوچک فارسی:

{
  "is_rtl": true,
  "blocks": [{
    "type": "table",
    "caption": "دستورهای ربات",
    "is_bordered": true,
    "is_compact": true,
    "cells": [
      [{"text": "دستور", "is_header": true, "align": "right", "valign": "middle"},
       {"text": "کاربرد", "is_header": true, "align": "right", "valign": "middle"}],
      [{"text": "/start", "align": "right", "valign": "middle"},
       {"text": "شروع", "align": "right", "valign": "middle"}]
    ]
  }]
}

این شیء را در پارامتر rich_message متد sendRichMessage می‌فرستی. اگر کتابخانه‌ی رباتت هنوز این متد را نمی‌شناسد، می‌توانی همان درخواست را مستقیم به آدرس Bot API بفرستی.

۰۴لیست، دکمه و بلوک‌های دیگر به چه کاری می‌آیند؟

محدودیت‌های رسمی هر پیام غنی: حداکثر ۳۲٬۷۶۸ کاراکتر، ۵۰۰ بلوک (با احتساب ردیف‌های جدول و آیتم‌های لیست)، ۱۶ سطح تودرتویی، ۵۰ رسانه و ۲۰ ستون در هر جدول.

۰۵ربات گروه استارد از پیام غنی چطور استفاده می‌کند؟

در گروه‌هایی که ربات استارد (@Stard_marketbot) عضو است، اگر کسی فقط بنویسد «دلار»، «استارز» یا «تون»، ربات قیمت لحظه‌ای را به شکل جدول بومی تلگرام جواب می‌دهد. با عدد هم کار می‌کند؛ مثلاً «۱۰۰ استارز» قیمت صد استارز را حساب می‌کند. «پریمیوم» و «قیمت گیفت‌ها» هم جواب جدولی دارند.

این جدول‌ها راست‌به‌چپ (is_rtl) و خط‌دارند، سلول عنوان دارند و ردیف آخرشان با colspan سراسری است. تشخیص خودکار لینک و منشن هم خاموش است (skip_entity_detection) تا عددها به لینک تبدیل نشوند. زیر جدول استارز و تون دکمه‌ی خرید هم هست و اگر تلگرام به هر دلیل پیام غنی را نپذیرد، ربات همان قیمت را با متن ساده می‌فرستد. قیمت لحظه‌ای همه‌ی محصولات را در صفحه‌ی قیمت‌ها هم می‌بینی.

۰۶پیام غنی برای کاربر و فروشگاه چه فرقی می‌کند؟

برای کاربر: اطلاعات مرتب‌تر و خواناتر است و یک پیام جای چند پیام پشت‌سرهم را می‌گیرد. طبق وبلاگ تلگرام (۲۵ اوت ۲۰۲۶)، اپ‌های قدیمی که قابلیت تازه را نشان نمی‌دهند، جایش یک پیام جایگزین با دکمه‌ی به‌روزرسانی نشان می‌دهند.

برای فروشگاه و توسعه‌دهنده چند نکته‌ی عملی:

اگر می‌خواهی رباتت را بدون سرور اجرا کنی، راهنمای Telegram Serverless را ببین.

منابع رسمی: Bot API: sendRichMessage · Bot API changelog · Telegram Blog، ۱۱ ژوئن ۲۰۲۶ · Telegram Blog، ۲۵ اوت ۲۰۲۶

۰۷سوالات متداول

پیام غنی از کدام نسخه‌ی Bot API آمد؟

از Bot API ۱۰.۱ در ۱۱ ژوئن ۲۰۲۶. بلوک‌ها در ۱۰.۲ (۱۴ ژوئیه) و دکمه‌ی داخل پیام و جدول فشرده در ۱۰.۳ (۲۴ اوت) اضافه شدند.

هر جدول حداکثر چند ستون دارد؟

حداکثر ۲۰ ستون. کل پیام هم حداکثر ۵۰۰ بلوک دارد و ردیف‌های جدول جزو همین شمارش‌اند.

برای جدول فارسی چه تنظیمی لازم است؟

فیلد is_rtl را در InputRichMessage روشن کن تا پیام راست‌به‌چپ نمایش داده شود.

کاربرانی که اپ قدیمی دارند جدول را می‌بینند؟

نه؛ طبق وبلاگ تلگرام، اپ قدیمی به‌جای قابلیت تازه یک پیام جایگزین با دکمه‌ی به‌روزرسانی نشان می‌دهد.

در گروه استارد چه کلمه‌هایی جواب جدولی دارند؟

«دلار»، «استارز» و «تون» (با یا بدون عدد)، و همین‌طور «پریمیوم» و «قیمت گیفت‌ها».

قیمت لحظه‌ای را در گروهت داشته باش

ربات استارد را به گروه اضافه کن تا «استارز»، «تون» و «دلار» را با جدول جواب بدهد.

ورود به ربات استارد