Hướng dẫn July 20, 2026

Cách gửi tin nhắn tạm thời của bot Telegram trong nhóm

Bot Telegram có thể gửi một tin nhắn tạm thời trong nhóm hoặc supergroup mà chỉ người dùng được chọn và bot nhìn thấy. Với bot thông thường, phản hồi phải theo sau một callback hợp lệ hoặc một tin nhắn tạm thời trong vòng 15 giây. Bot là quản trị viên cuộc trò chuyện có thể chủ động gửi cho bất kỳ thành viên nào không phải bot vào bất cứ lúc nào. Telegram không bảo đảm tin nhắn sẽ được phân phối, đặc biệt khi người nhận đang ngoại tuyến.

Điểm chính

Bot API 10.2 bổ sung tin nhắn bot riêng tư theo từng người dùng và lệnh tạm thời vào ngày 14 tháng 7 năm 2026.
Đặt trường is_ephemeral của lệnh thành true khi lệnh của người dùng cần được ẩn với các thành viên và bot khác.
Bot không phải quản trị viên cần callback_query_id gần đây hoặc reply_parameters.ephemeral_message_id; cửa sổ phản hồi là 15 giây.
Bot quản trị viên có thể nhắm đến bất kỳ thành viên nào không phải bot mà không cần các mã trigger đó, nhưng việc phân phối vẫn theo cơ chế cố gắng tối đa.
Tin nhắn tạm thời là phản hồi giao diện, không phải nhật ký kiểm toán lâu dài hay một loại tin nhắn dùng chung giữa nhiều nền tảng.

Tin nhắn tạm thời của bot Telegram là gì?

Tin nhắn tạm thời của bot là phản hồi riêng tư xuất hiện trên dòng thời gian của nhóm hoặc supergroup cho một người dùng. Các thành viên khác trong nhóm và các bot khác không nhìn thấy tin nhắn đó. Telegram nêu các trường hợp phù hợp như lời chào, bản tóm tắt AI riêng tư, thông báo lỗi, xác nhận, gợi ý theo ngữ cảnh và menu nút bấm.

Tính năng này khác với Chế độ Khách của Telegram. Chế độ Khách quyết định cách gọi bot trong cuộc trò chuyện mà bot chưa tham gia. Tin nhắn tạm thời quyết định ai có thể nhìn thấy một lệnh hoặc phản hồi cụ thể của bot. Tính năng này cũng khác với Rich Messages của Bot API 10.1, vốn thay đổi định dạng chứ không thay đổi phạm vi hiển thị.

Theo Telegram, các tương tác này có thể tự động biến mất sau một khoảng thời gian hoặc khi ứng dụng khởi động lại. Tài liệu chính thức không công bố thời gian tồn tại cố định, vì vậy đừng dùng tin nhắn đang hiển thị làm bản ghi duy nhất cho một phê duyệt, trạng thái thanh toán, quyết định hỗ trợ hay sự kiện kinh doanh cần lưu giữ nào khác.

Bot nào có thể gửi phản hồi riêng tư trong nhóm?

Có hai cơ chế quyền. Hãy chọn cơ chế trước khi thiết kế handler vì mã định danh bắt buộc và hành vi phân phối của chúng khác nhau.

Bối cảnh của bot	Khi nào có thể gửi	Dữ liệu trigger bắt buộc	Phạm vi phân phối
Bot bất kỳ	Trong vòng 15 giây sau một hành động đến hợp lệ	`callback_query_id` hoặc `reply_parameters.ephemeral_message_id`	Ứng dụng client đã kích hoạt hành động
Bot là quản trị viên cuộc trò chuyện	Bất cứ lúc nào, cho một thành viên không phải bot	Không cần mã định danh trigger	Có thể đến nhiều client đang hoạt động nhưng không được bảo đảm

Cả hai cơ chế đều dùng receiver_user_id để chọn người xem. Tin nhắn tạm thời gửi đi chỉ dùng được trong nhóm và supergroup. Đây không phải giải pháp thay thế cho cuộc trò chuyện bằng tin nhắn trực tiếp.

Giới hạn phân phối rất quan trọng: Telegram nói rõ rằng việc nhận tin không được bảo đảm, đặc biệt nếu người dùng đang ngoại tuyến. Hãy thiết kế tin nhắn như phản hồi giao diện tiện lợi. Nếu hành động làm thay đổi trạng thái trên máy chủ, hãy lưu trạng thái đó trước và cho phép người dùng truy xuất lại về sau.

Bước 1: Khai báo một lệnh tạm thời

Dùng setMyCommands và đặt is_ephemeral thành true cho những lệnh cần giữ riêng tư khi người dùng gọi. Lệnh giả định sau giữ yêu cầu /summary của người dùng ở chế độ ẩn với mọi thành viên và bot khác trong nhóm:

curl "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/setMyCommands" \
  -H "Content-Type: application/json" \
  -d '{
    "commands": [
      {
        "command": "summary",
        "description": "Summarize this discussion for me",
        "is_ephemeral": true
      }
    ],
    "scope": {
      "type": "all_group_chats"
    }
  }'

is_ephemeral tác động đến lệnh do người dùng gửi. Chỉ riêng trường này không chọn người nhận cho mọi tin nhắn sau đó của bot. Yêu cầu gửi vẫn cần đúng cuộc trò chuyện, đúng người xem và — trừ khi bot là quản trị viên — một trigger hợp lệ.

Bước 2: Gửi phản hồi riêng tư trong nhóm

Để phản hồi một callback, hãy gọi phương thức gửi được hỗ trợ với chat_id, receiver_user_id và callback_query_id. Bot API 10.2 bổ sung hai tham số dành cho tin nhắn tạm thời vào sendMessage cũng như các phương thức được hỗ trợ để gửi nội dung đa phương tiện, tệp, liên hệ và vị trí.

Yêu cầu giả định sau gửi xác nhận cho một thành viên của supergroup:

curl "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": -1001234567890,
    "receiver_user_id": 424242424,
    "callback_query_id": "4382bfdwdsb323b2d9",
    "text": "Your report is ready. Only you can see this confirmation."
  }'

Gửi yêu cầu trong cửa sổ 15 giây. Nếu trigger là một tin nhắn tạm thời đến thay vì callback query, hãy phản hồi bằng reply_parameters.ephemeral_message_id. Không thay thế bằng message_id thông thường; Bot API 10.2 cho phép bỏ qua message_id khi có mã định danh tạm thời.

Khi bot quản trị viên chủ động gửi tin mà không có hành động gần đây, hãy bỏ callback_query_id và đích phản hồi tạm thời, nhưng vẫn phải cung cấp chat_id của nhóm và receiver_user_id của thành viên không phải bot.

Bước 3: Sửa hoặc xóa bằng mã định danh tạm thời

Lưu ephemeral_message_id được trả về trong đối tượng Message của Telegram cùng với chat_id và receiver_user_id. Các phương thức sửa và xóa thông thường không phải API vòng đời phù hợp cho loại tin nhắn này.

Hãy dùng các phương thức chuyên biệt:

editEphemeralMessageText
editEphemeralMessageMedia
editEphemeralMessageCaption
editEphemeralMessageReplyMarkup
deleteEphemeralMessage

Ví dụ, thao tác sửa văn bản cần đủ ba trường định danh:

{
  "chat_id": -1001234567890,
  "receiver_user_id": 424242424,
  "ephemeral_message_id": 781,
  "text": "The report is ready to download."
}

Telegram cũng cảnh báo rằng sự kiện sửa và xóa có thể không đến được người dùng đang ngoại tuyến. Hãy coi các lệnh vòng đời là cập nhật giao diện theo cơ chế cố gắng tối đa, không phải bằng chứng rằng một người đã nhìn thấy — hoặc không còn nhìn thấy — thông tin nhạy cảm.

Danh sách kiểm tra khi triển khai

Phân loại phản hồi. Dùng tin nhắn tạm thời cho phản hồi cá nhân cần xuất hiện trong ngữ cảnh nhóm, không dùng cho bản ghi mà đội ngũ phải lưu giữ.
Ghi nhận trigger ngay lập tức. Chỉ giữ callback_query_id hoặc ephemeral_message_id đến trong khoảng thời gian cần thiết để đáp ứng cơ chế 15 giây.
Phân quyền trên máy chủ. Việc ẩn nội dung không phải là cơ chế phân quyền. Xác minh người gọi được phép yêu cầu bản tóm tắt, menu hoặc hành động trước khi tạo kết quả.
Lưu trạng thái lâu dài riêng biệt. Lưu phê duyệt, trạng thái tác vụ và hành động hỗ trợ trong cơ sở dữ liệu của bạn trước khi xác nhận trên giao diện.
Dùng phương thức vòng đời chuyên biệt. Lưu chat_id, receiver_user_id và ephemeral_message_id thành một bộ khóa tra cứu duy nhất để sửa và xóa.
Thiết kế cho trường hợp không phân phối được. Cung cấp cuộc trò chuyện riêng thông thường, bảng điều khiển hoặc cơ chế thử lại khi người dùng bắt buộc phải truy xuất được kết quả.
Kiểm thử vai trò và client. Bao phủ bot thông thường, bot quản trị viên, nhóm và supergroup, nhiều thiết bị đang hoạt động cùng lúc và người nhận ngoại tuyến.

UnifyPort phù hợp ở đâu — và không phù hợp ở đâu

Tin nhắn tạm thời của Telegram là một tính năng của Telegram Bot API. Tài liệu tham chiếu API hiện tại của UnifyPort không mô tả receiver_user_id, callback_query_id hay các phương thức sửa và xóa tin nhắn tạm thời cho POST /v1/messages. Hãy dùng Bot API chính thức của Telegram khi sản phẩm phụ thuộc vào giao diện theo từng người dùng trong nhóm này.

UnifyPort giải quyết một tầng khác: tin nhắn đến thông thường từ các tài khoản được hỗ trợ có thể xuất hiện dưới dạng sự kiện message.received đã được chuẩn hóa, còn phản hồi tiêu chuẩn được hỗ trợ dùng một message API chung cho nhiều nhà cung cấp. Điều này hữu ích khi đội ngũ cần hàng đợi lâu dài trải rộng trên Telegram, WhatsApp, LINE, Zalo, TikTok và X. UnifyPort không biến tin nhắn của nền tảng khác thành phản hồi tạm thời của Telegram, cũng không duy trì ngữ nghĩa hiển thị chỉ có trên Telegram.

Nếu nhu cầu thực tế là hỗ trợ đa kênh thay vì một bề mặt bot chỉ dành cho Telegram, hướng dẫn tự động hóa Telegram đa kênh giải thích rõ ranh giới kiến trúc.

Giới hạn và đánh đổi

Hãy chọn tính năng Bot API chính thức khi bot cần hiển thị xác nhận, lỗi, menu hoặc bản tóm tắt riêng tư mà không đưa người dùng ra khỏi nhóm. Tính năng này cung cấp khả năng hiển thị theo từng người dùng ngay trong client Telegram và hỗ trợ văn bản cùng nhiều loại nội dung đa phương tiện và tiện ích.

Không dùng tính năng này cho cảnh báo cần bảo đảm, hồ sơ tuân thủ, lịch sử hỗ trợ lâu dài hoặc bí mật bắt buộc phải thu hồi được. Việc phân phối, sửa và xóa đều không được bảo đảm với người dùng ngoại tuyến; tin nhắn có thể biến mất; và tài liệu chính thức không cam kết thời gian tồn tại cố định. Giao diện không chính thức không thể thay đổi các bảo đảm của nền tảng hay bổ sung hành vi tạm thời cho kênh khác.

Câu hỏi thường gặp

Bot Telegram có thể gửi tin nhắn chỉ một thành viên trong nhóm nhìn thấy không?

Có. Trong nhóm hoặc supergroup, hãy cung cấp receiver_user_id và đáp ứng một trong hai cơ chế: trigger hợp lệ trong 15 giây hoặc bot là quản trị viên cuộc trò chuyện. Chỉ người dùng được chọn và bot nhìn thấy tin nhắn tạm thời.

Bot có cần là quản trị viên nhóm không?

Không phải lúc nào cũng cần. Bot bất kỳ có thể phản hồi trong vòng 15 giây nếu có callback_query_id liên quan hoặc mã định danh phản hồi tạm thời đến. Bot quản trị viên có thể chủ động gửi tin nhắn tạm thời cho bất kỳ thành viên nào không phải bot mà không cần các mã trigger đó.

Tin nhắn tạm thời của bot Telegram tồn tại bao lâu?

Telegram không công bố thời gian tồn tại cố định. Tài liệu cho biết tương tác có thể tự động biến mất sau một khoảng thời gian hoặc khi ứng dụng khởi động lại, vì vậy ứng dụng không nên coi đây là nơi lưu trữ lâu dài.

Người dùng ngoại tuyến có nhận được tin nhắn tạm thời không?

Việc phân phối không được bảo đảm, đặc biệt khi người dùng ngoại tuyến. Sự kiện sửa và xóa cũng có giới hạn tương tự. Hãy cung cấp một cách truy xuất lại cho những kết quả quan trọng.

Tin nhắn tạm thời có giống Chế độ Khách của Telegram không?

Không. Chế độ Khách kiểm soát cách bot tham gia mà không cần gia nhập cuộc trò chuyện. Tin nhắn tạm thời kiểm soát phạm vi hiển thị của một lệnh hoặc phản hồi trong nhóm. Hai tính năng có thể bổ trợ nhau nhưng giải quyết các vấn đề khác nhau.

Bước tiếp theo

Triển khai luồng dành riêng cho Telegram theo tài liệu Bot API chính thức về tin nhắn tạm thời. Nếu phần còn lại của quy trình cần tin nhắn lâu dài trên nhiều nhà cung cấp, hãy kiểm tra ma trận hỗ trợ tin nhắn theo nhà cung cấp của UnifyPort trước khi thiết kế handler dùng chung.

Nguồn

Các nguồn chính thức được kiểm tra ngày 20 tháng 7 năm 2026: