اسکیپ متن برای MarkdownV2 و HTML تلگرام
هر متنی را وارد کنید و نسخه اسکیپشده آن را برای parse mode تلگرام (MarkdownV2 یا HTML) بگیرید تا sendMessage دیگر با خطای Bad Request: can't parse entities شکست نخورد.
در MarkdownV2 باید _ * [ ] ( ) ~ ` > # + - = | { } . ! را با بکاسلش اسکیپ کرد؛ داخل code و pre فقط ` و \؛ داخل (…) لینک فقط ) و \. در HTML باید < > & را جایگزین کرد.
تست کنید: ارسال به چت
توکن در مرورگر شما (localStorage) میماند و فقط به api.telegram.org ارسال میشود.
چطور Markdown را برای ربات تلگرام اسکیپ کنیم
- متن خام را وارد کنید — یک نام کاربری، یک قیمت، یک خط لاگ. نشانههای قالببندی خودتان را وارد نکنید: داده را اسکیپ کنید و سپس خودتان آن را داخل
*bold*یا<b>بگذارید. - حالت را انتخاب کنید: MarkdownV2 متن ساده، MarkdownV2 داخل
code/pre، MarkdownV2 داخل (…) لینک، یا HTML. نتیجه همزمان با تایپ بهروز میشود. - کپی را بزنید، یا بهصورت رشته JSON را تا مقدار داخل کوتیشن و با بکاسلشهای دوبرابرشده بگیرید — آماده برای بدنه JSON یا کد منبع.
- اختیاری: بخش تست کنید را باز کنید، توکن ربات و یک
chat_idوارد کنید و نتیجه را باsendMessageوparse_modeمتناظر بفرستید. در حالت code متن داخل بکتیک قرار میگیرد و در حالت لینک به URL در[link](…)تبدیل میشود.
قوانین اسکیپ در MarkdownV2 تلگرام
قوانین از گزینههای قالببندی Bot API آمدهاند:
- در متن عادی قبل از این کاراکترها باید
\بیاید:_ * [ ] ( ) ~ ` > # + - = | { } . !. ابزار خود بکاسلش را هم اسکیپ میکند. - داخل entityهای
preوcodeفقط`و\اسکیپ میشوند. - داخل بخش (…) یک لینک inline یا تعریف custom emoji فقط
)و\اسکیپ میشوند.
مثال: Price: 5.99 (incl. tax) - order #42! تبدیل میشود به:
Price: 5\.99 \(incl\. tax\) \- order \#42\!
نقطه و علامت تعجب غافلگیریهای همیشگیاند: اگر یکی را فراموش کنید، کل درخواست شکست میخورد.
parse mode در حالت HTML تلگرام
در حالت HTML هر <، > و & که بخشی از تگ یا entity نیست باید به شکل <، > و & نوشته شود. ابزار دقیقاً همین سه کاراکتر را جایگزین میکند. چون این قانون بسیار کوتاه است، HTML اغلب انتخاب امنتری برای متن پویاست. فهرست تگهای پشتیبانیشده در /fa/guides/telegram-bot-send-message.html آمده است.
حریم خصوصی
اسکیپ کردن کاملاً در مرورگر شما انجام میشود — هیچ درخواستی ارسال نمیشود. فقط تست اختیاری یک درخواست sendMessage را مستقیماً از مرورگر شما به api.telegram.org میفرستد؛ توکن در localStorage نگه داشته میشود و هرگز به سرور ما نمیرسد. میتوانید درخواست را در /fa/telegram-bot-api-tester.html#sendMessage هم بسازید. متن خطاهای دیگر در /fa/guides/telegram-bot-api-errors.html توضیح داده شده است.
پرسشهای متداول
در MarkdownV2 تلگرام کدام کاراکترها باید اسکیپ شوند؟
در متن عادی: _ * [ ] ( ) ~ ` > # + - = | { } . !، هر کدام با یک بکاسلش قبل از آن (خود بکاسلش هم اسکیپ میشود). داخل code و pre فقط ` و \؛ داخل (…) لینک فقط ) و \.
چرا sendMessage با خطای "can't parse entities" شکست میخورد؟
متن یک کاراکتر رزروشده اسکیپنشده یا یک entity بستهنشده دارد. پیام خطای تلگرام معمولاً کاراکتر را مشخص میکند. بخشهای پویای متن را اسکیپ کنید و فقط نشانههای قالببندی خودتان را بدون اسکیپ نگه دارید.
از MarkdownV2 استفاده کنم یا HTML؟
برای متنی که از کاربران یا دیتابیس میآید، HTML معمولاً سادهتر است: فقط <، > و & باید جایگزین شوند. MarkdownV2 به اسکیپ 18 کاراکتر نیاز دارد.
آیا باید متن داخل بلوکهای کد را اسکیپ کنم؟
در MarkdownV2 داخل code و pre فقط ` و \. حالت مناسب را در ابزار انتخاب کنید. در حالت HTML همان سه کاراکتر همیشگی.
ابزارهای دیگر
یافتن چت آیدیاعتبارسنجی initData در Mini Appبررسی وب هوکBot API Tester