Telegram Bot API

Công cụ escape MarkdownV2 và HTML cho Telegram

Dán bất kỳ văn bản nào để escape cho parse mode MarkdownV2 hoặc HTML của Telegram, để sendMessage không còn lỗi Bad Request: can't parse entities.

MarkdownV2 yêu cầu escape _ * [ ] ( ) ~ ` > # + - = | { } . ! bằng dấu gạch chéo ngược; trong code và pre chỉ ` và \; trong phần (…) của link chỉ ) và \. HTML yêu cầu < > &.

Thử ngay: gửi tới chat

Token chỉ lưu trong trình duyệt của bạn (localStorage) và chỉ được gửi tới api.telegram.org.

Cách escape Markdown cho bot Telegram

  1. Dán văn bản nguyên gốc — tên người dùng, giá tiền, một dòng log. Đừng dán các ký hiệu định dạng của bạn: hãy escape dữ liệu, rồi tự bọc nó trong *bold* hoặc <b>.
  2. Chọn chế độ: MarkdownV2 văn bản thường, MarkdownV2 trong code/pre, MarkdownV2 trong phần (…) của link, hoặc HTML. Kết quả cập nhật ngay khi bạn gõ.
  3. Bấm Sao chép, hoặc Dạng chuỗi JSON để lấy giá trị có dấu ngoặc kép và dấu gạch chéo ngược được nhân đôi — sẵn sàng cho body JSON hoặc mã nguồn.
  4. Tùy chọn: mở Thử ngay, nhập token của bot và chat_id rồi gửi kết quả bằng sendMessage với parse_mode tương ứng. Ở chế độ code, văn bản được bọc trong dấu backtick; ở chế độ link, nó trở thành URL của [link](…).

Quy tắc escape MarkdownV2 của Telegram

Các quy tắc lấy từ tùy chọn định dạng của Bot API:

Ví dụ: Price: 5.99 (incl. tax) - order #42! trở thành:

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

Dấu chấm và dấu chấm than là những bất ngờ kinh điển: quên một ký tự là cả request thất bại.

Parse mode HTML của Telegram

Ở chế độ HTML, mọi ký tự <, > và & không thuộc thẻ hay entity phải được viết thành &lt;, &gt; và &amp;. Công cụ thay đúng ba ký tự này. Vì quy tắc rất ngắn, HTML thường là lựa chọn an toàn hơn cho văn bản động. Danh sách thẻ được hỗ trợ có trong /vi/guides/telegram-bot-send-message.html.

Quyền riêng tư

Việc escape chạy hoàn toàn trong trình duyệt — không có request nào được gửi đi. Chỉ phần thử nghiệm tùy chọn gửi một request sendMessage, đi thẳng từ trình duyệt của bạn tới api.telegram.org; token được giữ trong localStorage và không bao giờ đến server của chúng tôi. Bạn cũng có thể tạo request trong /vi/telegram-bot-api-tester.html#sendMessage. Các thông báo lỗi khác được giải thích trong /vi/guides/telegram-bot-api-errors.html.

Câu hỏi thường gặp

Những ký tự nào phải escape trong MarkdownV2 của Telegram?

Trong văn bản thường: _ * [ ] ( ) ~ ` > # + - = | { } . !, mỗi ký tự có một dấu gạch chéo ngược phía trước (bản thân dấu gạch chéo ngược cũng phải escape). Trong code và pre chỉ ` và \; trong phần (…) của link chỉ ) và \.

Vì sao sendMessage lỗi "can't parse entities"?

Văn bản chứa một ký tự dành riêng chưa được escape, hoặc một entity chưa được đóng. Thông báo lỗi của Telegram thường nêu rõ ký tự đó. Hãy escape các phần động của văn bản và chỉ để nguyên các ký hiệu định dạng của chính bạn.

Nên dùng MarkdownV2 hay HTML?

Với văn bản đến từ người dùng hoặc cơ sở dữ liệu, HTML thường dễ hơn: chỉ cần thay <, > và &. MarkdownV2 cần escape 18 ký tự.

Có cần escape văn bản trong khối code không?

Trong MarkdownV2, chỉ ` và \ bên trong code và pre. Hãy chọn chế độ tương ứng trong công cụ. Ở chế độ HTML, vẫn là ba ký tự như mọi nơi khác.

Tiện ích khác

Công cụ tìm chat IDCông cụ xác thực initData của Mini AppCông cụ kiểm tra webhookBot API Tester