Tin tức

Bot API 10.3 của Telegram gom tham số tin nhắn ẩn vào một đối tượng

Từ 24/8/2026, các lệnh gửi tin của bot Telegram nhận ephemeral_message_parameters thay cho hai tham số rời. Tin ẩn chỉ trả lời được trong 15 giây.

Đỗ Phạm Nguyên

Bot API 10.3 của Telegram gom tham số tin nhắn ẩn vào một đối tượng

Telegram phát hành Bot API 10.3 ngày 24/8/2026. Bản này đổi cách bot gửi "tin nhắn tạm" (ephemeral message), loại tin trong nhóm chỉ một người nhận và bot nhìn thấy. Ai đã viết code theo bản 10.2 cần cập nhật cách truyền tham số. Changelog Bot API

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.

Cận cảnh màn hình máy tính hiển thị chữ "chat"
Ảnh: Emiliano Vittoriosi / Unsplash (Unsplash License)

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

Tin nhắn tạm xuất hiện từ Bot API 10.2 (14/7/2026): bot gửi tin trong nhóm mà chỉ một người dùng cụ thể và bot thấy được. Changelog Bot API

Bản 10.3 thêm lớp `EphemeralMessageParameters`. Lớp này thay hai tham số `receiver_user_id` và `callback_query_id` ở các phương thức gửi như `sendMessage`, `sendPhoto`, `sendDocument`, `sendVoice`, `sendLocation`. Các phương thức đó giờ nhận một tham số `ephemeral_message_parameters`. `sendRichMessage` cũng được thêm tham số này. Changelog Bot API

Trường trong EphemeralMessageParametersBắt buộcÝ nghĩa theo tài liệu
receiver_user_idCóNgười nhận tin. Telegram nói không đảm bảo người đó nhận được, nhất là khi đang offline
callback_query_idKhôngCallback query đã kích hoạt tin này, nếu có
replace_callback_query_messageKhôngĐặt True để hiển thị tin tạm thay cho tin gốc

Các thay đổi nhỏ khác cùng mục: `editEphemeralMessageMedia` nhận tệp tải lên mới, `editEphemeralMessageCaption` có thêm `show_caption_above_media`, và `editEphemeralMessageText` có thêm `rich_message`. Changelog Bot API

Ràng buộc cần biết khi trả lời tin tạm

Tài liệu ghi rằng một tin tạm chỉ được trả lời (reply) trong 15 giây sau khi gửi, và tin trả lời cũng phải là tin tạm. `allow_sending_without_reply` luôn là False với tin tạm. Tin tạm có `message_id` bằng 0, nên cần dùng `ephemeral_message_id` để định danh. Tài liệu Bot API

Tài liệu cũng cho biết `ephemeral_message_id` có thể được dùng lại sau khi tin bị xoá hoặc hết hạn. Trang tôi đã đọc không nêu thời gian hết hạn cụ thể. Tài liệu Bot API

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

Đây là nhận định của chúng tôi, không phải tuyên bố của Telegram. Với bot trong nhóm cộng đồng hoặc nhóm khách hàng, tin tạm cho phép trả lời một người mà không để thông tin hiện ra cho cả nhóm, ví dụ trạng thái đơn hàng hay hướng dẫn riêng. Vì Telegram không đảm bảo người nhận thấy tin khi offline, không nên dùng tin tạm cho thông báo bắt buộc phải đến tay khách.

Phần mô tả đầy đủ về tin tạm và lệnh tạm nằm ở trang tính năng bot của Telegram. Bài này chưa đọc trang đó, nên các quy tắc xoá và sửa chi tiết chưa được xác minh.

Kiểm tra lại mã gửi tin của bot theo bảng trên, và đọc mục tin nhắn tạm trong tài liệu Bot API trước khi dùng cho dữ liệu khách hàng. Với vấn đề pháp lý hoặc bảo mật dữ liệu khách hàng cụ thể, hãy hỏi chuyên gia phù hợp.

Cách bài này được tạo

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ừ các nguồn nêu bên dưới, và do Đỗ Phạm Nguyên biên tập.

Nguồn tham khảo

  • Telegram Bot API Changelog: https://core.telegram.org/bots/api-changelog
  • Telegram Bot API (tài liệu): https://core.telegram.org/bots/api