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 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ể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 dung | Bot API 10.2 (14/7/2026) | Bot API 10.3 (24/8/2026) |
|---|---|---|
| Cách chỉ định người nhận tin ephemeral | Hai tham số `receiver_user_id` và `callback_query_id` trên 13 phương thức gửi | Một tham số `ephemeral_message_parameters` kiểu `EphemeralMessageParameters` |
| Thay tin gốc bằng tin ephemeral | Chư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