۰۱پیام غنی (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_bordered: جدول خطدارis_striped: ردیفهای راهراهis_compact: فاصلهی کمتر داخل سلولها (از ۱۰.۳)، مناسب گوشیcaption: عنوان جدول
هر سلول میتواند 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 بفرستی.
۰۴لیست، دکمه و بلوکهای دیگر به چه کاری میآیند؟
- لیست (
list): مرتب یا نامرتب؛ هر آیتم میتواند چکباکس تیکخورده یا خالی داشته باشد که برای چکلیست سفارش یا مراحل کار مناسب است. - بخش جمعشونده (
details): خلاصهای که همیشه دیده میشود و جزئیاتی که با لمس باز میشود؛ مناسب شرایط و توضیحهای طولانی. - ردیف دکمه (
buttons، از ۱۰.۳): ۱ تا ۸ دکمه در یک ردیف، داخل متن پیام. هر دکمه میتواند لینک یا مینیاپ باز کند یا callback_data (۱ تا ۶۴ بایت) بفرستد و سبک danger، success، primary یا link بگیرد. - بلوکهای دیگر: تیتر در شش اندازه، کد، فرمول LaTeX، نقشه، اسلایدشو، عکس، ویدیو، صدا، فایل، جداکننده و پانویس.
محدودیتهای رسمی هر پیام غنی: حداکثر ۳۲٬۷۶۸ کاراکتر، ۵۰۰ بلوک (با احتساب ردیفهای جدول و آیتمهای لیست)، ۱۶ سطح تودرتویی، ۵۰ رسانه و ۲۰ ستون در هر جدول.
۰۵ربات گروه استارد از پیام غنی چطور استفاده میکند؟
در گروههایی که ربات استارد (@Stard_marketbot) عضو است، اگر کسی فقط بنویسد «دلار»، «استارز» یا «تون»، ربات قیمت لحظهای را به شکل جدول بومی تلگرام جواب میدهد. با عدد هم کار میکند؛ مثلاً «۱۰۰ استارز» قیمت صد استارز را حساب میکند. «پریمیوم» و «قیمت گیفتها» هم جواب جدولی دارند.
این جدولها راستبهچپ (is_rtl) و خطدارند، سلول عنوان دارند و ردیف آخرشان با colspan سراسری است. تشخیص خودکار لینک و منشن هم خاموش است (skip_entity_detection) تا عددها به لینک تبدیل نشوند. زیر جدول استارز و تون دکمهی خرید هم هست و اگر تلگرام به هر دلیل پیام غنی را نپذیرد، ربات همان قیمت را با متن ساده میفرستد. قیمت لحظهای همهی محصولات را در صفحهی قیمتها هم میبینی.
۰۶پیام غنی برای کاربر و فروشگاه چه فرقی میکند؟
برای کاربر: اطلاعات مرتبتر و خواناتر است و یک پیام جای چند پیام پشتسرهم را میگیرد. طبق وبلاگ تلگرام (۲۵ اوت ۲۰۲۶)، اپهای قدیمی که قابلیت تازه را نشان نمیدهند، جایش یک پیام جایگزین با دکمهی بهروزرسانی نشان میدهند.
برای فروشگاه و توسعهدهنده چند نکتهی عملی:
- برای متن فارسی
is_rtlرا روشن کن تا ترتیب ستونها و تراز درست باشد. - روی گوشی، جدول باریک (دو تا چهار ستون) با
is_compactبهتر خوانده میشود. - همیشه یک نسخهی متن ساده نگه دار تا اگر ارسال پیام غنی خطا داد، کاربر بیجواب نماند.
- اگر قیمت در جدول است، تاریخ یا زمان بهروزرسانی را هم بنویس.
اگر میخواهی رباتت را بدون سرور اجرا کنی، راهنمای Telegram Serverless را ببین.
منابع رسمی: Bot API: sendRichMessage · Bot API changelog · Telegram Blog، ۱۱ ژوئن ۲۰۲۶ · Telegram Blog، ۲۵ اوت ۲۰۲۶
۰۷سوالات متداول
پیام غنی از کدام نسخهی Bot API آمد؟
از Bot API ۱۰.۱ در ۱۱ ژوئن ۲۰۲۶. بلوکها در ۱۰.۲ (۱۴ ژوئیه) و دکمهی داخل پیام و جدول فشرده در ۱۰.۳ (۲۴ اوت) اضافه شدند.
هر جدول حداکثر چند ستون دارد؟
حداکثر ۲۰ ستون. کل پیام هم حداکثر ۵۰۰ بلوک دارد و ردیفهای جدول جزو همین شمارشاند.
برای جدول فارسی چه تنظیمی لازم است؟
فیلد is_rtl را در InputRichMessage روشن کن تا پیام راستبهچپ نمایش داده شود.
کاربرانی که اپ قدیمی دارند جدول را میبینند؟
نه؛ طبق وبلاگ تلگرام، اپ قدیمی بهجای قابلیت تازه یک پیام جایگزین با دکمهی بهروزرسانی نشان میدهد.
در گروه استارد چه کلمههایی جواب جدولی دارند؟
«دلار»، «استارز» و «تون» (با یا بدون عدد)، و همینطور «پریمیوم» و «قیمت گیفتها».