Telegram Bot API

Escaper MarkdownV2 dan HTML untuk Telegram

Tempel teks apa saja dan dapatkan versi yang sudah di-escape untuk parse mode MarkdownV2 atau HTML Telegram, sehingga sendMessage tidak lagi gagal dengan Bad Request: can't parse entities.

MarkdownV2 mewajibkan escape _ * [ ] ( ) ~ ` > # + - = | { } . ! dengan backslash; di dalam code dan pre hanya ` dan \; di dalam (…) tautan hanya ) dan \. HTML mewajibkan < > &.

Uji coba: kirim ke chat

Token tetap di browser kamu (localStorage) dan hanya dikirim ke api.telegram.org.

Cara escape Markdown untuk bot Telegram

  1. Tempel teks apa adanya — nama pengguna, harga, baris log. Jangan tempel penanda format milikmu sendiri: escape datanya, lalu bungkus sendiri dengan *bold* atau <b>.
  2. Pilih mode: MarkdownV2 teks biasa, MarkdownV2 di dalam code/pre, MarkdownV2 di dalam (…) tautan, atau HTML. Hasilnya diperbarui saat kamu mengetik.
  3. Tekan Salin, atau Sebagai string JSON untuk mendapatkan nilai dalam tanda kutip dengan backslash digandakan — siap dipakai di body JSON atau kode sumber.
  4. Opsional: buka Uji coba, masukkan token bot dan chat_id, lalu kirim hasilnya dengan sendMessage dan parse_mode yang sesuai. Di mode code teks dibungkus backtick, di mode tautan teks menjadi URL dari [link](…).

Aturan escape MarkdownV2 Telegram

Aturannya berasal dari opsi format Bot API:

Contoh: Price: 5.99 (incl. tax) - order #42! menjadi:

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

Titik dan tanda seru adalah jebakan klasik: lupa satu saja, seluruh request gagal.

Parse mode HTML Telegram

Di mode HTML, setiap <, >, dan & yang bukan bagian dari tag atau entity harus ditulis sebagai &lt;, &gt;, dan &amp;. Alat ini mengganti tepat tiga karakter tersebut. Karena aturannya sesingkat itu, HTML sering menjadi pilihan yang lebih aman untuk teks dinamis. Daftar tag yang didukung ada di /id/guides/telegram-bot-send-message.html.

Privasi

Proses escape berjalan sepenuhnya di browser kamu — tidak ada request yang dikirim. Hanya uji coba opsional yang mengirim satu request sendMessage, langsung dari browser ke api.telegram.org; token disimpan di localStorage dan tidak pernah sampai ke server kami. Kamu juga bisa menyusun request di /id/telegram-bot-api-tester.html#sendMessage. Teks error lainnya dijelaskan di /id/guides/telegram-bot-api-errors.html.

Pertanyaan umum

Karakter apa saja yang harus di-escape di MarkdownV2 Telegram?

Di teks biasa: _ * [ ] ( ) ~ ` > # + - = | { } . !, masing-masing diawali backslash (backslash sendiri juga di-escape). Di dalam code dan pre hanya ` dan \; di dalam (…) tautan hanya ) dan \.

Kenapa sendMessage gagal dengan "can't parse entities"?

Teks berisi karakter khusus yang tidak di-escape, atau entity yang tidak ditutup. Pesan error Telegram biasanya menyebutkan karakternya. Escape bagian teks yang dinamis dan biarkan hanya penanda format milikmu sendiri tanpa escape.

Sebaiknya pakai MarkdownV2 atau HTML?

Untuk teks dari pengguna atau database, HTML biasanya lebih mudah: hanya <, >, dan & yang perlu diganti. MarkdownV2 butuh escape untuk 18 karakter.

Apakah teks di dalam blok kode perlu di-escape?

Di MarkdownV2 hanya ` dan \ di dalam code dan pre. Pilih mode yang sesuai di alat ini. Di mode HTML tetap tiga karakter yang sama seperti di tempat lain.

Utilitas lainnya

Pencari Chat IDValidator initData Mini AppPemeriksa webhookBot API Tester