Telegram Bot API 10.4: những thay đổi đáng chú ý cho bot CSKH
Bản phát hành ngày 9/11/2026 cho bot trả lời riêng khi khách bấm nút ở gần như mọi loại chat, thêm link mở thẳng chủ đề và nhận diện số thẻ ngân hàng.
Đỗ Phạm Nguyên
Ngày 9/11/2026, Telegram phát hành Bot API 10.4 Telegram Bot API changelog. Với người làm bot chăm sóc khách hàng, bản này đáng chú ý ở ba điểm: bot trả lời riêng được khi khách bấm nút ở gần như mọi loại chat, có liên kết mở thẳng một chủ đề trong chat riêng với bot, và Telegram bắt đầu đánh dấu số thẻ ngân hàng trong tin nhắn.
**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 Bot API 10.4 liên quan đến bot hỗ trợ khách
- **Trả lời riêng qua nút bấm:** bot được gửi phản hồi tạm thời (ephemeral) cho callback query "in any chat except channel direct messages chats" Telegram Bot API changelog. Tham số `receiver_user_id` và `chat_id` trong các hàm gửi tin nay là tùy chọn.
- **Liên kết tới chủ đề trong chat riêng:** dạng `https://t.me/<bot_username>/<message_thread_id>`. Liên kết chỉ mở chủ đề cho đúng người dùng có chủ đề đó trong chat riêng với bot Telegram Bot API changelog.
- **Kiểu thực thể `bank_card_number`:** lớp `MessageEntity` có thêm kiểu dành cho số thẻ ngân hàng Telegram Bot API changelog.
- **Tin hệ thống `PaidMessagesWaived`:** báo khi người gửi dùng một liên kết cho phép nhắn tin mà không phải trả Telegram Stars Telegram Bot API changelog.
- **Widget:** ở môi trường production, widget chỉ gửi được vào chat riêng và tự bật bảo vệ nội dung nên không chuyển tiếp được Telegram Bot API changelog.
Tin nhắn tạm thời hoạt động thế nào
Tin nhắn tạm thời có từ Bot API 10.2 ngày 14/7/2026: bot gửi tin trong nhóm mà chỉ một người dùng và bot nhìn thấy Telegram Bot API changelog. Khi khách bấm nút, bot có thể thay tin chứa nút bằng một lớp hiển thị riêng cho người đó, những người khác trong nhóm vẫn thấy như cũ Telegram Bot Features. Bot cũng có thể xóa tin tạm thời trước khi nó hết hạn Telegram Bot Features.
Về mặt dữ liệu, tin tạm thời có `message_id` bằng 0 và được nhận diện bằng `ephemeral_message_id`. Mã này có thể được dùng lại cho tin khác sau khi tin cũ bị xóa hoặc hết hạn Telegram Bot API. Tài liệu chúng tôi đọc không nêu thời gian hết hạn cụ thể.
Tác động với nhóm hỗ trợ khách trên Telegram (nhận định)
Nhiều cửa hàng dùng nhóm Telegram làm kênh hỗ trợ chung. Khi bot trả lời công khai, cả nhóm có thể thấy mã đơn hay địa chỉ giao hàng của một khách. Theo nhận định của chúng tôi, việc mở rộng trả lời tạm thời qua nút bấm giúp bot đưa thông tin riêng cho đúng người hỏi mà không cần kéo khách sang chat riêng.
| Thay đổi | Cách dùng gợi ý | Điểm cần lưu ý |
|---|---|---|
| Trả lời tạm thời qua nút bấm | Khách bấm "Kiểm tra đơn" trong nhóm, bot hiện trạng thái đơn chỉ cho khách đó | Tin có thể hết hạn; thông tin khách cần giữ lại nên gửi bằng tin thường trong chat riêng |
| Liên kết chủ đề trong chat riêng | Gửi khách link mở đúng chủ đề của một yêu cầu hỗ trợ | Link chỉ mở cho đúng người có chủ đề, không dùng làm link chia sẻ chung |
| Kiểu `bank_card_number` | Bot phát hiện khách lỡ gửi số thẻ để nhắc khách và tránh lưu nội dung đó | Nhận diện tự động có thể sót; không thay cho quy trình bảo vệ dữ liệu |
| `message_id` bằng 0 ở tin tạm thời | Hệ thống ghi log hoặc CRM cần trường riêng cho tin tạm thời | Không dùng `message_id` hay `ephemeral_message_id` làm khóa duy nhất lâu dài |
Việc nên làm
- Đọc mục 10.4 trong Telegram Bot API changelog và kiểm tra thư viện bot bạn dùng đã hỗ trợ các trường mới chưa.
- Rà lại đoạn code gửi tin tạm thời, vì `receiver_user_id` và `chat_id` giờ là tùy chọn và cách gọi có thể khác.
- Nếu lưu hội thoại vào CRM, tách riêng cách lưu tin tạm thời thay vì dựa vào `message_id`.
- Cân nhắc dùng kiểu `bank_card_number` để nhắc khách không gửi số thẻ qua chat.
Bước tiếp theo: theo dõi trang changelog của Telegram và tài liệu thư viện bot bạn đang dùng để biết khi nào các tính năng 10.4 dùng được trong code của mình.
Nguồn tham khảo
- Telegram Bot API changelog (Bot API 10.4): https://core.telegram.org/bots/api-changelog#november-9-2026
- Telegram Bot Features, mục Ephemeral Messages: https://core.telegram.org/bots/features#ephemeral-messages
- Telegram Bot API (tài liệu đối tượng Message): https://core.telegram.org/bots/api
Cách bài này được tạo: bài được AI hỗ trợ tìm nguồn và soạn thảo dựa trên các tài liệu chính thức của Telegram nêu ở mục Nguồn tham khảo, và do Đỗ Phạm Nguyên biên tập.