Tài liệu

An toàn

Thao tác nguy hiểm và xác nhận

Nhận biết thao tác có thể làm mất dữ liệu, đổi quyền hoặc tạo lại tác động trên Telegram trước khi xác nhận.

Xem Markdown

Một thao tác được phép chạy chưa chắc là thao tác nên chạy. Trước khi xoá, chuyển quyền hoặc chạy lại việc cũ, bạn cần kiểm tra đúng đối tượng, phạm vi ảnh hưởng và khả năng hoàn tác.

Những thao tác cần đặc biệt cẩn thận

Thao tác Điều cần biết trước khi làm
Xoá workspace Cần nhập tên xác nhận. Đây là thao tác chỉ dành cho người trong app; không mở cho kết nối AI. Có luồng khôi phục riêng, nên không đồng nghĩa với xoá vĩnh viễn mọi dữ liệu ngay lập tức.
Gỡ tài khoản Gỡ tài khoản khỏi workspace, không phải xoá tài khoản Telegram. App có thể phải xếp việc đăng xuất trước khi hoàn tất.
Xoá nhóm hoặc kênh Xoá cho mọi người, không chỉ ẩn khỏi hộp thư của bạn.
Chuyển chủ nhóm hoặc kênh Chỉ người thao tác trong app được làm. Mật khẩu 2 lớp được nhập cho lần thực hiện đó.
Xoá máy Máy Hetzner có thể bị huỷ thực sự; không phải chỉ xoá một dòng trong danh sách.
Thu hồi phiên, đăng xuất Có thể làm tài khoản mất kết nối và cần đăng nhập lại.
Đổi quyền, xoá thành viên hoặc kết nối AI Có thể cắt quyền truy cập và làm các tác vụ liên quan dừng.
Chạy lại việc cũ Tạo việc mới; tác động trên Telegram có thể xảy ra thêm lần nữa.

Danh sách rủi ro còn gồm xoá chủ đề và tin nhắn, thu hồi link mời, nâng nhóm thành siêu nhóm, cấm thành viên, xoá webhook và một số thay đổi quyền quản trị.

Có thao tác chỉ nhạy cảm với một đầu vào cụ thể, chẳng hạn chuyển sang Tự do, đặt link nhóm công khai hoặc mở rộng phạm vi webhook. Vì vậy, hãy đọc nội dung xác nhận của chính lần thao tác đó.

Xác nhận của người dùng

Quyền trong workspace và quyền trên Telegram là hai lớp khác nhau. Bạn có quyền quản lý trong app vẫn có thể bị Telegram từ chối nếu tài khoản không có quyền tương ứng.

  1. Mở đúng đối tượng trong app.
  2. Đọc phạm vi tác động trong hộp xác nhận.
  3. Nhập tên hoặc thông tin xác nhận nếu app yêu cầu.
  4. Chỉ xác nhận khi bạn chấp nhận hậu quả được mô tả.
  5. Kiểm tra kết quả việc thay vì bấm lại khi chưa thấy thay đổi.

Xác nhận qua REST và MCP

REST và MCP dùng chung sổ thao tác và kiểm tra quyền. Kết nối AI có chính sách rủi ro riêng: cho phép, hỏi lại hoặc từ chối.

Khi cần hỏi lại, lời gọi trả confirmation_required, bản tóm tắt, confirm_token và thời điểm hết hạn. Siêu dữ liệu v2 công bố thời hạn 600 giây.

Agent phải trình bày đúng hành động cho bạn. Sau khi bạn đồng ý, agent gọi lại cùng thao tác, cùng đầu vào, kèm token. Token gắn với kết nối, thao tác và dữ liệu đã yêu cầu; không dùng cho hành động khác và chỉ dùng được một lần. Agent không được tự đồng ý thay bạn. App cũng có đường để người dùng duyệt hoặc từ chối yêu cầu.

Các thao tác chỉ dành cho người không có trang thao tác công khai để agent gọi. Chuyển chủ nhóm và xoá workspace thuộc nhóm này.

Chạy lại không phải tiếp tục việc cũ

Redrive chỉ áp dụng cho việc đủ điều kiện đã thất bại hoặc hết hạn. App tạo việc mới, liên kết về việc cũ và kiểm tra lại quyền, hạn mức, hàng đợi cùng danh sách không liên hệ. Gọi lặp lại redrive của cùng việc trả về cùng việc mới, không tạo thêm bản tuỳ ý. Việc chưa rõ không phải đối tượng để gửi lại mù.

Liên quan