Telegram MarkdownV2 ve HTML Kaçışlayıcı
Herhangi bir metni yapıştırın ve Telegram MarkdownV2 veya HTML parse mode için kaçışlanmış halini alın; böylece sendMessage artık Bad Request: can't parse entities hatasıyla başarısız olmaz.
MarkdownV2'de _ * [ ] ( ) ~ ` > # + - = | { } . ! karakterleri ters eğik çizgiyle kaçışlanmalıdır; code ve pre içinde yalnızca ` ve \; bağlantının (…) kısmında yalnızca ) ve \. HTML'de < > & gerekir.
Test edin: sohbete gönderin
Token tarayıcınızda (localStorage) kalır ve yalnızca api.telegram.org adresine gönderilir.
Telegram botu için Markdown nasıl kaçışlanır
- Metni olduğu gibi yapıştırın — bir kullanıcı adı, bir fiyat, bir log satırı. Kendi biçimlendirme işaretlerinizi yapıştırmayın: veriyi kaçışlayın, ardından
*bold*veya<b>ile kendiniz sarın. - Modu seçin: MarkdownV2 düz metin,
code/preiçinde MarkdownV2, bağlantının (…) kısmında MarkdownV2 veya HTML. Sonuç siz yazdıkça güncellenir. - Kopyala düğmesine ya da değeri tırnak içinde ve ters eğik çizgileri ikilenmiş olarak almak için JSON metni olarak düğmesine basın — JSON gövdesi veya kaynak kod için hazır.
- İsteğe bağlı: Test edin bölümünü açın, bot token'ını ve bir
chat_idgirin ve sonucusendMessageve uygunparse_modeile gönderin. Kod modunda metin ters tırnaklarla sarılır, bağlantı modunda[link](…)içindeki URL olur.
Telegram MarkdownV2 kaçış kuralları
Kurallar Bot API biçimlendirme seçeneklerinden gelir:
- Normal metinde şu karakterlerin önüne
\gelmelidir:_ * [ ] ( ) ~ ` > # + - = | { } . !. Araç ters eğik çizginin kendisini de kaçışlar. prevecodevarlıklarının içinde yalnızca`ve\kaçışlanır.- Satır içi bağlantının veya özel emoji tanımının (…) kısmında yalnızca
)ve\kaçışlanır.
Örnek: Fiyat: 5.99 (KDV dahil) - sipariş #42! şuna dönüşür:
Fiyat: 5\.99 \(KDV dahil\) \- sipariş \#42\!
Nokta ve ünlem işareti klasik sürprizlerdir: birini unutursanız tüm istek başarısız olur.
Telegram HTML parse mode
HTML modunda bir etiketin veya varlığın parçası olmayan her <, > ve & karakteri <, > ve & olarak yazılmalıdır. Araç tam olarak bu üç karakteri değiştirir. Kural bu kadar kısa olduğu için HTML dinamik metinler için çoğu zaman daha güvenli seçimdir. Desteklenen etiketlerin listesi /tr/guides/telegram-bot-send-message.html rehberindedir.
Gizlilik
Kaçışlama tamamen tarayıcınızda çalışır — hiçbir istek yapılmaz. Yalnızca isteğe bağlı test, doğrudan tarayıcınızdan api.telegram.org adresine tek bir sendMessage isteği gönderir; token localStorage'da tutulur ve asla sunucumuza ulaşmaz. İsteği /tr/telegram-bot-api-tester.html#sendMessage içinde de oluşturabilirsiniz. Diğer hata metinleri /tr/guides/telegram-bot-api-errors.html rehberinde açıklanır.
Sık sorulan sorular
Telegram MarkdownV2'de hangi karakterler kaçışlanmalı?
Normal metinde: _ * [ ] ( ) ~ ` > # + - = | { } . !, her biri önüne ters eğik çizgi alarak (ters eğik çizginin kendisi de kaçışlanır). code ve pre içinde yalnızca ` ve \; bağlantının (…) kısmında yalnızca ) ve \.
sendMessage neden "can't parse entities" hatası veriyor?
Metin kaçışlanmamış ayrılmış bir karakter ya da kapatılmamış bir varlık içeriyor. Telegram'ın hata mesajı genellikle karakteri belirtir. Metnin dinamik kısımlarını kaçışlayın ve yalnızca kendi biçimlendirme işaretlerinizi kaçışsız bırakın.
MarkdownV2 mi kullanmalıyım, HTML mi?
Kullanıcılardan veya veritabanlarından gelen metin için HTML genellikle daha kolaydır: yalnızca <, > ve & değiştirilmelidir. MarkdownV2'de 18 karakterin kaçışlanması gerekir.
Kod bloklarının içindeki metni kaçışlamam gerekir mi?
MarkdownV2'de code ve pre içinde yalnızca ` ve \. Araçta uygun modu seçin. HTML modunda her yerdeki aynı üç karakter.
Diğer yardımcı araçlar
Chat ID bulucuMini App initData doğrulayıcıWebhook denetleyiciBot API Tester