---
title: "Chuyển quyền chủ nhóm hoặc kênh qua trợ lý"
locale: vi
url: https://tlg.builera.app/docs/agent-playbooks/transfer-ownership
verified: 2026-10-25
app_version: "2.1"
---

# 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

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`.

> [!IMPORTANT]
> Điểm dừng — hỏi người
>
> Đưa nguyên `summary` (nhóm, người nhận) cho người. Chỉ khi người đồng ý đúng việc đó mới gọi lại với cùng dữ liệu và `confirm_token`.

3. Câu trả lời có `transferId`, `secureUrl`, `expiresAt` và `status: awaiting_password`.
4. Đư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.
5. 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.