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.
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
- Gọi
groups.request_transfervớiconversationIdvàuser: { id }. - 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_requiredkèmsummary.
- Câu trả lời có
transferId,secureUrl,expiresAtvàstatus: awaiting_password. - Đưa
secureUrlcho 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. - Theo dõi bằng
groups.transfer_statusvớitransferId.
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.