Tài liệu

Sổ tay cho AI agent

Chuyển quyền chủ nhóm hoặc kênh qua trợ lý

Trợ lý gửi yêu cầu chuyển quyền chủ, người dùng xác nhận trong cuộc trò chuyện rồi tự nhập mật khẩu hai lớp trên trang bảo mật riêng.

Xem Markdown

Mục tiêu

Bạn giúp người chuyển quyền chủ một nhóm hoặc kênh cho người khác mà không bao giờ thấy mật khẩu hai lớp của tài khoản. Bạn chỉ tạo yêu cầu; người tự nhập mật khẩu trên trang bảo mật của Telegram-Auto.

Quyền cần

  • groups.admin, vai trò Chủ hoặc Quản lý.
  • Tài khoản đang là chủ nhóm phải nằm trong phạm vi kết nối.

Hỏi người trước khi

Hỏi rõ nhóm nào và người nhận là ai (Telegram user id). Chuyển quyền chủ không hoàn tác được từ phía bạn: người nhận có thể gỡ quyền của tài khoản cũ.

Kiểm trước

Gọi whoami. Đọc nhóm bằng groups.info để chắc tài khoản là chủ. Người nhận nên đã là thành viên (thường là quản trị viên) của nhóm.

Các bước

  1. Gọi groups.request_transfer với conversationId và user: { id }.
  2. Thao tác này luôn hỏi xác nhận, kể cả khi kết nối đặt "cho phép". Bạn nhận 409 confirmation_required kèm summary.
  1. Câu trả lời có transferId, secureUrl, expiresAt và status: awaiting_password.
  2. Đưa secureUrl cho người và dặn: mở liên kết, đăng nhập Telegram-Auto nếu được hỏi, kiểm tên nhóm và người nhận, đánh dấu "tôi hiểu không hoàn tác được", rồi tự nhập mật khẩu hai lớp.
  3. Theo dõi bằng groups.transfer_status với transferId.

Không bao giờ xin mật khẩu trong cuộc trò chuyện, không đọc lại, không ghi vào ghi chú hay nhật ký. Nếu người lỡ gửi mật khẩu cho bạn, nói họ đổi mật khẩu và nhập trên trang bảo mật.

Kiểm sau

status Ý nghĩa
awaiting_password Đang chờ người nhập mật khẩu (tối đa 30 phút)
queued, running Đã nhận mật khẩu, máy chạy đang chuyển
done Đã chuyển xong
failed Telegram từ chối; đọc code
expired Quá 30 phút không nhập — tạo yêu cầu mới nếu người vẫn muốn
cancelled Đã huỷ

Mật khẩu được mã hoá, chỉ giao cho việc chuyển đó rồi xoá ngay khi có kết quả.

Khi lỗi

  • transfer_pending: nhóm đã có một yêu cầu đang chờ — theo dõi hoặc huỷ yêu cầu cũ.
  • too_many_transfers: mỗi kết nối giữ tối đa 5 yêu cầu đang mở — chờ hoặc huỷ bớt.
  • Người đổi ý trước khi nhập mật khẩu: gọi groups.cancel_transfer.

Điều kiện dừng

Dừng khi trạng thái là done, failed, expired hoặc cancelled, hoặc khi người chưa xác nhận yêu cầu.