Telegram Bot API

اسکیپ متن برای MarkdownV2 و HTML تلگرام

هر متنی را وارد کنید و نسخه اسکیپ‌شده آن را برای parse mode تلگرام (MarkdownV2 یا HTML) بگیرید تا sendMessage دیگر با خطای Bad Request: can't parse entities شکست نخورد.

در MarkdownV2 باید _ * [ ] ( ) ~ ` > # + - = | { } . ! را با بک‌اسلش اسکیپ کرد؛ داخل code و pre فقط ` و \؛ داخل (…) لینک فقط ) و \. در HTML باید < > & را جایگزین کرد.

تست کنید: ارسال به چت

توکن در مرورگر شما (localStorage) می‌ماند و فقط به api.telegram.org ارسال می‌شود.

چطور Markdown را برای ربات تلگرام اسکیپ کنیم

  1. متن خام را وارد کنید — یک نام کاربری، یک قیمت، یک خط لاگ. نشانه‌های قالب‌بندی خودتان را وارد نکنید: داده را اسکیپ کنید و سپس خودتان آن را داخل *bold* یا <b> بگذارید.
  2. حالت را انتخاب کنید: MarkdownV2 متن ساده، MarkdownV2 داخل code/pre، MarkdownV2 داخل (…) لینک، یا HTML. نتیجه هم‌زمان با تایپ به‌روز می‌شود.
  3. کپی را بزنید، یا به‌صورت رشته JSON را تا مقدار داخل کوتیشن و با بک‌اسلش‌های دوبرابرشده بگیرید — آماده برای بدنه JSON یا کد منبع.
  4. اختیاری: بخش تست کنید را باز کنید، توکن ربات و یک chat_id وارد کنید و نتیجه را با sendMessage و parse_mode متناظر بفرستید. در حالت code متن داخل بک‌تیک قرار می‌گیرد و در حالت لینک به URL در [link](…) تبدیل می‌شود.

قوانین اسکیپ در MarkdownV2 تلگرام

قوانین از گزینه‌های قالب‌بندی Bot API آمده‌اند:

مثال: Price: 5.99 (incl. tax) - order #42! تبدیل می‌شود به:

Price: 5\.99 \(incl\. tax\) \- order \#42\!

نقطه و علامت تعجب غافلگیری‌های همیشگی‌اند: اگر یکی را فراموش کنید، کل درخواست شکست می‌خورد.

parse mode در حالت HTML تلگرام

در حالت HTML هر <، > و & که بخشی از تگ یا entity نیست باید به شکل &lt;، &gt; و &amp; نوشته شود. ابزار دقیقاً همین سه کاراکتر را جایگزین می‌کند. چون این قانون بسیار کوتاه است، 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