Telegram Bot API

Екранування MarkdownV2 і HTML для Telegram-бота

Вставте будь-який текст і отримайте його екранованим для Telegram MarkdownV2 або parse_mode HTML — щоб sendMessage більше не завершувався помилкою Bad Request: can't parse entities.

MarkdownV2 вимагає екранувати _ * [ ] ( ) ~ ` > # + - = | { } . ! зворотною скісною рискою; усередині code і pre — лише ` і \; усередині (…) посилання — лише ) і \. HTML вимагає < > &.

Перевірити: надіслати в чат

Токен залишається у вашому браузері (localStorage) і надсилається лише на api.telegram.org.

Як екранувати Markdown для Telegram-бота

  1. Вставте сам текст — ім’я користувача, ціну, рядок логу. Власну розмітку не вставляйте: екрануйте дані, а потім самі обгортайте їх у *bold* або <b>.
  2. Оберіть режим: MarkdownV2 — звичайний текст, MarkdownV2 — усередині code/pre, MarkdownV2 — усередині (…) посилання або HTML. Результат оновлюється під час введення.
  3. Натисніть Копіювати або Як рядок JSON — отримаєте значення в лапках із подвоєними зворотними скісними, готове для JSON-тіла запиту чи вихідного коду.
  4. За бажання відкрийте Перевірити, введіть токен бота й chat_id і надішліть результат через sendMessage з відповідним parse_mode. У режимі коду текст обгортається у зворотні лапки, у режимі посилання стає URL у [link](…).

Правила екранування MarkdownV2 у Telegram

Правила взято з офіційного опису форматування Bot API:

Приклад: Price: 5.99 (incl. tax) - order #42! перетворюється на:

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

Класичні пастки — крапка й знак оклику: пропустіть один — і весь запит поверне помилку.

parse_mode HTML у Telegram

У режимі HTML кожен <, > і &, що не є частиною тегу чи сутності, записують як &lt;, &gt; і &amp;. Інструмент замінює саме ці три символи. Правило коротке, тому для динамічного тексту HTML часто надійніший. Перелік підтримуваних тегів — у гайді /uk/guides/telegram-bot-send-message.html.

Конфіденційність

Екранування відбувається повністю в браузері, без жодних запитів. Лише необов’язкова перевірка надсилає один запит sendMessage — напряму з браузера на api.telegram.org; токен зберігається в localStorage і не потрапляє на наш сервер. Зібрати запит вручну можна в /uk/telegram-bot-api-tester.html#sendMessage. Інші тексти помилок розібрано в /uk/guides/telegram-bot-api-errors.html.

Поширені запитання

Які символи треба екранувати в Telegram MarkdownV2?

У звичайному тексті: _ * [ ] ( ) ~ ` > # + - = | { } . ! — зворотною скісною рискою перед кожним (саму зворотну скісну теж екрануємо). Усередині code і pre — лише ` і \; усередині (…) посилання — лише ) і \.

Чому sendMessage повертає «can't parse entities»?

У тексті є неекранований зарезервований символ або незакрита сутність. Зазвичай Telegram називає символ у тексті помилки. Екрануйте змінні частини тексту, а власну розмітку залишайте як є.

Що обрати: MarkdownV2 чи HTML?

Для тексту від користувачів або з бази даних зазвичай простіше HTML: замінювати треба лише <, > і &. У MarkdownV2 екранують 18 символів.

Чи треба екранувати текст усередині блоків коду?

У MarkdownV2 усередині code і pre — лише ` і \; оберіть відповідний режим в інструменті. В HTML — ті самі три символи, що й скрізь.

Інші утиліти

Пошук chat IDВалідатор initData Mini AppПеревірка вебхукаBot API Tester