Tin tức

Telegram Bot API 10.3: tin nhắn ephemeral đổi tham số gửi

Bản 10.3 thay hai tham số của tin ephemeral bằng một đối tượng mới và cho người dùng dừng bot đang soạn câu trả lời. Mã viết theo 10.2 cần sửa.

Đỗ Phạm Nguyên

Telegram Bot API 10.3: tin nhắn ephemeral đổi tham số gửi

Telegram phát hành Bot API 10.3 ngày 24/8/2026. Bản này sửa lại cách gửi tin nhắn ephemeral (tin chỉ một người nhìn thấy trong nhóm), vừa được giới thiệu ở bản 10.2 hồi tháng 7. Ai đã viết bot theo 10.2 cần cập nhật lời gọi gửi tin. Changelog Bot API của Telegram

Bài được AI hỗ trợ soạn thảo; xem mục "Cách bài này được tạo" ở cuối bài.

Điện thoại 3D nổi với các bong bóng chat và biểu tượng trái tim, minh họa ứng dụng nhắn tin
Ảnh: Omar:. Lopez-Rincon (@procopiopi) / Unsplash (Unsplash License). Ảnh minh họa khái niệm, không liên quan đến một sự kiện cụ thể.

Điểm mới trong bản 10.3

Bản 10.2 (14/7/2026) cho bot gửi tin trong nhóm và nhận lệnh mà chỉ một người dùng cụ thể và bot nhìn thấy, theo changelog Bot API của Telegram. Lúc đó 13 phương thức gửi tin nhận thêm hai tham số `receiver_user_id` và `callback_query_id`.

Bản 10.3 gộp hai tham số này vào một đối tượng mới là `EphemeralMessageParameters`, nằm trong tham số `ephemeral_message_parameters`, theo changelog Bot API của Telegram. Đối tượng này có thêm trường `replace_callback_query_message`, cho bot hiện tin ephemeral thay cho tin gốc.

Nội dungBot API 10.2 (14/7/2026)Bot API 10.3 (24/8/2026)
Cách chỉ định người nhận tin ephemeralHai tham số `receiver_user_id` và `callback_query_id` trên 13 phương thức gửiMột tham số `ephemeral_message_parameters` kiểu `EphemeralMessageParameters`
Thay tin gốc bằng tin ephemeralChưa cóTrường `replace_callback_query_message`
Sửa tin ephemeral`editEphemeralMessageText`, `editEphemeralMessageMedia`, `editEphemeralMessageCaption`, `editEphemeralMessageReplyMarkup`, `deleteEphemeralMessage``editEphemeralMessageMedia` hỗ trợ tải tệp mới; thêm `show_caption_above_media` và `rich_message` cho phần sửa chú thích và văn bản

Bản 10.3 còn thêm `can_stop` và `keep_on_stop` cho `sendMessageDraft` và `sendRichMessageDraft`, cùng bản cập nhật `MessageGenerationStopped` khi người dùng dừng việc sinh tin, theo changelog Bot API của Telegram. Hai phương thức draft này phục vụ việc phát từng phần câu trả lời do AI sinh ra và được giới thiệu từ bản 10.1 ngày 11/6/2026, theo cùng changelog Bot API của Telegram.

Ý nghĩa với người làm bot chăm sóc khách hàng

Nhận định của người soạn: tin ephemeral phù hợp với tình huống bot hoạt động trong nhóm cộng đồng hoặc nhóm khách hàng và cần trả lời thông tin riêng cho một người, chẳng hạn trạng thái đơn hàng, mà không để cả nhóm thấy. Changelog chỉ mô tả tính năng, không nói về trường hợp sử dụng này.

Với mã đã viết theo 10.2, changelog không gắn nhãn thay đổi này là phá vỡ tương thích, nhưng hai tham số cũ đã bị thay bằng tham số mới. Nếu bot của bạn dùng `receiver_user_id` hoặc `callback_query_id`, hãy kiểm tra lại các lời gọi gửi tin và đối chiếu với tài liệu Bot API hiện hành trước khi chạy.

Với bot dùng AI trả lời, `MessageGenerationStopped` cho bot biết khách đã dừng việc sinh câu trả lời. Việc bot xử lý tin dang dở ra sao là thiết kế của từng bot. Changelog nêu `keep_on_stop` như một tham số mới của hai phương thức draft nhưng không giải thích chi tiết; hãy đọc tài liệu phương thức trước khi dựa vào nó.

Nên làm tiếp: mở changelog Bot API, đối chiếu phiên bản thư viện bot đang dùng với 10.3, và theo dõi các bản phát hành sau.

Cách bài này được tạo: bài được AI hỗ trợ tìm nguồn và soạn thảo từ nguồn nêu bên dưới, và do Đỗ Phạm Nguyên biên tập.

Nguồn tham khảo

  • Changelog Bot API của Telegram: https://core.telegram.org/bots/api-changelog