Tin tức

Bot API 10.3 của Telegram đổi tham số gửi tin nhắn tạm thời

Bot API 10.2 (14/7/2026) thêm tin nhắn chỉ một người thấy; bản 10.3 (24/8/2026) thay hai tham số cũ. Mini App bị siết nguồn gọi hàm từ 20/7/2026.

Đỗ Phạm Nguyên

Bot API 10.3 của Telegram đổi tham số gửi tin nhắn tạm thời

Telegram phát hành Bot API 10.2 ngày 14/7/2026 và 10.3 ngày 24/8/2026. Hai bản này thêm "tin nhắn tạm thời" (ephemeral message) chỉ một người dùng và bot nhìn thấy, rồi đổi cách khai báo người nhận ở bản sau. Bản 10.2 còn siết bảo mật Mini App từ 20/7/2026. Ai đang chạy bot chăm sóc khách hàng trên Telegram nên đối chiếu mã của mình với ba thay đổi này (Bot API changelog).

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.

Hai bàn tay gõ phím laptop, màn hình hiển thị mã nguồn
Ảnh: Rahul Mishra / Unsplash (Unsplash License)

Điểm mới trong Bot API 10.2 và 10.3

  • 10.2 (14/7/2026): bot gửi được tin trong nhóm và nhận lệnh "visible only to a specific user and the bot". Trường `is_ephemeral` được thêm vào `BotCommand`, kèm bốn phương thức sửa tin tạm thời và `deleteEphemeralMessage` (Bot API changelog).
  • 10.2: các phương thức gửi như `sendMessage`, `sendPhoto`, `sendDocument` nhận thêm tham số `receiver_user_id` và `callback_query_id` (Bot API changelog).
  • 10.3 (24/8/2026): hai tham số trên được thay bằng `ephemeral_message_parameters` (lớp `EphemeralMessageParameters`) ở cùng nhóm phương thức, và `sendRichMessage` cũng nhận tham số này (Bot API changelog).
  • 10.3: `EphemeralMessageParameters` có thêm trường `replace_callback_query_message`, cho phép hiện tin tạm thời thay cho tin gốc có nút bấm (Bot API changelog).
  • 10.3: nút bấm có thể ở trạng thái vô hiệu (`DisabledButton`, trường `disabled` trên `InlineKeyboardButton`) và quản trị viên có quyền mới `can_send_welcome_messages` (Bot API changelog).

Mini App: hạn chế gọi hàm từ nguồn khác

Từ 14/7/2026, changelog quy định Mini App không được gọi phương thức của Mini App từ nguồn (origin) khác với tên miền gốc. Cơ chế này tự bật cho mọi Mini App ngày 20/7/2026 (Bot API changelog). Có thể tắt qua Mini App của @BotFather, nhưng khi đó bot tự chịu trách nhiệm để Mini App "no links to untrusted sites" (Bot API changelog).

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

Phần này là nhận định của tôi dựa trên changelog, không phải khuyến nghị của Telegram. Tin chỉ một người thấy hợp với tình huống khách hỏi trong nhóm cộng đồng mà câu trả lời có thông tin riêng, như trạng thái đơn hoặc mã giảm giá. Bot không phải nhắn riêng và không để câu trả lời nằm lại cho cả nhóm đọc. Cần thử kỹ trước khi dùng, vì changelog không nêu giới hạn về thời gian tin tồn tại hay cách lưu trữ.

Rủi ro thực tế nằm ở thay đổi giữa 10.2 và 10.3. Nếu bạn đã viết mã dùng `receiver_user_id` hoặc `callback_query_id` theo bản 10.2, changelog 10.3 ghi rằng hai tham số này được thay bằng `ephemeral_message_parameters`. Tôi chưa kiểm chứng hành vi của máy chủ với tham số cũ, nên hãy tự thử trên bot kiểm thử trước khi nâng cấp thư viện.

Việc cần ràCăn cứ trong changelogHành động gợi ý
Mã gửi tin tạm thời dùng tham số cũ10.3 thay `receiver_user_id`, `callback_query_id` bằng `ephemeral_message_parameters`Đổi sang tham số mới và chạy thử trên bot kiểm thử
Mini App gọi hàm từ tên miền khácChặn tự động từ 20/7/2026Gom mã gọi hàm về đúng tên miền gốc của Mini App
Mini App tắt bảo vệ qua @BotFatherBot tự chịu trách nhiệm về liên kết không tin cậyRà liên kết ngoài, cân nhắc bật lại
Nút bấm cần khóa tạm10.3 thêm `disabled` trên `InlineKeyboardButton`Dùng thay cho việc xóa rồi gửi lại tin

Nên làm tiếp: đọc mục 10.2 và 10.3 trong changelog, kiểm tra phiên bản thư viện bot đang dùng đã hỗ trợ `ephemeral_message_parameters` chưa, và theo dõi các bản Bot API sau 10.3.

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

  • Bot API changelog: https://core.telegram.org/bots/api-changelog