Tin tức

Telegram Bot API 10.3: bot nhắn riêng một người ngay trong nhóm

Tin nhắn ephemeral cho bot trả lời công khai trong nhóm nhưng chỉ một khách thấy; 10.3 gộp tham số vào ephemeral_message_parameters.

Đỗ Phạm Nguyên

Từ Bot API 10.2 (14/7/2026), bot Telegram có thể gửi trong nhóm một tin nhắn mà chỉ một người dùng chỉ định và bot nhìn thấy, gọi là tin nhắn ephemeral (Bot API changelog). Bản 10.3 ngày 24/8/2026 đổi cách truyền tham số cho tính năng này, nên bot đã viết theo 10.2 cần rà lại (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.

Điểm mới

  • Bot gửi và nhận lệnh trong nhóm mà chỉ một người dùng cùng bot thấy; bot cũng sửa hoặc xoá được các tin này (Bot API changelog).
  • Phương thức gửi như `sendMessage`, `sendPhoto`, `sendDocument` và `sendRichMessage` hỗ trợ chế độ này; có thêm `editEphemeralMessageText`, `editEphemeralMessageMedia`, `editEphemeralMessageCaption`, `editEphemeralMessageReplyMarkup` và `deleteEphemeralMessage` (Bot API).
  • Ở 10.3, các tham số riêng của 10.2 (`receiver_user_id`, `callback_query_id`) được thay bằng `ephemeral_message_parameters` (Bot API).
  • Tin ephemeral có `message_id` bằng 0, nên bot dùng `ephemeral_message_id` để định danh; mã này có thể được dùng lại sau khi tin bị xoá hoặc hết hạn (Bot API).
  • `BotCommand.is_ephemeral` đánh dấu lệnh hoạt động theo chế độ này (Bot API).

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

Nhận định của tôi: với nhóm cộng đồng khách hàng, đây là cách hợp lý để trả lời thông tin liên quan riêng một người, ví dụ trạng thái đơn hàng, mà không phải chuyển khách sang chat riêng hay để lộ thông tin trước cả nhóm. Tài liệu không nói rõ chế độ này có dùng được ở chat riêng hay không, và cũng không nêu thời gian hết hạn, nên đừng giả định hai điều đó khi thiết kế luồng.

Việc nên làm

  1. Nếu bot đã dùng thử ephemeral theo 10.2, đổi các lệnh gọi sang `ephemeral_message_parameters` theo tài liệu 10.3.
  2. Đánh dấu những lệnh trả thông tin cá nhân bằng `is_ephemeral`.
  3. Với 10.3, thử tuỳ chọn `replace_callback_query_message` để thay tin gốc bằng tin ephemeral khi khách bấm nút (Bot API).

Hãy đọc tài liệu Bot API bản mới nhất và theo dõi changelog trước khi nâng cấp bot đang chạy thật. Nội dung này chỉ là thông tin kỹ thuật chung, không phải tư vấn pháp lý về dữ liệu khách hàng.

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

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